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.

Note: This section does not relate to integrating your IdP for the purpose of enabling Cloud Exposure Console login via SSO. For more information about how to enable login via SSO for users who need access to the Console, see Single Sign-On.

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.

FedRAMP: If you use Tenable One Cloud Exposure in a FedRAMP environment, make sure to connect integrations only to FedRAMP authorized services and endpoints. You are responsible for confirming that each service you connect meets your FedRAMP requirements. Sending data to a service outside your authorization boundary can put your organization out of compliance with FedRAMP requirements.

To add an Okta organization:

Note: Be aware that during the wizard you will need to navigate back and forth between the Cloud Exposure Console and the Okta Admin Console. Most steps in this task are performed in the Okta Admin Console, unless indicated otherwise.
  1. In the Cloud Exposure Console, navigate to Settings > Integrations.
  2. Click Add Integration.
  3. In the Integrations Library, click Okta. The Okta wizard opens.
  4. Create a new Okta user (Step 1 in wizard):
    1. Log in to the Okta Admin Console as a Super administrator and navigate to Directory > People.
    2. Click Add person.
    3. 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.
    4. [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
  5. Grant permissions to Tenable (Step 2 in wizard):
    1. Navigate to Security > Administrators.
    2. Click +Add administrator.
    3. In the Admin field, choose the user you created in the previous step.
    4. In the Role field, choose the Read-only Administrator role and then click Save Changes.
    5. [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
  6. Create an access token (Step 3 in wizard):
    1. 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.
    2. Navigate to Security > API.
    3. Go to the Tokens tab and click Create Token.
    4. Enter a meaningful name for the token (for example, ‘Tenable’), and then click Create Token.
    5. 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.
    6. [Cloud Exposure Console] Click NEXT to move to the next step in the wizard.
  7. Connect your Okta organization to Tenable (Step 4 in wizard):
    1. In the Cloud Exposure Console, enter a display Name for the organization in Tenable.
    2. 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/

    3. Enter the User token that you copied in the previous step, and then click Finish.