Skip to main content
The integration supports user and group lookups, System Log retrieval, policy inspection, account suspension and restoration, password expiration, session revocation, and IP blocklist management.
/api/v1 identifies the API version. It does not identify an Okta product release or certify compatibility with a particular AirMDR connector release.
The supplied AirMDR connection form uses an Okta API token and the Okta organization domain.Although the AirMDR field is named Api_key, enter the API token generated in the Okta Admin Console.Okta authenticates API-token requests using the following authorization scheme:
Enter only the raw token value in AirMDR’s credential field.The token inherits the creating administrator’s permissions. If that account’s permissions change, the token’s effective permissions change accordingly.
Select access according to the skills the integration will execute.

Create Okta API Token

  • Login into the Okta Admin Console.
  • Enter your admin username and password, then click Sign In.
Create the API token using an administrator account with permissions for the AirMDR skills you intend to use. Okta API tokens inherit the permissions of the administrator who creates them; permission to create a token does not automatically provide access to remediation actions.For the suspend-user and Unsuspend user in okta skills, use a token created by a Super Admin or Org Admin. For Add IP To Okta Blocklist Zone and Remove IP From Okta Blocklist Zone, use a token created by a Super Admin, as specified for these AirMDR skills.A token created by a Read Only Admin cannot perform these remediation actions. A Group Admin token does not provide the network-zone management permissions required for the blocklist skills.The list of RBACs (Role-Based Access Control) to create Okta API tokens are as follows:
  • Super Admins
  • Org Admins
  • Group Admins
  • Group Membership Admins
  • Read Only Admins
  • In the Okta Admin Console, click on Security in the top navigation bar.
  • From the dropdown, select API.
  • Under the API section, click on the Tokens tab.
  • Click the Create Token button.
Okta 2 Pn
  • In the Create Token dialog box, enter a Token Name (e.g., “Companyname Okta API Token”).
  • Click Create Token to generate the new token.
After creation, Okta will display the new API token.
This is the only time the token will be visible, so copy and store it securely (e.g., in a password manager).
  • Click Done to finish the process.
Now that you have your API token, you can use it to authenticate API requests.
Email the API token and the Okta Base URL to AirMDR.

Optional: Revoke an API Token

If you need to revoke the token at any time:
  • Go back to the API Tokens page in the Okta Admin Console.
  • Find the token you want to revoke and click on the Revoke button next to it.
To view the details of Input Parameters and Output for the respective skills
  • Go to AirMDR → Okta Integration page.
  • Select the Skills tab and click on the required listed skills.

Configure Okta in the AirMDR Integrations Dashboard

  1. Navigate to AirMDR, provide the credentials, and click Login
  2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select Integrations.
  3. Use the search option, enter the keyword “Okta”, select the Connections tab, and click Add New Connection.
  4. Enter an unique name to the Instance (e.g., your org name-Okta) to easily identify the user connection by AirMDR and brief Description to showcase the purpose.
  5. Enter the generated API Key and Base Domain in the Authentication Details field params, and click Save.

Skills Provided by this Integration

Investigation and Discovery — Read-only

Additional Information

Common FailuresThese status and error-code mappings follow Okta’s API error reference.Skill-Specific RecoveryRate-Limit Recovery
  1. Review the available rate-limit headers.
  2. Respect X-Rate-Limit-Reset.
  3. Reduce parallel executions or request frequency.
  4. Use backoff for subsequent retries.
  5. Review the Rate Limits dashboard if throttling continues.
Recovery After a Timeout
  1. Inspect the current user or network-zone state.
  2. Determine whether the original operation completed.
  3. Retry only if the action is still required.
  4. Record the final verified outcome.
Important: A timeout does not establish that a write operation failed.
AirMDR Execution ResultsReview the following information for each execution:
  • Selected connection and skill.
  • Target resource and operation options.
  • Execution timestamp and reference.
  • Returned records or action outcome.
  • Available HTTP status and provider error details.
Use these details to correlate AirMDR executions with Okta activity.Okta System Log
  1. In the Okta Admin Console, go to Reports > System Log.
  2. Select the time range covering the AirMDR execution.
  3. Search using the relevant actor, target user, IP address, or event information.
  4. Expand matching events.
  5. Review the actor, target, outcome, and available request details.
  6. Compare the events with the AirMDR execution result. help.okta.com
The Lookup Okta System Logs skill can also retrieve events for investigation.Sample Diagnostic EntryThe following is an illustrative support record, not a native AirMDR log schema:
Do not include tokens or complete authorization headers in logs.Recommended Log LevelsThese are operational recommendations. Okta System Log uses its own severity fields.Log Retention and Rate LimitsOkta maintains a rolling 90-day System Log window. Export records when longer retention is required.
  • 📧 Contact AirMDR Support through your designated support channel.
  • 🔁 Rotate credentials regularly. Recommended cadence: As per your internal security policy
  • 🔄 Replace a token before expiration. 

Data Flow

  1. An AirMDR workflow executes an Okta skill using the selected connection.
  2. The integration sends an authenticated request to the organization’s Okta API.
  3. Okta evaluates the token, permissions, target resource, and applicable restrictions.
  4. A read operation retrieves information; an authorized write operation changes the target state.
  5. AirMDR receives the result or error. Image
Data ExchangedPorts and EndpointsThese are API reference families rather than a complete trace of the connector’s internal requests.Encryption and Credential Protection