黑料海角91入口

Integrate with the 黑料海角91入口 SCIM API

Streamline user lifecycle management for your organization by connecting any generic Service Provider (such as an HRIS provider or other user directory) with 黑料海角91入口 using 黑料海角91入口's SCIM API. This type of integration can enable real-time user data syncing from the Provider to 黑料海角91入口, automating user creations, updates, and suspensions in 黑料海角91入口 based on updates made in the Service Provider.

This integration lets you manage your organization鈥檚 user identities in the Service Provider, and easily connect users to all of the IT resources they need through 黑料海角91入口.

Prerequisites:

  • A Service Provider that supports an integration to a SCIM API. (They must have a SCIM client)
  • A Service Provider account with the appropriate level of permissions to connect to an external SCIM API
  • A 黑料海角91入口 organization
  • A 黑料海角91入口 Admin account with Administrator role access and API access enabled.
    • We strongly recommend creating a separate admin account just for this integration. This will allow you to easily identify the actions taken by the integration and avoid breaking the integration if a person leaves or changes roles.
  • A 黑料海角91入口 API key that will be used in the custom x api key header. Learn how to generate your API key below.

Considerations:

  • Your Service Provider is where identities are sourced and serves as the 鈥渟ource of truth鈥 or "authority" for user attributes. Once that identity is in 黑料海角91入口, admins can manage access, authentication, and extend that identity to all 黑料海角91入口 managed resources.聽
  • When a user is created in the Service Provider, they will be added in 黑料海角91入口 as a user with a pending password status. This means a user will need to establish and maintain their password within 黑料海角91入口. Imported users won鈥檛 automatically be sent an activation email upon creation. 
  • Currently, the API token doesn鈥檛 expire. 
  • The generic SCIM integration uses .
  • The 黑料海角91入口 SCIM API is based on version 2.0 of the .
  • Real-time Group import isn鈥檛 currently supported. 

Attribute Considerations:

  • Any attributes that have been selected within your Service Provider for export to 黑料海角91入口 will overwrite values existing in 黑料海角91入口 with each update that is triggered in the Service Provider.
    • We recommend Administrators Enable read-only on the user鈥檚 portal profile page for all users in the Organization Settings within the 黑料海角91入口 admin portal, to prevent users and other administrators from updating attributes in 黑料海角91入口.

Generically Integrating with the 黑料海角91入口 SCIM Server

To integrate with the SCIM server:

  1. Log in to the .
  2. Click on your initials in the top right corner, then click API Settings to access your API Key.
  3. Copy this key to paste in the API Key/Secret Token field of your Service Provider later. 
  4. Now, log into your Service Provider's administrator account. 
  5. Every Service Provider will have a different way of accessing application integrations.
  6. You should look for a gallery of available applications to install, find or search for 黑料海角91入口 and install the application.

Note:

黑料海角91入口 isn鈥檛 listed in every Service Provider鈥檚 application gallery. If this is the case, you will need to create a custom application for 黑料海角91入口.

  1. If you create a new application, we recommend using a name like; Real-time 黑料海角91入口 Import, or something similar.
  2. Now, open the application dashboard. Each Service Provider will have different questions regarding the application, for example; which attributes do you want to send to 黑料海角91入口? Enable/Disable Single Sign On (SSO)? User Provisioning Settings etc... However, all of them will require a Tenant URL, and a 黑料海角91入口 API Key (also commonly known as a Secret Token).
    • Tenant URL: For 黑料海角91入口 this is a SCIM based URL, https://api.jumpcloud.com/scim/v2
    • API Key/Secret Token: A 黑料海角91入口 API key should be used to authorize this integration. The API key in 黑料海角91入口 is associated with an admin account. Use an admin account that has a role of Admin with Billing, Administrator, or Manager that will be a long lived admin account for your organization.
      • From your Admin portal, click on your initials in the top right corner, then click API Settings to access your API Key. 
      • Copy/paste this key into the API Key/Secret Token field.
  3. You should receive a notification from your Service Provider that 黑料海角91入口 was saved/created successfully. 
  4. To confirm this, go back to the Service Provider鈥檚 application gallery and confirm that your newly created application; 黑料海角91入口/Real -time 黑料海角91入口 Import is there. 
  5. Make sure that all the other settings you want integrated with 黑料海角91入口 are set, including attribute mappings, provisioning, email notifications, group sync, Single Sign On (SSO) etc鈥
    • Note: Take a look at the Attribute Mappings table below to see which attributes 黑料海角91入口 sends to Service Providers, because not all attributes are supported. 
  6. Your integration is now established.  If you go back to your 黑料海角91入口 Administrator console, go to USER MANAGEMENT > Users and refresh the page, you will see newly added users in a password pending state. 

Connector Attribute Mappings

The following table lists attributes that the 黑料海角91入口 SCIM client will accept from this integration. Learn about 黑料海角91入口 Properties and how they work with systemusers in our . 

黑料海角91入口 Property 黑料海角91入口 UI SCIM v2 Mapping 黑料海角91入口 Validation Type
username Username userName required, no special characters, (max length 1024). note: email may not be used as username. Some integrations leverage the email substring for the username string
firstname First Name name.givenName max length 1024 string
lastname Last Name name.familyName max length 1024
email Company Email emails: value (primary) email, required, max length 1024 string
displayName Display Name displayName - string
password password password subject to org settings string

!suspended && !passwordExpired

N/A active - boolean
N/A N/A meta.created - string
N/A N/A meta.lastModified - string
jobTitle Job Title title - string
department Department

urn:ietf:params:scim:schemas:extension:enterprise:2.0:user:department

- string
location Location locale - string
costCenter Cost Center costCenter - string
employeeType Employee Type userType - string
company Company organization - string
employeeIdentifier Employee ID

urn:ietf:params:scim:schemas:extension:enterprise:2.0:user:employeeNumber

- string
Back to Top

List IconIn this Article

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case