Skip to main content

SCIM Setup with Okta

This guide explains how to set up SCIM-based user provisioning between Okta and Fairjungle.

Fairjungle supports SCIM 2.0 and integrates with Okta’s provisioning features to automate user creation, updates, and deactivation.

✅ This setup requires admin access to both Okta and Fairjungle.

Prerequisites​

Before you start, make sure you have:

  • An Okta admin account
  • A Fairjungle Bearer Token (obtained via the developer admin as described in Fairjungle API Quickstart)

Step 1: Add Fairjungle as an Application in Okta​

  1. Log in to your Okta admin dashboard.
  2. Navigate to Applications > Applications.
  3. Click Create App Integration.
  4. Choose:
    • Sign-in method: SAML (if you're also using SSO)
    • Provisioning type: SCIM
  5. Click Next and name the app “Fairjungle”.
  6. Save the integration.

Step 2: Enable SCIM Provisioning in Okta​

  1. Go to your newly created Fairjungle app in Okta.

  2. Navigate to the Provisioning tab.

  3. Click Configure API Integration.

  4. Enable the checkbox “Enable API integration”.

  5. Fill in the SCIM details provided by Fairjungle:

    • SCIM connector base URL:
      Paste the SCIM API Base URL provided by Fairjungle
      (e.g. https://api.fairjungle.com/scim/v2)

    • Authorization: _ Use HTTP Header authentication
      Type: Bearer <your-token>

  6. Click Test API Credentials to verify the connection.

  7. If successful, click Save.

Step 3: Configure Provisioning Actions​

In the Provisioning > To App section, enable the following:

  • ✅ Create Users
  • ✅ Update User Attributes
  • ✅ Deactivate Users

Click Save after each change.

Step 4: Define Attribute Mappings​

  1. Go to the Provisioning > To App > Attribute Mappings section.
  2. Click Go to Profile Editor.
  3. In the Fairjungle User Profile, verify or add mappings for:
Okta AttributeFairjungle SCIM Attribute
user.emailString.toLowerCase(user.email)
(Custom attributes)Map to Fairjungle custom schema fields

💡 You can map any custom Okta attributes to Fairjungle's custom SCIM schema if needed. Contact Fairjungle Support to enable or configure these fields.

Step 5: Assign Users​

  1. In Okta, go to Assignments in the Fairjungle app.
  2. Click Assign > Assign to People or Assign to Groups.
  3. Add users or groups you want to provision to Fairjungle.

Once assigned, users will automatically be created in Fairjungle with the attributes you mapped.

Step 6: Monitor Provisioning​

  • Use Okta’s System Log to view provisioning events.
  • Use the Fairjungle API logs or admin dashboard to confirm user creation and updates.

Notes​

  • Group provisioning (via SCIM /Groups) is not currently supported.
  • Only users explicitly assigned to the Fairjungle app in Okta will be provisioned.
  • Deactivating a user in Okta will automatically deactivate them in Fairjungle.

Troubleshooting​

If something doesn’t work as expected:

  • Double-check the SCIM Base URL and Bearer Token
  • Verify attribute mappings (especially for required fields)
  • Confirm that users are assigned to the app
  • Use the Okta system log to inspect provisioning errors
  • Contact Fairjungle Support for help