Okta is a secure identity cloud that links all your apps, logins and devices into a unified digital fabric.

Requirements #

To use the Okta Connector in Lucidum:

  1. Before configuring the Okta connector in Lucidum, you must create a service account and generate an API key in Okta.

  2. You can then configure the Okta connector in Lucidum and start ingesting data from Okta.

Prerequisite: Define an API Key in Okta #

To create an API key in Okta:

  1. Log in to Okta as am administrator.

  2. Create a read-only administrator account for the Lucidum connector. For details, see https://help.okta.com/oie/en-us/content/topics/security/custom-admin-role/create-admin-role-assignment-by-admin.htm.

  3. Go to Security > Administrator. Click Add administrator. Select the Read Only Admin Role.

  4. Login to Okta with the read-only administrator account.

  5. Create an API token for the read-only administrator account. https://help.okta.com/en-us/content/topics/security/api.htm?cshid=ext-create-api-token#create-okta-api-token

  6. Go to the Admin Console select the Security menu and then select API > Tokens.

  7. Click Create Token.

  8. Choose a token with Okta API type.

  9. On the pop-up, type a new name for the token and click Create Token.

  10. Copy the token value and save it in a secure location.

Configuring the Okta Connector #

To configure Lucidum to ingest data from Okta:

  1. Log in to Lucidum.

  2. In the left pane, click Connector.

  3. In the Connector page, click Add Connector.

  4. Scroll until you find the Connector for Okta. Click Connect. The Settings page appears.okta_connector_config.png

  5. In the Settings page, enter the following

    • URL. The base URL of the Okta server. For example, https://lucidum.okta.com

    • Application Lookback in Days. Number of previous days from today to examine when retrieving application access logs. The default value is “2”.

    • API Token. Enter the value of the API token that you created in the previous section.

  6. To test the configuration, click Test.

    • If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.

    • If the connector is not configured correctly, Lucidum displays an error message.

API Documentation #

https://developer.okta.com/docs/reference/core-okta-api/