Use JumpCloud SAML Single Sign On (SSO) to give your users convenient but secure access to all their web applications with a single set of credentials. Automatically provision, update and deprovision users in 8x8 from JumpCloud using the Identity Management (SCIM) integration. Leverage this integration to centralize user lifecycle, user identity, and group management in JumpCloud for 8x8. Save time and avoid mistakes, as well as potential security risks, related to manually creating users.
Read this article to learn how to setup the 8x8 integration.
Prerequisites
- A JumpCloud Administrator account.
- A 8×8 user account with administrator permissions.
- Your 8×8 domain name.
Important Considerations
- If users’ emails are used by both JumpCloud and 8×8 (as their account usernames), then the administrator should choose 8×8 Username as the User Mapping Field while configuring. However, if these two values for individual users do not match, the administrator should choose Federation ID as the User Mapping Field and follow these steps (after configuring 8×8 SSO) to map 8×8 user accounts to their corresponding JumpCloud accounts:
- Select Accounts.
- Select User Profiles.
- For any user who will be attempting SSO, update the 8×8 user profile by inputting the email used by his or her JumpCloud account in the Federation ID field.
- Select Save and repeat for all users attempting SSO.
- 8×8 SCIM API is based on version 2.0 of the SCIM standard.
- Deletion of a user is not supported. The SCIM DELETE operation will result in the user being deactivated.
- 8×8 User schema URN is urn:ietf:params:scim:schemas:extension:8×8:1.1:User.
- The API does not support assignment of licenses, cost center or user profile, setting of work phone number, update to site once set, and setting of profile picture.
- Some fields set through the SCIM API can be subsequently modified in 8×8 Admin Console. Depending on your SCIM implementation this may lead to some inconsistency between your Identity Management System and 8×8 Admin Console
- Modification of fields other than active is not supported with the PATCH operation. Use PUT instead.
- The fields in 8×8 Admin Consoles for the users which are provisioned through SCIM API, are read only and can be changed only via the IdP.
- If a Login ID is already in use error occurs when trying to sync, delete any existing users created from the 8×8 Admin Console and recreate them in JumpCloud. JumpCloud SCIM management of 8×8 Admin Console users requires that users be created in JumpCloud first, and then synced to 8×8 Admin Console.
- Groups are not supported.
Attribute Considerations
- A default set of attributes are managed for users. See the Attribute Mappings section for more details.
- The userName attribute also sets the user’s Federation ID (used for Single Sign-On) on create only.
- The following custom attributes are not supported by JumpCloud:
- site
- extension
Creating a new JumpCloud Application Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Click + Add New Application.
- Type the name of the application in the Search field and select it.
- Click Next.
- In the Display Label, type your name for the application. Optionally, you can enter a Description, adjust the User Portal Image and choose to hide or Show in User Portal.
- If this is a Bookmark application, enter its URL in the Bookmark URL field.
- Click Save Application.
- If successful, click:
- Configure Application and go to the next section.
- Close to configure your new connector at a later time.
Configuring the SSO Integration
To configure JumpCloud
- Create a new application or select it from the Configured Applications list.
- Select the SSO tab.
- Replace any instances of YOURDOMAIN with your 8×8 domain name.
- Add or change any additional attributes.
- Click save.
To download the certificate
- Find your application in the Configured Applications list and click anywhere in the row to reopen its configuration window.
- Select the SSO tab and click IDP Certificate Valid > Download certificate.
The certificate.pem will download to your local Downloads folder.
To configure 8×8
- Login to 8×8, Inc. as a user with administrative rights.
- Navigate to ACCOUNTS > Single Sign On.
- Select the Single Sign On checkbox.
- Select the SAML radio button.
- Click Save.
- Click OK when the Success message displays.
- On the SAML Sign on configuration page, enter the following information:
- Sign In URL – enter the JumpCloud IDP URL.
- Issuer URL – enter https://<YOURDOMAIN>.com.
- Identity Provider Certificate – browse to the certificate downloaded in the previous section.
- Click Save.
Authorizing User SSO Access
Users are implicitly denied access to applications. After you connect an application to JumpCloud, you need to authorize user access to that application. You can authorize user access from the Application Configuration panel or from the Groups Configuration panel.
To authorize user access from the Application Configuration panel
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications, then select the application to which you want to authorize user access.
- Select the User Groups tab. If you need to create a new group of users, see Get Started: Groups.
- Select the check box next to the group of users you want to give access.
- Click save.
To learn how to authorize user access from the Groups Configuration panel, see Authorize Users to an SSO Application.
Validating SSO authentication workflow(s)
IdP Initiated
- Access the JumpCloud User Console.
- Select the Service Provider icon.
- This should automatically launch and login to the application.
SP Initiated
- Navigate to your Service Provider application URL.
- You will be redirected to log in to the JumpCloud User Portal.
- The browser will be redirected back to the application and be automatically logged in.
Configuring the Identity Management Integration
To configure 8×8
- Navigate to the 8×8 Admin Console.
- Enter your credentials and click Login.
- From Home, click on Identity and Security.
- In the User Provisioning Integration (SCIM) section, select Other SCIM Provider and copy both the 8×8 URL and 8×8 API Token.
- Click Close.
To configure JumpCloud
- Create a new application or select it from the Configured Applications list.
- Select the Identity Management tab.
- .Click Configure. There are two fields:
- *Base URL: Enter the 8×8 URL you copied when configuring 8×8. (e.g., https://platform-cloud.8×8.com/udi/customers/<CUSTOMER_ID>/scim/v2)
- Token Key: Paste the 8×8 API Token you generated when configuring 8×8.
- Click save.
- You will receive a confirmation that the Identity Management integration has been successfully verified.
- You can now connect user groups to the application in JumpCloud to provision the members of that group in 8×8. Learn how to Authorize Users to an Application.
Tip: If you need to update the API Token, you will need to deactivate the integration before you can change the base URL and new API key. After you make the changes, you can re-activate the integration.
Attribute Mappings
The following table lists attributes that JumpCloud sends to the application. See Attribute Considerations for more information regarding attribute mapping considerations.
Learn about JumpCloud Properties and how they work with system users in our API.
8x8 User Attributes
JumpCloud Property | JumpCloud UI Field Name | SCIM v2 Mapping | 8x8 Value |
---|---|---|---|
username | Username | userName | |
firstname | First Name | name.givenName | First Name |
lastname | Last Name | name.familyName | Last Name |
Company Email | emails [work] | Email Address | |
employeeIdentifier | Employee ID | externalId | N/A |
phoneNumbers.value | Work Phone | phoneNumbers [mobile] | Personal contact number |
phoneNumbers.value | Work Phone | phoneNumbers [work] | Personal contact number |
jobTitle | Job Title | title | Job title |
locale | Locale | locale | Language |
timezone | Timezone | timezone | Time zone |
active | Status | active | Active/Inactive |
department | Department | department | Department |
Removing the Integration
To deactivate the IdM Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to deactivate and click to open its details panel.
- Under the company name and logo on the left hand panel, click the Deactivate IdM connection link.
- Click confirm.
- If successful, you will receive a confirmation message.
To deactivate the SSO Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to deactivate and click to open its details panel.
- Select the SSO tab.
- Scroll to the bottom of the configuration.
- Click Deactivate SSO.
- Click save.
- If successful, you will receive a confirmation message.
To delete the application
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to delete and click to open its details panel.
- Check the box for the application.
- Click Delete.
- Enter the number of the applications you are deleting
- Click Delete Application.
- If successful, you will see an application deletion confirmation notification.