website logo
ChartHop documentation
Carrot reference
Release notes
Navigate through spaces
ChartHop documentation
Carrot reference
Release notes
⌘K
Welcome
Welcome to ChartHop documentationšŸš€
Available ChartHop packages
Getting Started
ChartHop Video Library
Navigating ChartHop
ChartHop terminology
Markdown formatting
Filtering data
Home page
Visualizing your organization
Org Chart
Map
Data Sheet
Employee Profiles
Setting up ChartHop
Creating your ChartHop org
Importing spreadsheet data
Configuring your Org settings
User management
Permissions and security
Creating and managing groups
Customizing ChartHop
Forms
Fields
Customizing employee profiles
Document templates
ChartHop apps and bundles
ChartHop apps
ChartHop bundles
Performance management
Performance reviews
Org management
About org management
Working with jobs
Working with people
Working with job history
Announcing org changes
Planning
Scenarios
Headcount planning
Compensation reviews
Legacy compensation reviews
Compensation bands
Viewing your people data
ChartHop reports
Partners
Sequoia getting started
Accessing ChartHop as a Sequoia customer
ChartHop first run guide for Sequoia customers
ChartHop features available to Sequoia customers
Troubleshooting common sync errors
Developers
ChartHop connect
Developer basics
Events
Syncing data to/from ChartHop
Resources
ChartHop Standard Terms and Conditions
ChartHop Basic Agreement
Data Processing Addendum
Privacy policy
Security statement
Subprocessors
FAQ
Docs powered byĀ archbeeĀ 

Okta

Packages: Basic | Standard | Premium

The Okta app automatically updates your Okta profiles with ChartHop source data. You can configure both Okta profile fields and group memberships. Optionally, you can set the app to create Okta profiles when people are added to ChartHop.

When you install Okta, you'll need to make decisions about how you want to handle Okta profiles, whether you set a default location, and what fields you want to include in your sync.

Field

Description

Okta profiles

  • Automatically create new Okta profiles from ChartHop on sync

  • Don’t create new profiles only update existing Okta profiles on sync

Missing location information

  • Set Remote as the default location in ChartHop
  • Leave location blank in ChartHop

Sync new hires before start date

The number of days before a start date to begin syncing new hires

Obtain Okta API credentials

You will need to obtain API access from Okta before you can install the app. To obtain an Okta API key, follow the steps outlined in their help document here.

  • To connect Okta to ChartHop, you must be an Okta administrator.
  • Once you've received the API token from Okta, do not share this information with anyone outside of your organization.

Install the Okta app

To install the Okta app, follow the steps below.

  1. Select Apps from the settings (gear) menu in the left sidebar.
  2. Locate and select the Okta app in the list of available apps.
  3. Select Install.
  4. Follow the steps outlined in the setup wizard to connect the Okta app to ChartHop.

Run a single, on-demand sync to Okta

Any ChartHop user with sufficient permissions can trigger an on-demand sync to Okta at any time. To sync your data for the first time, or subsequently, on-demand at any time, follow the steps below.

  1. Select Apps from the settings (gear) menu in the left sidebar.
  2. Locate and select the Okta app in the list of available apps.
  3. At the top of the page, select Run one-time sync.
  4. Select Run sync to perform the sync.

Export dry runs

Any ChartHop user with sufficient permissions can trigger a test integration between Okta and ChartHop at any time.

  1. Select Apps from the settings (gear) menu in the left sidebar.
  2. Locate and select the Okta app in the list of available apps.
  3. At the top of the page, select Run one-time sync.
  4. Select Export dry run to test the integration.
  5. When the integration is complete, select Download to recieve the test results file.

Create sync groups

You can create and populate Okta groups from the app config page by following the steps below.

  1. Select Apps from the settings (gear) menu in the left sidebar.
  2. Locate and select the Okta app in the list of available apps.
  3. Under the Advanced Settings section, select Edit.
  4. Under the Sync Groups section, select + Add group.
  5. Enter a name for the group in the Group Name field.
  6. Enter a corresponding Carrot query in the Include People Matching field, or use the filter controls to the left.
  7. Select test to confirm your query. It should open the Data Sheet in a new tab with your query applied.
  8. Select Save at the bottom of the page.

Create sync profile fields

For each custom Okta profile field, you may define a ChartHop field or expression to be synced. To do this, follow the steps below.

  1. Select Apps from the settings (gear) menu in the left sidebar.
  2. Locate and select the Okta app in the list of available apps.
  3. Under the Advanced Settings section, select Edit.
  4. Under the Sync Profile Fields section, select + Add field.
  5. Enter the name of a custom Okta profile field that you wish to populate with data.
  6. Enter the corresponding query or field that you wish to copy from ChartHop.
  7. Select Save at the bottom of the page
Updated 28 Nov 2022
Did this page help you?
Yes
No
UP NEXT
Slack
Docs powered byĀ archbeeĀ 
TABLE OF CONTENTS
Obtain Okta API credentials
Install the Okta app
Run a single, on-demand sync to Okta
Export dry runs
Create sync groups
Create sync profile fields