This article provides instructions on how to map the "Manager" field from Okta to Salesforce. The "Manager" field in Salesforce represents the user's manager, and mapping it correctly can help ensure a smooth user provisioning process. It is worth mentioning that, the manager needs to have an active Okta account for this process to work.
-
Create a Custom Attribute in Okta:
Before creating the custom attribute, make sure that Provisioning with Update user attributes is enabled in Okta. To create a custom attribute, follow these steps:
-
Log in to the Okta Admin dashboard.
-
Navigate to Directory > Profile Editor.
-
Locate the User (default) profile and click on it.
-
Click on the Add Attribute button.
-
Enter the required information in the form (Display name, Variable name, and Description are mandatory fields). For this exercise, enter "Manager" for the value.
-
Click Save, refresh the page, and search for the newly created attribute in the list. Copy the Variable name.
-
Map the Custom Attribute to the Salesforce Manager Field:
To map the custom attribute to the Manager field in Salesforce, follow these steps:
-
Log in to the Okta Admin dashboard.
-
Navigate to the Applications tab and select the requested Salesforce app.
-
Click on the Provisioning tab and then click on Show Unmapped Attributes.
-
Find the Manager mapping we made and click on the pencil icon.
-
Under the Attribute value dropdown menu, select "Map from Okta Profile".
-
In the Value dropdown menu, select the "Manager | string" attribute and click Save.
-
Now, the Salesforce ID of the manager needs to be entered in that user's profile.
To obtain the Salesforce ID of a user, follow these steps:
-
Login to the Salesforce admin page. Navigate to the user's detail page.
-
In the address bar in the browser, locate the URL that contains the user's Salesforce ID, which is a 15-digit code starting with "005".
-
In Salesforce Classic:
https://<YourInstanceOrMyDomainHere>.salesforce.com/00530000003xqAb?noredirect=1&isUserEntityOverride=1. -
In Lightning Experience:
https://<YourInstanceOrMyDomainHere>.lightning.force.com/lightning/setup/ManageUsers/page?address=%2F00530000003xqAb%3Fnoredirect%3D1%26isUserEntityOverride%3D1.
-
-
Finally, log in to the Okta Admin Dashboard again, go to the user's Okta profile, and paste the Salesforce ID value in the Manager attribute.
