Skip to main content

Okta Integration

How to Integrate Okta with Hook

Updated this week

We leverage Okta's OAuth flow for enabling SSO. Follow the instructions below to set up this integration in Hook.

1. Create an OAuth 2.0 app in Okta

  1. Follow the instructions here to create an OAuth 2.0 app in Okta. The scopes we require are:

    • openid - Required for OpenID Connect authentication

    • email - Grants access to the user's email address

    • profile - Grants access to the user's basic profile information

    • okta.emailDomains.read - Read email domain configurations

    • okta.users.read - Read user data from Okta's management API
      ​

      Required Okta scopes for integrating with Hook
      ​

  2. When setting up the OAuth app in Okta, set:

    1. Initiate login URI: https://app.hook.co

    2. Redirect login URI: https://hook.eu.auth0.com/login/callback

2. Update application settings in Okta

  1. Go to Applications → Your OIDC App → General in Okta.

  2. Under Login redirect URIs, make sure you have exactly the same callback URL that Auth0 is using. It must match including https:// compared to http://, trailing slashes, query parameters, etc. It will be in a similar format to https://{customer_name}.okta.com

  3. Under Allowed grant types, confirm Authorization Code (and PKCE if you’re using it) are enabled.

Ensure your application settings appear as above in Okta

3. Share Okta credentials with Hook

  1. Go to https://app.hook.co/configuration/integrations/okta-sso. You should be able to login using your Google account, until Okta SSO is configured. Otherwise speak to your Technical Implementation Consultant about sharing these credentials via 1Password.

  2. Input the Client ID, Client Secret and Okta Domain in the form provided.

  3. Click Submit credentials.

Fill out Client Id, Client Secret and Okta Domain in the form
​

4. Once complete please inform the Hook team. You will be redirected to the following screen once the connection has been established.

Below are instructions on how to navigate through the Hook UI to set up the integration.

Please let us know if you face any issues along the way, happy to jump on a call and go through this with you as well. Once completed, if you could drop us a quick email letting us know and we will take it from there.

1. Once you login (https://app.hook.co/login) you may see the below screen, if you select 'Configure Hook'.

2. Once you have done this, you will be redirected to this page and if you press the '+Add Integration' button you will find a series of options in which you can select 'OKTA SSO'.

3. After selecting OKTA SSO, you will see a screen like below where you can add the Client ID and Client Secret to authenticate then press Submit credentials.

4. Confirm with Hook after the integration has been completed from your side.

Did this answer your question?