🚀 Auth0

This document will guide you through the steps needed to set up the OpenID Connect (OIDC) protocol for Keboola apps, specifically for use on Auth0.

Step 1: Create a New OAuth 2.0 Client ID in Auth0

Follow these steps to create a new OAuth 2.0 client ID in Auth0:

1. Go to the Auth0 and log in
2. Select Applications and click Applications.
3. Click +Create Application.
4. Select End users authenticate through my application.
5. Then select Frontend.
6. Choose Other browser technology as an application technology and give your application a name, for example, “Streamlit OIDC Demo”. Then click Continue.
7. Choose Python as a technology you are using in your web app.
8. You do not have the Allowed callback URL yet; you will need to create an app in Keboola first.
9. Click Save Changes to finish.

Step 2: Create an App in Keboola

Follow these steps to configure your app in Keboola:

1. Go to your Keboola project
2. Click Apps.
3. Create a new app by clicking the green + button.
4. Give your app a name and click Create App to finalize the creation.

Step 3: Set Up the Authentication Method

Follow these steps to set up the authentication method for your app:

1. Go to the newly created app
2. Click the Information & Settings tab.
3. Under Authentication, select OIDC and then Generic OIDC.
4. Copy the client ID from your Auth0 application to the Client ID field in Keboola.
5. Copy the client secret from the Auth0 application to the Client secret field in Keboola.
6. In the Issuer URL field, enter https://<yourDomain>.us.auth0.com/, which is the correct issuer URL for Google OAuth 2.0.
7. Click Save to apply the changes.

Step 4: Set Up the Auth0 Consent Screen

Follow these steps to configure your app’s consent screen in Auth0:

1. Go to the Auth0 and open your OIDC application
2. Go to the Settings tab and enter the Allowed callback URL. The format of the callback URL is as follows: https://<dataAppId>.hub.<keboolaConnectionHost>/_proxy/callback (e.g., https://auth0-oidc-data-app-1234567890.hub.keboola.com/_proxy/callback)
3. Save the changes

Step 5: Deploy the App in Keboola

Follow these steps to deploy your app in Keboola:

1. Go back to your app in Keboola
2. Click the Deploy App tab.
3. Select the Code or GitHub deployment type, and add the code for your application.
4. Click the green Deploy App button to deploy the application.

Step 6: Test your App

Follow these steps to test your new app:

1. Go to the app’s URL
2. You should be redirected to the Auth0 consent screen
3. Log in with your Auth0 account to verify your identity
4. The app should display its content