Hanzo
PlatformHanzo KMSIntegrationsApp Connections

Okta Connection

Learn how to configure an Okta Connection for Hanzo KMS.

Hanzo KMS supports the use of API Tokens to connect with Okta.

Create Okta API Token

From the Okta admin dashboard, navigate to Security > API > Tokens and click Create token.

Create API Token

Enter the token name and select Any IP for the second dropdown, then click Create token.

Provide Info

Copy the token from the modal for later steps.

Copy Token

Create Okta Connection in Hanzo KMS

In your Hanzo KMS dashboard, navigate to the Integrations tab in the desired project, then select App Connections.

App Connections Tab

Click the Add Connection button and select Okta from the list of available connections.

Complete the Okta Connection form by entering:

  • A descriptive name for the connection
  • An optional description for future reference
  • Your Okta instance URL
  • The API Token from earlier steps

Connection Modal

After clicking Create, your Okta Connection is established and ready to use with your Hanzo KMS project.

Connection Created

To create a Okta Connection, make an API request to the Create Okta Connection API endpoint.

Sample request

curl    --request POST \
        --url https://app.kms.hanzo.ai/api/v1/app-connections/okta \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-okta-connection",
            "method": "api-token",
            "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
            "credentials": {
                "instanceUrl": "https://example.okta.com",
                "apiToken": "<YOUR-API-TOKEN>"
            }
        }'

Sample response

{
  "appConnection": {
      "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
      "name": "my-okta-connection",
      "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
      "description": null,
      "version": 1,
      "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
      "createdAt": "2025-04-23T19:46:34.831Z",
      "updatedAt": "2025-04-23T19:46:34.831Z",
      "isPlatformManagedCredentials": false,
      "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
      "app": "okta",
      "method": "api-token",
      "credentials": {
          "instanceUrl": "https://example.okta.com"
      }
  }
}

How is this guide?

Last updated on

On this page