Skip to main content

SCIM Setup Instructions

This guide describes the generic steps required to configure SCIM provisioning between your Identity Provider (IdP) and Fairjungle.

Fairjungle supports SCIM 2.0, the industry-standard protocol for identity lifecycle management.

Prerequisites​

Before you begin, make sure you have:

  • Admin access to your Identity Provider (e.g. Okta, Azure Active Directory, OneLogin)
  • Developer access in Fairjungle

Step 1: Enable developper access in Fairjungle​

Contact Fairjungle support or your onboarding manager to request developer access to your fairjunge account.

One your have developper access to Fairjungle API, create an new API key as described in Fairjungle API Quickstart and keep you key secure.

Step 2: Configure SCIM in Your Identity Provider​

In your IdP admin console:

  1. Create or configure the Fairjungle application

    • If a pre-built SCIM connector exists (e.g., in Okta or Azure AD), use it.
    • Otherwise, configure a custom SCIM integration.

  2. Set the SCIM Base URL

    • Enter the SCIM API Base URL: https://api.fairjungle.com/scim/v2

  3. Set the Authentication Method

    • Choose Bearer Token.
    • Paste the Bearer Token received from Fairjungle.

  4. Enable Provisioning Features

    • Enable the following operations (as supported by your IdP):
      • Create Users
      • Update User Attributes
      • Deactivate or Delete Users

  5. Map User Attributes

    • Ensure the following fields are mapped correctly:
      • userName → Primary email address
      • name.givenName → First name
      • name.familyName → Last name
      • active → Account status (true/false)
      • (Optional) department, title, groups, etc.

  6. Test the Connection

    • Use the “Test Connection” button (if available) to verify connectivity.

Step 3: Assign Users to Fairjungle​

Once provisioning is enabled:

  • Assign users to the Fairjungle application in your IdP.
  • Users will be automatically created or updated in Fairjungle based on their profile attributes.

Step 4: Monitor & Audit​

  • Use your IdP’s provisioning logs to verify successful operations.
  • Fairjungle’s admin dashboard (or API logs) can be used to confirm user creation or updates.

Notes​

  • Fairjungle currently supports user provisioning and user deprovisioning.
  • Group provisioning is supported and groups are synchronized to Fairjungle but Fairjungle makes no use of them for now.
  • SCIM provisioning is one-way: your IdP is the source of truth.
  • Fairjungle only supports international phone numbers (eg. +33 123456789)

Troubleshooting​

If provisioning does not work as expected:

  • Double-check the SCIM Base URL and Bearer Token
  • Verify user attribute mappings
  • Ensure assigned users have all required fields (e.g., email, first/last name)
  • Contact Fairjungle Support for assistance