What is an Okta integration and how to use it?

Owned by Gemma Dowsett, created
Jan 18, 2023
3 min read

In this article, you will learn what Okta integration is and how to successfully use it.

What is Okta integration?

The Okta integration is an integration between Okta and the Learn Amp platform that allows you to have users automatically created, deactivated, reactivated, or updated from Okta via webhooks/Event hooks which you can configure within Okta.

How do I create an Okta integration?

Step 1: Create the App Integration

  • Sign in to your okta account: https://www.okta.com

  • In the left-hand side navigation, expand Applications > Click on Applications > Select Create App Integration

 

Step 2: Select your preferred Sign-in method

  • In the pop-up, select OIDC - OpenID Connect

  • Click on Web Application

  • Click Next

 

Step 3: Customise the app integration

  • In the General Settings panel, fill in the App Integration Name.

  • Make sure all 3 options under Client acting on behalf of a user are checked.

  • For Sign-in redirect URIs, click Add URI > type in: https://<subdomain>.learnamp.com/en-US/okta/auth_callback

  • Click Add URI > type in: https://<subdomain>.learnamp.com/users/auth/okta/callback

  • For Assignments select an option that suits you the best.

  • Click Save

 

Step 4: Customise the app integration

In the Client Credentials panel:

  • Copy the value from Client ID and paste it into the corresponding field.

  • Copy the value from Client secret and paste it into the corresponding field.

In the General Settings panel:

  • Copy the value from the Okta domain and paste it into the corresponding field (API URL).

 

 

 

 

Step 5: Customise the app integration

  • In the Left Hand Side Menu, click on Security > select API.

  • Select the Tokens tab > click on Create Token.

  • In the pop-up, fill in the name of your Token > click on Create Token.

  • Copy the value in Token Value and paste it into the field API Token > click on Save.

 

 

Step 7: Finalise the app integration

  • When the page reloads, click on Connect to Okta.

  • Congratulations, the integration is now finalised!

How do I enable instant updates (Event hooks):

  • In the Left Hand Side Menu, select Workflow > click on Event Hooks.

  • Click Create Event Hook button:

    • Fill in Name

    • Fill in URL with: https://<subdomain>.learnamp.com/webhooks/okta

    • Fill in Authentication field with: Authorization

    • Fill in Authentication secret with: <secret-from-learnamp-okta-setup-page>

  • Please add the following for Subscribe to events:

    • User assigned to app

    • User added to group

    • User's Okta profile updated

    • User unassigned from app

    • User deactivated

    • User removed from group

    • User reactivated

    • User deleted

  • Click Save & Continue

 

 

Contact Support | Privacy Policy