Skip to main content

Oauth2 - Okta

This guide explain how to configure Okta with Hoop.

Requirements​

  • Hoop Command Line
  • An account in OKTA
  • API_URL is the public DNS name of the hoop gateway instance
info

Contact the administrator of the hoop gateway instance to retrieve the API_URL address.

Identity Provider Configuration​

1) Create a new application​

  • Go to Applications > Applications and click on the Create App Integration button
  • In Sign-in Method, select OIDC - OpenID Connect
  • In Application type, select Web Application

2) Configure the redirect URIs​

  • Signin redirect URIs: {API_URL}/api/callback
  • Signout redirect URIs: {API_URL}/api/logout

alt text

  • Save the Application

3) Collect the required information​

IDP_CLIENT_ID & IDP_CLIENT_SECRET​

In the Application Home

alt text

IDP_AUDIENCE & IDP_ISSUER​

On Security > API

api settings

4) Add 'https://app.hoop.dev/groups' claim to ID Token (optional)​

  • Go to Security > API > {authorization server} > Claims
  • Add https://app.hoop.dev/groups in the ID Token