Before you start
The person going through the setup process below needs to be able to Create new Custom Integrations in the Rippling instance for your organization.
Connection Steps
In your Adaptive admin portal, navigate to the Employees Tab and select 'Sources'. In the Primary Identity Source section, click Setup and then select Rippling SCIM from the drop down
After clicking 'Install', click the 'Provision Token' button. This will then take you back to the Source view where you can click on the three-dot menu for Rippling and click 'Details' to see the connection information you will need to enter into Rippling.
Rippling Setup
As an Rippling administrator, log into the Rippling app and navigate to the ‘Custom Integrations’ manager page (‘IT’ in left hand menu > ‘Custom Integrations’)
Click "Create new Custom Integration" and complete the below fields before pressing ‘Continue’:
App Name: AdaptiveUserSync
Select Categories: Security, Training & Onboarding, Compliance
Upload logo:
What type of app would you like to create: User Management via SCIM
On the ‘SCIM Configuration’ step, set the following values before clicking ‘Continue’:
SCIM version: 2.0
Sign sign-on URL: https://api.adaptivesecurity.com/v1/
SCIM Authorization Method: Bearer Token
Supports Groups: check this box
Supports Mutually Exclusive Groups: select ‘Not Mutually Exclusive Groups’
Update application user name on: ‘User Management via SCIM’
Make sure the following boxes are checked:
Supports Pagination
Use PATCH to edit groups
Use email address as user name
Supported SCIM Attributes: Select all available attributes (Adaptive will be adding support for all attribute values in the near future)
When prompted with “Do you want to install the app?” click ‘Install Now’
In the “Select Installer” flow, select, “I’m the {application name} admin, I’ll do it.” On the offboarding step, click ‘Continue’. When prompted, take the Rippling SCIM token you provisioned in the Adaptive U.I. in an early step and paste it into the ‘Bearer Token’ field and click “Continue”.
Some users have experienced a set up flow where Rippling skips the above step (in error) to enter the Bearer Token. In those cases, you should navigate to app -> Settings tab -> Modify App -> ‘Click here’ 
From there you will click ‘Continue’ -> ‘Continue’ through the first few pages, then click ‘Reinstall Now’ – which we’ve seen take users to the step to enter the Bearer Token 
|
On the “Account Provisioning” step, you can select whichever option matches your internal policy. If choosing ‘Everyone except contractors should get an account’ we will also allow you to exclude certain employees directly in the Adaptive platform.
Ensure the check box next to ‘Create accounts for existing employees who don’t have accounts’ is
selectedbefore moving to whichever access option you selected
On the “Provision Time” step, we recommend selecting:
On their start date, not before
Once you get to the “Account Matching” step – click ‘Continue’. On the “Group Types Setup” step, configure which groups should be included in the app (if applicable)
On the “Attribute Mapping” step, click ‘Edit’ in the top right hand corner of the attributes table and update the dropdown for each attribute to be ‘On user creation and updates’. After that is done, press ‘Save’ at the bottom of the table before clicking ‘Continue’.
On the “Offboarding” step, click ‘Continue’ You should then see a message that the installation is complete
Rippling typically starts syncing with Adaptive after a few minutes, and may take a few hours to complete depending on the number of employee records. You can view records that have been successfully imported by viewing your Employees tab in the Adaptive admin: https://admin.adaptivesecurity.com/users
FAQ
How often does Adaptive use the integration to refresh employee records?
Rippling will push data on user creation and user updates. It is always possible to manually ‘Synchronize’ data by navigating to the ‘Setting’ section of the app, but Adaptive has no ability to kick off a refresh of data on your behalf (without access to your Rippling admin experience)