Okta Integration

Okta Service Integration Guide

IdentiGuard authenticates with Okta through an API service integration. Follow these steps to register the IdentiGuard integration, collect the generated credentials, and finish the tenant setup inside IdentiGuard.

1

Prerequisites

  • Administrator access to your Okta organization with permissions to manage API service integrations.
  • API Access Management enabled (Okta > Security > API).
  • The IdentiGuard workspace and tenant you plan to pair with Okta.
2

Register the IdentiGuard API service integration

  1. 1. Sign in to the Okta Admin Console.
  2. 2. Go to Applications > Applications.
  3. 3. Click Browse App Catalog.
  4. 4. Search "IdentiGuard".
  5. 5. Then click Add Integration.
  6. 6. Confirm the access required and select Install & Authorize.
  7. 7. Copy the client secret generated to your clipboard to be used later.
  8. 8. Your Okta domain and client ID will be visible, keep this page open.
3

Enter the values in IdentiGuard

  1. 1. Inside IdentiGuard, open the workspace that will connect to Okta and navigate to Tenants.
  2. 2. Create a new tenant or edit the existing Okta tenant you wish to configure.
  3. 3. Paste the Client ID, Client Secret, and Domain URL into their matching form fields.
  4. 4. Check all the Okta events you want to be monitored, the default is to click 'Select All'.
  5. 5. Click Add Tenant to save the configuration.
4

Test the integration

  1. 1. In your Okta tenant, navigate to Workflows > Event Hooks.
  2. 2. Open the newly created Event Hook and navigate to the Preview section.
  3. 3. Select any event type, even if it doesn't have sample data and then click on the Deliver Request button.
  4. 4. If the test is successful, an alert should show in the IdentiGuard application.
  5. 5. If the test fails, review the IdentiGuard activity log together with the Okta system log entry for the event to confirm the credentials and scopes are correct.

Need more help?

For assistance with advanced Okta topics—custom authorization servers, fine-grained scopes, or lifecycle automation—contact us via the support form and include your workspace name and any relevant Okta request IDs.