Connect an Okta Organization
Integrate your Okta organization with Tenable One Cloud Exposure to reveal a complete inventory of Okta groups and users in your environment.
To leverage Okta authentication data in your dashboard, follow the steps described below to log in to the Okta Admin Console as a Super Administrator, gather relevant account information, and create an access token that grants Tenable access to your Okta account. Tenable recommends creating a dedicated user for this purpose. Doing so simplifies audit trail activities and, if needed at a later date, allows you to more easily terminate the integration by removing the user.
To add an Okta organization:
- In the Cloud Exposure Console, navigate to Settings > Integrations.
- Click Add Integration.
- In the Integrations Library, click Okta. The Okta wizard opens.
-
Create a new Okta user (Step 1 in wizard):
- Log in to the Okta Admin Console as a Super administrator and navigate to Directory > People.
- Click Add person.
Fill out all relevant fields and then click Save.
Note: It’s recommended to use a first name and last name that identify the purpose of the user. For example, First name: Tenable, Last Name: Read Only.- [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
-
Grant permissions to Tenable (Step 2 in wizard):
- Navigate to Security > Administrators.
- Click +Add administrator.
- In the Admin field, choose the user you created in the previous step.
- In the Role field, choose the Read-only Administrator role and then click Save Changes.
- [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
-
Create an access token (Step 3 in wizard):
Sign out of the Okta Admin Console and then sign in with the new user you created in the previous steps.
Note: If you haven’t already done so, make sure to activate the new user account now and set up security methods.- Navigate to Security > API.
- Go to the Tokens tab and click Create Token.
- Enter a meaningful name for the token (for example, ‘Tenable’), and then click Create Token.
Copy and save the Token Value.
Important: Store the token value in a secure location. You will need to enter the value in the next step.- [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
-
Connect your Okta organization to Tenable (Step 4 in wizard):
- In the Cloud Exposure Console, enter a display Name for the organization in Tenable.
Enter your Okta organization URL. This is the web address (root domain only) you use in your browser to access the Okta portal. You can also find this in your welcome/activation email from Okta.
For example, https://example.okta.com/
- Enter the User token that you copied in the previous step, and then click Finish.