Use Expressions with Identity Management

When provisioning user accounts from JumpCloud to your SaaS applications or to JumpCloud from an external directory integration, like an HR integration, use expressions to transform user data into your preferred format or to ensure you are getting the needed information.

What are Expressions?

Expressions are rules or formulas used to manipulate and transform user data during the provisioning process. They allow you to dynamically create or modify user attributes, such as usernames, email addresses, etc., based on specific conditions or logic.

Why use Expressions?

Expressions allow you to build in logic for a particular attribute set, like setting a preferred name instead of a legal first name as the first name attribute for specific users.

Benefits

• Improved efficiency - automates data manipulation and formatting tasks, streamlining user provisioning and management
• Flexibility and customization - allows tailoring of data, so the right information is being sent.

Configuring Expressions

To add an Expression

1. Log in to the JumpCloud Admin Portal.
2. Go to USER AUTHENTICATION > SSO Applications
3. Select your application from the Configured Applications list and select the Identity Management tab.
4. Go to the User Schema Attribute Mapping section.
5. Add or select the user attribute to which you would like to create an expression.
6. Click the attribute's ellipsis and then click Add Expression.
7. In the Add Expression window, enter your desired expression in the Enter Expression field.
8. Click Save.

9. If you would like to preview the new mappings, select Preview Mappings.
10. After receiving the desired results, click update and then click Save at the bottom of the page.

To edit an Expression

1. Click the ellipsis next to the user attribute to which you would like to edit the expression.
2. Click Edit Expression and enter the updated expression for the user attribute.

3. Click Save in the Edit Expression window.
4. If you you like to preview the new mappings, select Preview Mappings.
5. If you are receiving the desired results, click update and then click Save at the bottom of the page.

Using the User Schema Preview

1. At the bottom of the attribute mappings, select the Preview Mappings link.
2. The User Schema Preview window will show the translation for the first user.
3. If you would like to see a preview of a different user, add a filter that will result in that user.

4. Click Update Preview.
5. If the preview is returning the desired result, click Close.
6. Click update and then click Save at the bottom of the page.

Examples of Expressions

Expression: {{.preferred_name}}

Result: xyz

Expression: {{or .preferred_name .username}}

Result: hello.world

Expression: {{.first_name}} {{.last_name}}

Result: Hello World

Expression: {{if .is_manager}}Engineering Manager{{else}}Engineer{{end}}

Result: Engineering Manager

Expression: {{(index .eligible_paid_time_off 1).policy_name}}

Result: Paid Time Off Policy

Expression: {{(index .eligible_paid_time_off 0).policy_name}}

Result: Sick Policy

Expression: {{(index (index .jobs 0).compensations 1).rate}}

Result: 85000.00

Expression: {{eq .phone .mobile}}

Result: false

Expression: {{range .customFieldGroup.codeFields}}{{if (eq .itemID "1500091404_30")}}{{ .nameCode.codeValue }}{{end}}{{end}}

Result: Uniform Size