Skip to main content
Okta

Integrate Okta with Torq to trigger workflows: configure webhooks and event hooks, create test workflows, and set up Okta steps.

Updated over 4 months ago

Okta is an identity and access management service for web-based applications.

Use Okta to Trigger Torq workflows

To ingest Okta events in Torq, you need to create an Okta trigger integration and use the generated webhook URL (Torq endpoint) to configure an event hook in Okta.

Configure an Okta Trigger Integration

  1. Go to Build > Integrations > Triggers > Okta and click Add.

  2. Type a meaningful name for the integration. This cannot be changed later.

  3. Optionally add an authentication header name and value (field and secret).

  4. Click Add.

    image.png
  5. Copy the webhook URL (Torq endpoint).

image.png

While it is optional to provide an authentication header name and value, it's recommended for security purposes. The authentication header name and value must be identical in Torq and Okta. For example, the name auth and the value abc123.

Configure Okta to Send Events to Torq

In Okta, you must create an event hook, select the events to subscribe to (which events to send to Torq) and enter the webhook you generated when you created the Okta integration in Torq. When getting started, we recommend using a single Okta event hook to send all events to Torq and apply trigger conditions to focus the workflow events on the Torq side (see example in the test workflow).

  1. Go to Workflow > Event Hooks and click Create Event Hook.

    Create an event hook in Okta.
  2. In the Name field, enter a meaningful name for the event hook, such as Torq Events.

  3. In the URL field, enter the webhook for the Okta integration in Torq.

  4. Enter the authentication field and authentication secret according to the authentication name and value of the integration in Torq. In this example, auth and abc123.

  5. From the Subscribe to events drop-down menu, select one or more events to send to Torq (the User reported suspicious activity event is used in the test workflow below).

  6. Click Save & Continue.

    Create an event hook endpoint in Okta.

Use Okta Steps in a Torq Workflow

To use Okta steps in Torq workflows, you must create an Okta steps integration, which requires an Okta API token and your Okta domain.

Create an Okta API Token

API tokens inherit the same permissions as the user who creates them, and if the user permissions change, the API token permissions also change. For more information about API tokens, see the Okta documentation.

  1. Sign in to your Okta account with administrator privileges.

  2. Click Security > API > Tokens > Create Token.

  3. Enter a meaningful name for the token, such as Torq Toke, and click Create Token.

  4. Copy the API token to enter it when creating the Okta integration in Torq.

  5. Click the Authorization Servers tab and copy your Issuer URI to enter it when creating the Okta integration in Torq.

oktagif.gif

Create an Okta Steps Integration in Torq

  1. Go to Build > Integrations > Steps > Okta and click Add.

    image.png
  2. Type a meaningful name for the integration instance. This cannot change later.

  3. Enter the values for the following fields. You copied and saved these in the previous task.

    1. API Key

    2. Okta Domain

  4. Click Add.

Available Steps

These are the premade steps for OpenAI. Don't see the step you need? No problem; you can easily create a custom step.

  • Activate users

  • Add a user to a group

  • Assign a role to a user

  • Assign a user to an app

  • Close a session

  • Create a group

  • Create a user without credentials

  • Deactivate a user

  • Delete all sessions for a user

  • Delete a user

  • Enroll Google Authenticator factor

  • Enroll Okta email factor

  • Get group users

  • Get session details

  • Get a single group

  • Get a user by email

  • Get a user by ID

  • Get user groups

  • List apps

  • List app users

  • List groups

  • List system logs

  • List user-assigned roles

  • List user auth factors

  • List users

  • Reactivate a user

  • Remove a group

  • Remove a user from an app

  • Remove a user from a group

  • Reset auth factors

  • Reset a user password

  • Suspend a user

  • Unassign a role from a user

  • Unsuspend a user

Did this answer your question?