Data Integration Guide - Okta

Granting Access

Privilege Level

Different Okta API operations require different admin privilege levels. API tokens inherit the privilege level of the admin account that is used to create them. It is therefore good practice to create a service account to use when you create API tokens so that you can assign the token the specific privilege level needed. 

Create a Read-Only Administrator Account

First, you will need to create a read-only administrator account for Okta. To create the account, follow the steps below:

1. Log in to your Okta console.
2. Navigate to Directory > People.
3. Click Add person.
4. In the Add Person pop-up window that opens, enter the details for the new user.
5. Click Save to create the new user.
6. Navigate to Security > Administrators.
7. Click + Add administrator.
8. Fill out the fields on the Administrator assignment by admin page. For more information about these fields, see below:
   1. Admin: Select the user you created in step 5 above.
   2. Role: Select Read-only Administrator.
9. Click Save Changes to create the new administrator account.

Create an API Token

1. Log in to your Okta console with the read-only administrator account you created above.
2. Navigate to Security > API.
3. Select the Tokens tab.
4. Click Create Token.
5. Enter a name for the token.
6. Click Create Token. Once you click this button, your token will display.
   
   

Permissions

Required Information

The values Living Security will need to access the API are:

• Authentication Token
• Host