Okta User Provisioning integration with Drupal streamlines user management and ensures up-to-date user information within the system. This step-by-step guide will assist you in configuring user provisioning/sync from the Drupal site to the Okta application. This will allow administrators to easily provision users and manage user data with manual, automatic, or scheduler-based provisioning using the Drupal Okta User Sync module. This module is compatible with Drupal 9, and Drupal 10.

The module also supports a two-way sync between Drupal and Okta. You can reach out to us at drupalsupport@xecurify.com for one-on-one assistance from a Drupal developer.

Installation Steps:

Module Configuration:

• After installing the module on the Drupal site, in the Administration menu, navigate to Configuration → People → miniOrange Okta User Sync. (/admin/config/people/okta_user_sync/overview)
• Have a glance at what the module does and click on the Let’s Configure the module button.

Integarting Drupal with Okta:

• Configure the values mentioned in the below screenshot from Okta in Drupal.

1. Okta Portal URL: The Okta Portal URL is nothing but the Okta Domain or you can say it is the base URL for the Org Authorization Server of Okta. For example, https://{yourOktaDomain}.okta.com Copy this URL and paste it into Drupal's Okta Portal URL text field.
2. Okta Bearer Token:
• The Okta Bearer Token is a key used to authenticate requests to Okta APIs When calling an Okta API endpoint, you need to supply a valid API token for the authentication.
• To generate this API token login to your Okta organization with the admin credentials.
• In the Admin Console, navigate to the Security → API from the menu.

• On the API page, navigate to the Tokens tab and then click the Create token button.

• Enter the name of your token and click Create Token.

• Copy the generated Token Value and keep a note of it as you won't have another chance to view and record it.

• Navigate back to the Drupal site and paste the copied Bearer Token in Drupal’s Okta Bearer Token text field.

3. Test Your Configuration: In the Test Your Configuration ( Enter user email ) field, enter a user’s email ID. (Please ensure that a user with the same email is present in your Okta portal).

Test the Configurations:

• Once done with all the configurations, click on the Save and Test Configuration button.

• If the Test Configuration is successful, you will receive a success message like this:

• Alternatively, if there is an error in the integration of Okta with Drupal, then you can check the cause of the error by following the link in the error message or scrolling down to the Test Configuration Result section.

• Once the test is successful, click on the Next button.

Provisioning / Synchronization

• The module supports bi-directional sync. To sync the users from Drupal to Okta, select Drupal to Okta Synchronization.

• In Step 3, there are three ways to perform the user provisioning (manual, automatic, or schedule-based). To configure the desired method, click the "configure" button within the corresponding method and select the operations that you want to perform(create, delete, deactivate, and update).

• After configurations, click on the All Done button.

That’s it!! you have successfully provisioned the users with Okta.

If the Provision was not successful, please contact us at drupalsupport@xecurify.com. Please send the screenshot of the error window, and we will assist you in resolving the issue and guiding you through the setup.