Integrating Okta with imper.ai

Overview

Integrating Okta with imper.ai allows the platform to securely set passwords through your existing Okta account.

Once connected, imper.ai can trigger password resets as part of identity verification workflows, improving remediation controls and ensuring a secure end-to-end process.

This article walks you through the required prerequisites and the steps for onboarding the Okta account, creating credentials, configuring permissions, and completing the integration inside imper.ai.

Prerequisites

To integrate Okta with imper.ai, you must have Okta Admin permissions (or equivalent privileges to create App Integrations and assign roles) via the Okta Admin Console.

Step 1: Create an Okta App Integration and credentials

1. Using an Okta admin user, login to your Okta Admin Console (click the Admin button on the top-right bar).

2. In the left navigation panel, navigate to Applications → Applications, click Create App Integration.
   

   

3. Select API Services and click Next.
   

   

4. Type a name in App integration name and click Save.

5. In the General tab (opened by default), navigate to the Public keys section:

   1. Click Edit, and then click Add key.
      

      

   2. In the opened Add a public key pop-up, click Generate new key.
      

      

   3. In the Private key section, click Copy to clipboard - this key needs to be entered later in imper.ai’s integrations interface.
      

      

   4. Click Done to close the pop-up, and then click Save to activate the newly created key.
      

      

6. Still in the General tab, navigate to the Client Credentials section:

   1. Click Edit, select Public key / Private key and click Save.
      

      

   2. A message titled “Existing client secrets will no longer be used” will be displayed - click Save again.
      

      

   3. Next to the Client ID textbox, click Copy to clipboard - this ID needs to be entered later in imper.ai’s integration interface.
      

      

7. Navigate to the Okta API Scopes tab.
   

   

   1. Search for okta.users.manage and click Grant.
      

      

   2. A message titled “Grant Okta API Scope” will be displayed - click Grant Access.
      

      

8. Navigate to the Admin roles tab.
   

   

   1. Click Edit Assignments, choose Organization Administrator for Role and click Save Changes.
      

   2. When prompted for another authentication, complete it.

      

Step 2: Connect Okta to imper.ai

1. Login to the imper.ai admin integrations page.

2. Locate Okta and click Connect.

3. In the integration dialog, fill in your Okta’s organization URL, and the client ID and private key obtained in the previous step.
   

   

4. Click Connect, and a connection attempt will be made to verify the credentials and privileges.