Providing documentation to your users on how to set up SCIM with Okta is important for a smooth integration process. Below is an example guide of what this documentation could look like.

1. Begin by logging into your Okta admin console and navigating to the “Applications” section.

2. Click Create App integration.

   

3. Select SWA - Secure Web Authentication as the app type and click Next.

4. On the next page create a name for your app and enter {your app's login page url} in the App’s login page URL field. Then, click Save.

5. Navigate to the General tab of your newly created app, click on Edit in the App Settings section, and select SCIM. Then, click Save.

   

6. Switch to the Provisioning tab and click on Edit. Make the following changes:

   • SCIM connector base URL: Copy/paste the SCIM URL from {your application}.
   • Unique identifier field for users: Enter userName.
   • Supported provisioning actions: Select the first four options, leaving Import Groups unchecked.
   • Authentication Mode: Select HTTP Header.
   • Authorization: Copy/paste the SCIM API Key from {your application}.

   

7. Click Test Connector Configuration to ensure that everything is working properly. If successful, click Save.

8. While still in the Provisioning tab, navigate to the To App section and set Create Users, Update User Attributes, and Deactivate Users to On. Then, click Save.

   

9. Finally, assign users or groups to your app by navigating to the Assignments tab and clicking on Assign.