--- title: "Configure OpenID Connect with Okta" slug: "okta" updated: 2026-07-24T09:19:57Z published: 2026-07-24T09:19:57Z canonical: "docs.discngine.com/okta" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.discngine.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure OpenID Connect with Okta ## Overview This guide will walk you through configuring OpenID Connect authentication with Okta for Discngine Admin Center. Once completed, users will be able to log in using their Okta credentials. ## Prerequisites Before configuring Okta OpenID Connect, ensure you have: - Organisation Administrator access to Discngine Admin Center (if you see an "Identity Provider" section, you are an Administrator) - Administrator access to an [Okta Workforce Identity Cloud Account](https://www.okta.com/) - Your Okta account connected to a business email address ## Okta Configuration ### Step 1: Access Okta Admin Panel 1. Log in to your Okta account 2. Navigate to the **Admin** panel ![Okta admin button](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-admin-button.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=TwueEj%2F8tF%2B2yMu86kczyuIXveVMteVqnCjq65XhfWM%3D) ### Step 2: Create App Integration 1. Navigate to **Applications** → **Applications** 2. Click the **Create App Integration** button ![Create app integration](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-create-app-integration.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=dzKEZtwEuQ%2BxwACcopVye0g%2BZ8HLr5aDmMYl%2BnoY0To%3D) ### Step 3: Select Integration Type 1. Select **OIDC - OpenID Connect** as the sign-in method 2. Select **Web Application** as the application type 3. Click **Next** ![OIDC and web application](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-oidc-webapp.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=3plwkjO4AuUwVSnlmp2wsw4Y5AcRn0uSULnb7RRFhC0%3D) ### Step 4: Configure Application Settings 1. Enter an **App integration name** (e.g., "Discngine Admin Center") 2. Ensure **Authorization Code** is checked under Grant type 3. Set the **Sign-in redirect URI** to: `https://account.discngine.cloud/oauth2/callback` 4. Under **Assignments**, select **Skip group assignment for now** 5. Click **Save** ![Name and redirect URI](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-name-uri.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=MiZMF5rnuEteqnGldipeJt920GhB2hBul1AqqCwZSts%3D) ### Step 5: Save Client Credentials Once the application is created, copy the following values to a secure location: - **Client ID** - **Client Secret** (click to reveal) ![Client ID and secret](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-client-id-secret.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=kjDMbyoIRF00UYz74S6klI1QYz3BDFw1l2qqTMHU9ak%3D) ### Step 6: Configure Issuer URL 1. Navigate to the **Sign On** tab 2. Under **OpenID Connect ID Token**, change the **Issuer** to use the **Okta URL** 3. Click **Save** 4. Copy the **Issuer URL** (e.g., `https://your-domain.okta.com`) ![Issuer URL](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-issuer.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=90421BnVIgPbFdJMSBCIPtYvqcG9HjrLU2K0B33QDiY%3D) ### Step 7: Assign Users 1. Navigate to **Directory** → **People** 2. Click on the username of the user you want to enable for authentication 3. Click **Assign Applications** 4. Click **Assign** next to your newly created application 5. Click **Save and Go Back**, then **Done** ## Configure OpenID Connect in Discngine Admin Center ### Step 1: Access Identity Providers 1. Log in to Discngine Admin Center as an Organisation Administrator. 2. Navigate to **Identity Providers** in the left sidebar or via the **Identity Providers** card on the home page. 3. Click **New Provider** and set **Provider Type** to **OpenID Connect with Issuer URL**. ![Create a new OpenID integration](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/new_idp_provider.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=AWk7wAG8S4dBHVFRHkNigOvMoHqwwtKZhYMbuG6ftG0%3D) ### Step 2: Configure Provider Settings The OpenID Connect form is simplified — you only need the following fields: - **Name:** `Okta` - **Issuer URL:** your Okta URL (e.g., `https://your-domain.okta.com`). Endpoint discovery happens automatically from this URL. - **Client ID:** the Client ID from Okta - **Client Secret:** the Client Secret from Okta Click **Save**. ![Okta Identity Provider Configuration](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-idp-settings.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=MKu0kGJz4W43L1xWt8dwYTFgOiZZOoOGx9xllJkNc5k%3D) ### Step 3: Enable for Applications By default, the new provider is not enabled for any application. 1. Open the provider from the Identity Providers page and switch to the **Application Registration** tab. 2. Your applications are listed grouped by environment. Turn the **Enabled** toggle on for each application that should use this provider. 3. Click **Save**. For more details on assigning providers to applications, see [How to Manage Identity Providers](/public/docs/how-to-manage-identity-providers). ## Testing the Configuration ### Step 1: Access Login Page Navigate to `https://admin-<organisation-name>.discngine.cloud/` ### Step 2: Test Login 1. Enter your email address 2. You should see the **Login with Okta** button 3. Click the button 4. You will be redirected to the Okta login page 5. Enter your Okta credentials 6. Complete any required multi-factor authentication 7. After successful authentication, you'll be redirected back to Discngine Admin Center ![Login with Okta](https://cdn.document360.io/dde9293e-c107-4b3e-9774-9c9c296ed970/Images/Documentation/okta-login-button.png?sv=2026-02-06&spr=https&st=2026-11-16T05%3A43%3A17Z&se=2026-11-16T06%3A43%3A17Z&sr=b&sp=r&sig=X148hqUloOaG7UjXszcOsoO5HxaT%2FkrPht6CquqzlBk%3D) ## Troubleshooting ### Common Issues **Redirect URI Mismatch** - Ensure the redirect URI in Okta exactly matches: `https://account.discngine.cloud/oauth2/callback` **User Not Assigned** - Verify that the user attempting to log in is assigned to the Okta application - Check the Assignments section in your Okta application **Invalid Client Credentials** - Double-check that you copied the Client ID and Client Secret correctly - Ensure the Client Secret hasn't been regenerated **Issuer URL Issues** - Verify you're using the correct Okta domain URL - Ensure the URL doesn't have a trailing slash **Scope Errors** - Make sure `openid` and `email` scopes are configured - Verify that the scopes are enabled in your Okta application ## Additional Resources - [Okta - Generic OpenID Connect Documentation](https://help.okta.com/en-us/Content/Topics/integrations/open-id-connect.htm) - [Okta Developer Documentation](https://developer.okta.com/docs/) ## Next Steps - [← Back to How to Manage Identity Providers](/public/docs/how-to-manage-identity-providers)