Skip to main content

Rippling

Visualize Rippling users, workers, and organizational structure, map workers to employees and managers, and monitor changes through queries and alerts.

Installation​

Configuration In Rippling​

For this integration, you will need to generate an API Token in Rippling.

  1. Log in to your Rippling account.
  2. Navigate to Company Settings > Developer.
  3. Select the API Tokens tab.
  4. Create an API Token.
  5. Copy and securely save the generated API Token for use in JupiterOne.
info

As described in the Rippling documentation, API tokens use the permissions of the owner, so they should be treated as if they were a password. The user must have sufficient permissions to create an API token and access user and worker data. API tokens expire after 30 days of inactivity, or when the user is no longer active with the company. You will need to regenerate the token if it expires.

Configuration in JupiterOne​

To complete the Rippling integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Rippling. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Rippling account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • The Rippling API Token generated for use with JupiterOne.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.