Auth0 Integration
This guide provides step-by-step instructions on integrating Auth0 as an identity provider for your application.
Prerequisites
- An Auth0 account. If you don't have one, you can sign up at Auth0.
Steps to Integrate Auth0
-
Create a New Application in Auth0
- Log in to your Auth0 dashboard.
- Navigate to the "Applications" section and click on "Create Application".
- Choose a name for your application and select the application type (use single page application).
- Click "Create".
-
Copy the Client Id and Client Secret
- After creating the application, navigate to the "Settings" tab.
- Copy the "Client ID" and "Client Secret". You will need these values to
-
Copy additional configuration
- In settings scroll to the bottom and open up Advanced Settings
- Click Endpoints and copy the following URLs:
- Authorization Url: URL for authorization requests.
- Token Url: URL for token requests.
- Json web key set Url: URL for retrieving the JSON Web Key Set (JWKS).
-
Create IdentityProvider Resource in Haste Health
- Go to the Haste Health Admin App for your tenant.
- Navigate to the system project.
- Click Identity Provider
- Click New
- Provide the following details:
- Name: A friendly name for the identity provider (e.g.,
Auth0). - Status: Set to
active. - Access Type: Set to
oidc. - Authorization_endpiont: The Authorization Url copied from Auth0.
- Token_endpoint: The Token Url copied from Auth0.
- Jwks_uri: The Json web key set Url copied from Auth0.
- Scopes: Specify the scopes required for your application (e.g.,
openid profile emailnote openid is required to veirfy user). - Client ID: The Client ID copied from Auth0.
- Client Secret: The Client Secret copied from Auth0.
- Enable PKCE: Enable this option for enhanced security if your IDP supports it.
- Name: A friendly name for the identity provider (e.g.,
-
Save the Identity Provider
- Click Create to save the new Identity Provider configuration.
-
Add Redirect URI in Auth0
- Go back to your Auth0 application settings.
- In the "Allowed Callback URLs" field, add the redirect URI for your Haste Health application
https:://[haste-health-host]/w/[my-tenant]/system/api/v1/oidc/federated/[idp-resource-id]/callback - Save the changes.
-
Enable IDP for a project.
- In the Haste Health Admin App, go to system project and click update to the desired project where you want to enable Auth0 as an identity provider.
- At the bottom go to Identity Providers section.
- Click Add Identity Provider and select the Auth0 identity provider you created earlier.
- Save the project configuration.
-
Test the Integration
- Click the Project where you enabled the Auth0 identity provider.
- Click sign out from the admin-app if you are logged in.
- You should see a login option to authenticate using Auth0.
- Click the Auth0 login option and complete the authentication process.
- After successful authentication, you should be redirected back to your application with the user authenticated.