Overview
This page describes how to create Identities by integrating Okta as an external data source, along with other details.
Reference: Creating Identities by Integrating with External Systems (External Data Sources)
Integrated Fields
The following 6 fields are imported into Josys by integrating with Okta.
Other fields will not be imported into Josys, so please register them using methods such as CSV bulk registration.
| Okta Field Name | Josys Field Name |
|---|---|
| Last Name | Last Name |
| First Name | First Name |
| Employee Number | User ID |
| Primary Email | Email Address |
| Secondary Email | Personal Email Address |
| Title | Job Title |
| Department | Departments |
| Division | Departments |
| Created Date | Start Date |
Integration Steps
1. Integrating the App
- Please refer to Okta to integrate the app with Josys.
- Once the app integration is complete, if you have not yet set up the external data source integration, a pop-up saying "Integrate External Data Source" will appear. Click "Integrate." If you have completed this step, proceed to "3. Verifying the Integration Status."
- If you have already integrated the app in the past or if the pop-up does not appear, proceed to "2. Setting up External Data Sources Integration."
2. Setting up External Data Sources Integration
To use the user information registered in each SaaS tool as your master data, set up the integration with Josys using the following method.
- Click "Integrations > External Data Sources" from the left sidebar.
- If the app is integrated, "Integrated" will be displayed in green text under the "User" category.
Click "Integrate" on the right side of it. - If you have integrated Okta with multiple accounts, select the workspace you want to integrate from the drop-down menu. *If you did not name it during the app integration, it will be created with the name "-" (Reference: Integration Name).
- Click "Run" in the bottom right corner.
- Confirm that the message "External data source integration completed" is displayed.
3. Verifying the Integration Status
- Click "Users" from the left sidebar to open All Identities.
- The integration is successful if users with the icon of the integrated SaaS tool are registered in All Identities.
Syncing and Updating User Information
After setting up the integration, Josys and Okta will sync every morning. The sync behavior is as follows:
- The
Employee Numberregistered in Okta's user information is compared with theUser IDin All Identities in Josys.
If a match is found, only the "Department" and "Status" information will be overwritten.
Additionally, if there are other blank fields on the Josys side, the latest data will be registered. - If no matching
Employee Numberis found, Okta'sPrimary Emailis compared with theEmail Addressin All Identities in Josys.
If a match is found, only the "Department" and "Status" information will be overwritten.
Additionally, if there are other blank fields on the Josys side, the latest data will be registered. - If no matching
Email Addressis found, the user will be added as a new user.