Auth0

Overview

This article provides step-by-step instructions for setting up a new Auth0 tenant and application, as well as configuring OIDC (OpenID Connect) authentication in Gigantik CMS using Auth0 as the identity provider. OIDC authentication allows collectors to securely authenticate and access your Gigantik Marketplace using their existing Auth0 accounts.

Prerequisites

Before proceeding, ensure that you have the following:

• A valid Auth0 account
• Access to the Gigantik CMS

Creating a New Auth0 Tenant

To create a new Auth0 tenant, follow these steps:

1. Log in to your Auth0 account.
2. Navigate to the Auth0 Dashboard.
3. Click on your tenant name in the top-left drop-down menu.
4. Click on the Create Tenant button.
5. Provide a name, the hosted region, and the environment tag for your new tenant.

6. Click Create.

🚧

This process may change based on decisions at Auth0. Please see the official documentation:

https://auth0.com/docs/get-started/auth0-overview/create-tenants

Creating a new Application in Auth0

To create a new application in Auth0 or use the default application, use the following instructions:

1. Log in to the Auth0 Dashboard.
2. Select the desired tenant from the "Tenants" drop-down menu.
3. Click on Applications >Applications in the left-hand menu.
4. Click on the Create Application button.
5. Enter a name for your application.
6. Choose Single Page Web App as the application type.

7. Click Create.

Configuring Application Settings

To configure the application settings in Auth0, follow these steps:

1. In the Applications dashboard, click on your newly created application.
2. Select the Settings tab.
   1. Make note of the Domain and Client ID values displayed on this page.
   2. Under Application URIs > Allowed Callback URLs, enter the root of your marketplace URL, including a trailing slash. For example, enter "https://example.shops.gigantik.io/"

3. Click Add to Save the settings.

Configuring the OIDC Provider in the Gigantik CMS

To create an OIDC provider in Gigantik CMS and configure it with Auth0, use the following instructions:

1. Log in to the Gigantik CMS
2. Navigate to Marketplace > OpenID Connect

3. At the top right of the Open ID Connect screen, click the Add OpenID Connect Provider button
   1. Provide a name for the OIDC provider (e.g. "Auth0").
   2. For the Discovery Endpoint, enter the following URL, replacing with your actual Auth0 domain: https:///.well-known/openid-configuration/
   3. In the Client ID field, enter the client ID obtained from the Auth0 application settings (Step 2 of Configuring Application Settings).
   4. Optionally, you can provide a button image for the OIDC provider.

4. Save the OIDC provider configuration.

Conclusion

By following the steps outlined in this article, you should now have successfully set up OIDC authentication for your Gigantik Marketplace using Auth0 as the identity provider. With this setup, collectors can now authenticate securely and access your Gigantik marketplace using their Auth0 credentials.

For further information about advanced configuration options, refer to the official Auth0 documentation.