Okta
Okta is an identity and access management platform that controls how your workforce signs in to the SaaS applications your organization uses. Nexla connects to the Okta Management API to ingest users, app integrations, app assignments, groups, admin role holders, and System Log sign-in events. Together these answer the core SaaS app inventory and license usage questions: which apps exist, who is assigned to each one, and when each person last signed in.
Power end-to-end data operations for your Okta API with Nexla. Our bi-directional Okta connector is purpose-built for Okta, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Okta or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Okta workflows fast, secure, and fully governed.
Features
Type: API
- Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
- Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
- API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
- Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Prerequisites
Nexla authenticates to Okta with an Okta API token. Every request is sent to your Okta org domain with the header Authorization: SSWS <token>. To create the credential, you need two values:
-
Your Okta domain, such as
acme.okta.comor a custom domain such aslogin.acme.com, entered withouthttps://. -
An Okta API token, created in the Okta Admin Console.
Okta API tokens are issued for a specific user, and all requests made with the token act on behalf of that user. According to Okta, "API tokens inherit the privilege level of the admin account that is used to create them," and if that user's permissions change, so do the token's. Super admins, org admins, group admins, group membership admins, and read-only admins can create tokens. Because Nexla only reads data from Okta, we recommend creating the token while signed in as a dedicated service account that holds the read-only admin role, rather than using a personal admin account.
To create an API token, follow these steps from the Okta help documentation:
-
Sign in to the Okta Admin Console as the service account that will own the token.
-
Go to Security > API, and click the Tokens tab.
-
Click Create token.
-
Enter a name for the token in the What do you want your token to be named? field, such as "Nexla".
-
From the API calls made with this token must originate from dropdown list, select where connections are allowed to come from. Any IP allows connections from any address; the other options restrict the token to network zones defined in your Okta org. Okta only supports IP-based zones for API tokens.
-
Click Create token, then click Copy to clipboard and store the token in a secure location such as a password manager. This is the only time the token value is shown; Okta stores only a hash of it afterwards.
Okta API tokens are valid for 30 days and renew automatically each time they are used. A token that is not used for more than 30 days is revoked and cannot be used again. Tokens issued by a user who is later deactivated are also rejected. Schedule your Okta flows to run at least once every 30 days, and keep the service account active, so the credential does not stop working. See Create an API token for details.
Okta also supports OAuth 2.0 service apps for the Management API, but those require the private_key_jwt client authentication method, which this connector does not support. Use an API token instead.
Authenticate
Credentials required
Okta API token created by an admin (Security > API > Tokens). The token inherits the creating admin's permissions; use a read-only admin service account.
| Field | Required | Secret | Description |
|---|---|---|---|
| Okta Domain | Yes | No | Your Okta org domain without https://, e.g. acme.okta.com or a custom domain such as login.acme.com. |
| API Token | Yes | Yes | The Okta API token value (sent as Authorization: SSWS <token>). |
Create a credential in Nexla
-
After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.
-
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
-
Enter your Okta org domain in the Okta Domain field, without the
https://prefix or any path. For example, enteracme.okta.com, or your custom domain such aslogin.acme.com. Nexla sends all API requests tohttps://<your domain>/api/v1. -
Paste the token you created in the Okta Admin Console into the API Token field. Enter only the token value; Nexla adds the
SSWSprefix to theAuthorizationheader automatically.The API token is a secret and should be treated like a password. It carries the permissions of the admin account that created it, so create it with a dedicated read-only admin service account. If the token is exposed, revoke it in the Okta Admin Console under Security > API > Tokens and create a new one.
-
Click the Save button at the bottom of the overlay. Nexla validates the credential by calling the Okta endpoint that returns the current user (
/api/v1/users/me). The newly added credential will now appear in a tile on the Authenticate screen during data source creation.
Use as a data source
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Okta connector tile, then select the credential that will be used to connect to your Okta org, and click Next; or, create a new Okta credential for use in this flow.
The Okta connector is a data source only. It reads from Okta and does not write to it.
Endpoint templates
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Okta endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.
For a SaaS app inventory and license usage view, the endpoints fit together as follows: List Applications gives the inventory of apps; List Application Users and List Application Group Assignments show who holds each app, directly or through a group; List Users provides each person's status and lastLogin; and List System Log Events shows sign-ins to each app over a time window. The per-app, per-group, and per-user endpoints take an ID returned by the list endpoints.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.
Manual configuration
Okta data sources can also be manually configured to ingest data from any valid Okta Management API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Okta Management API endpoints follow the pattern https://<your Okta domain>/api/v1/<resource>, and most list endpoints return a top-level JSON array (path to data $[*]). Okta paginates them with the Link response header: each page includes a rel="next" link carrying an after cursor until the last page. List Users with Admin Roles is the exception: it returns an object with the users under value (path to data $.value[*]) and the next page in _links.next.href. Okta recommends following these links rather than building cursor URLs yourself. The Authorization: SSWS header is added automatically by your credential. For more information, see Pagination in the Okta API reference.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Okta data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.