Skip to main content

Okta (Source)

Overview​

The Okta source connector lets you connect to an Okta org using an API token.

This connector is currently in development. At this time:

  • Connection/authentication validation is supported.
  • Catalog discovery returns an empty catalog.
  • Data extraction is not yet available.

Setup​

Prerequisites​

  • An Okta org (for example, your-org.okta.com).
  • An Okta API token with sufficient permissions to read the resources you intend to sync once extraction is available.

Create an Okta API token​

  1. In Okta Admin Console, go to Security → API → Tokens.
  2. Create a token and copy it (you won’t be able to view it again).

Authentication​

This connector authenticates using an Okta API token sent as an Authorization header in the form:

  • Authorization: SSWS <api_token>

During connection validation, the connector calls:

  • GET https://{host}/api/v1/org

Configuration​

Provide the following fields when configuring the Okta source:

FieldTypeRequiredDescription
hoststringYesYour Okta org hostname (DNS hostname only), e.g. your-org.okta.com. Do not include https:// or any path.
api_tokenstringYesOkta API token used to authenticate requests.

Host format requirements​

host must be a valid DNS hostname:

  • Maximum total length: 253 characters
  • Each label (between dots) must be 1–63 characters
  • Labels cannot start or end with -
  • Allowed characters: letters (A-Z, a-z), digits (0-9), and -

Examples:

  • Valid: dev-123456.okta.com
  • Invalid: https://dev-123456.okta.com (contains scheme)
  • Invalid: dev_123.okta.com (contains _)

Streams​

No streams are currently available. Extraction is not yet implemented for this connector.