refactor: generalize OIDC configuration and add documentation by soorya38 · Pull Request #5408 · litmuschaos/litmus

soorya38 · 2026-01-21T04:13:25Z

This PR refactors the authentication configuration to use generic OIDC naming conventions, moving away from Dex-specific strict naming. This clarifies that Litmus supports any OIDC provider, not just Dex.

Key Changes:

Environment Variables: Renamed variables to be generic (e.g., DEX_ENABLED → OIDC_ENABLED, DEX_OAUTH_CLIENT_ID → OAUTH_CLIENT_ID).
Endpoints: Renamed the callback endpoint from /auth/dex/callback to /auth/oauth2/callback.
Documentation: Added a new "OIDC Configuration" guide (experiments/concepts/IAM/oidc-configuration.md) explaining how to set up generic OIDC, with Dex provided as a concrete example.

Related issue: #5391

Types of changes

What types of changes does your code introduce to Litmus? Put an x in the boxes that apply

New feature (non-breaking change which adds functionality)
Bugfix (non-breaking change which fixes an issue)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
Documentation Update (if none of the other choices applies)

Checklist

Put an x in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your code.

I have read the CONTRIBUTING doc
I have signed the commit for DCO to be passed.
Lint and unit tests pass locally with my changes
I have added tests that prove my fix is effective or that my feature works (if appropriate)
I have added necessary documentation (if appropriate)

Dependency

Please add the links to the dependent PR need to be merged before this (if any).

Special notes for your reviewer:

BREAKING CHANGE: usage of DEX_* environment variables (e.g. DEX_ENABLED, DEX_OAUTH_CALLBACK_URL) has been replaced by generic OIDC_* and OAUTH_* variables. Users upgrading to this version will need to update their deployment manifests to match the new variable names.

Signed-off-by: soorya38 <csasoorya@gmail.com>

Summary The authentication system works great with any OIDC provider (we're using Keycloak), but the naming throughout the codebase is Dex-specific which is confusing. Current Issues - Callback endpoint: /auth/dex/callback - hardcoded with 'dex' in the path - Environment variables: DEX_OAUTH_CALLBACK_URL, DEX_OAUTH_CLIENT_ID, DEX_OAUTH_CLIENT_SECRET, DEX_ENABLED - Documentation: Focuses heavily on Dex setup rather than generic OIDC configuration Changes - Rename callback/login endpoint: /auth/dex/callback -> /auth/oauth2/callback - Rename env variables: - DEX_ENABLED -> OIDC_ENABLED - DEX_OAUTH_CALLBACK_URL -> OAUTH_CALLBACK_URL - DEX_OAUTH_CLIENT_ID -> OAUTH_CLIENT_ID - DEX_OAUTH_CLIENT_SECRET -> OAUTH_CLIENT_SECRET - Update docs to explain generic OIDC setup with Dex as one example Signed-off-by: soorya38 <csasoorya@gmail.com>

Copilot

Pull request overview

This PR aims to generalize Litmus ChaosCenter’s OIDC configuration and documentation by moving away from Dex-specific naming, updating environment variable names and documented callback URLs to reflect a generic OIDC provider setup.

Changes:

Renames Dex-prefixed OAuth/OIDC environment variables in shipped manifests and versioned documentation YAMLs (e.g., DEX_ENABLED → OIDC_ENABLED, DEX_OAUTH_CLIENT_ID → OAUTH_CLIENT_ID).
Updates the documented OAuth callback path from /auth/dex/callback to /auth/oauth2/callback (including Dex example redirect URIs).
Adds a new MkDocs guide for generic OIDC configuration and links it in the MkDocs nav.

Reviewed changes

Copilot reviewed 124 out of 124 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
mkdocs/mkdocs.yml	Adds the new OIDC configuration doc page to navigation.
mkdocs/docs/experiments/concepts/IAM/oidc-configuration.md	New guide describing generic OIDC setup (Dex used as example).
mkdocs/docs/3.9.2/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.2/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.2/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.1/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.1/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.1/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.9.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.8.0/litmus-cluster-scope-3.8.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.8.0/litmus-3.8.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.7.0/litmus-cluster-scope-3.7.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.7.0/litmus-3.7.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.6.1/litmus-cluster-scope-3.6.1.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.6.1/litmus-3.6.1-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.6.0/litmus-cluster-scope-3.6.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.6.0/litmus-3.6.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.5.0/litmus-cluster-scope-3.5.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.5.0/litmus-3.5.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.4.0/litmus-cluster-scope-3.4.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.4.0/litmus-3.4.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.3.0/litmus-cluster-scope-3.3.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.3.0/litmus-3.3.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.2.0/litmus-cluster-scope-3.2.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.2.0/litmus-3.2.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.25.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.25.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.25.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.24.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.24.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.24.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.23.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.23.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.23.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.22.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.22.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.22.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.21.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.21.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.21.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.20.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.20.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.20.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.19.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.19.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.19.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.18.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.18.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.18.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.17.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.17.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.17.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.16.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.16.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.16.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.15.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.15.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.15.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.14.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.14.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.14.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.13.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.13.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.13.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.12.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.12.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.12.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.11.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.11.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.11.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.10.0/litmus-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.10.0/litmus-installation.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.10.0/litmus-getting-started.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.1.0/litmus-cluster-scope-3.1.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.1.0/litmus-3.1.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0/litmus-cluster-scope-3.0.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0/litmus-3.0.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta12/litmus-3.0.0-beta12.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta12/litmus-3.0.0-beta12-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta11/litmus-3.0.0-beta11.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta11/litmus-3.0.0-beta11-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta10/litmus-3.0.0-beta10.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta10/litmus-3.0.0-beta10-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta9/litmus-3.0.0-beta9.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta9/litmus-3.0.0-beta9-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta8/litmus-3.0.0-beta8.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta8/litmus-3.0.0-beta8-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta7/litmus-3.0.0-beta7.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta7/litmus-3.0.0-beta7-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta6/litmus-3.0.0-beta6.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta6/litmus-3.0.0-beta6-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta5/litmus-3.0.0-beta5.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta5/litmus-3.0.0-beta5-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta4/litmus-3.0.0-beta4.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta4/litmus-3.0.0-beta4-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta3/litmus-3.0.0-beta3.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta3/litmus-3.0.0-beta3-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta2/litmus-3.0.0-beta2.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0.0-beta2/litmus-3.0.0-beta2-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0-beta1/litmus-3.0-beta1.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/3.0-beta1/litmus-3.0-beta1-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.14.0/litmus-2.14.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.14.0/litmus-2.14.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.13.0/litmus-2.13.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.13.0/litmus-2.13.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.12.0/litmus-2.12.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.12.0/litmus-2.12.0-without-resources.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.11.0/litmus-2.11.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.10.0/litmus-2.10.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.9.0/litmus-2.9.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.8.0/litmus-2.8.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.7.0/litmus-2.7.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.6.0/litmus-2.6.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.5.0/litmus-2.5.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.4.0/litmus-2.4.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.3.0/litmus-2.3.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
mkdocs/docs/2.2.0/litmus-2.2.0.yaml	Updates documented ConfigMap keys to generic OIDC/OAuth env var names.
chaoscenter/manifests/litmus-without-resources.yaml	Updates the default “ci” manifest ConfigMap keys to generic OIDC/OAuth env var names.
chaoscenter/manifests/litmus-installation.yaml	Updates the default “ci” manifest ConfigMap keys to generic OIDC/OAuth env var names.
chaoscenter/manifests/litmus-getting-started.yaml	Updates the default “ci” manifest ConfigMap keys to generic OIDC/OAuth env var names.
chaoscenter/dex-server/dex-deployment.yaml	Updates Dex static client redirect URIs to the new callback path.
chaoscenter/authentication/pkg/utils/configs.go	Updates env var reads for OIDC enablement, callback URL, and client ID to new names.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

chaoscenter/authentication/pkg/utils/configs.go

+	DexEnabled                   = getEnvAsBool("OIDC_ENABLED", false)
+	DexCallBackURL               = os.Getenv("OAUTH_CALLBACK_URL")
+	DexClientID                  = os.Getenv("OAUTH_CLIENT_ID")
 	DexClientSecret              = os.Getenv("DEX_OAUTH_CLIENT_SECRET")


chaoscenter/manifests/litmus-getting-started.yaml

-  DEX_OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/dex/callback"
-  DEX_OAUTH_CLIENT_ID: "LitmusPortalAuthBackend"
-  DEX_OAUTH_CLIENT_SECRET: "ZXhhbXBsZS1hcHAtc2VjcmV0"
+  OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/oauth2/callback"


chaoscenter/manifests/litmus-installation.yaml

-  DEX_OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/dex/callback"
-  DEX_OAUTH_CLIENT_ID: "LitmusPortalAuthBackend"
-  DEX_OAUTH_CLIENT_SECRET: "ZXhhbXBsZS1hcHAtc2VjcmV0"
+  OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/oauth2/callback"


chaoscenter/manifests/litmus-without-resources.yaml

-  DEX_OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/dex/callback"
-  DEX_OAUTH_CLIENT_ID: "LitmusPortalAuthBackend"
-  DEX_OAUTH_CLIENT_SECRET: "ZXhhbXBsZS1hcHAtc2VjcmV0"
+  OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/oauth2/callback"


mkdocs/docs/experiments/concepts/IAM/oidc-configuration.md

+| Variable | Description | Example |
+|----------|-------------|---------|
+| `OIDC_ENABLED` | Set to `true` to enable OIDC authentication. | `true` |
+| `OAUTH_CALLBACK_URL` | The callback URL where the OIDC provider will redirect after authentication. | `http://<chaos-center-domain>/auth/dex/callback` |
+| `OAUTH_CLIENT_ID` | The Client ID registered with your OIDC provider. | `LitmusPortalAuthBackend` |
+| `DEX_OAUTH_CLIENT_SECRET` | The Client Secret registered with your OIDC provider. | `ZXhhbXBsZS1hcHAtc2VjcmV0` |
+| `OIDC_ISSUER` | The issuer URL of your OIDC provider. | `http://dex-server:5556/dex` |
+| `OAUTH_SECRET` | A secret used to sign the internal JWTs. | `my-secret-key` |
+


mkdocs/docs/experiments/concepts/IAM/oidc-configuration.md

+staticClients:
+  - id: LitmusPortalAuthBackend
+    redirectURIs:
+      - 'http://<your-litmus-domain>/auth/dex/callback'
+    name: 'LitmusPortalAuthBackend'
+    secret: your-client-secret


chaoscenter/dex-server/dex-deployment.yaml

+          - '/auth/oauth2/callback'
+          - 'http://localhost:8080/auth/oauth2/callback' # Included for local testing purposes


mkdocs/docs/experiments/concepts/IAM/oidc-configuration.md

+- Litigation Chaos Center installed (version 3.0.0 or later recommended).
+- An OIDC provider (e.g., Dex, Keycloak, Okta, Google, etc.).


mkdocs/docs/experiments/concepts/IAM/oidc-configuration.md

+   env:
+     - name: OIDC_ENABLED
+       value: "true"
+     - name: OAUTH_CALLBACK_URL
+       value: "http://<your-litmus-domain>/auth/dex/callback"
+     - name: OAUTH_CLIENT_ID
+       value: "LitmusPortalAuthBackend"
+     - name: DEX_OAUTH_CLIENT_SECRET
+       value: "your-client-secret"
+     - name: OIDC_ISSUER
+       value: "http://<your-oidc-provider-url>"
+   ```


mkdocs/docs/3.9.2/litmus-installation.yaml

+  OIDC_ENABLED: "false"
  OIDC_ISSUER: "http://<Your Domain>:32000"
-  DEX_OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/dex/callback"
-  DEX_OAUTH_CLIENT_ID: "LitmusPortalAuthBackend"
-  DEX_OAUTH_CLIENT_SECRET: "ZXhhbXBsZS1hcHAtc2VjcmV0"
+  OAUTH_CALLBACK_URL: "http://<litmus-portal frontend exposed URL>:8080/auth/oauth2/callback"
+  OAUTH_CLIENT_ID: "LitmusPortalAuthBackend"
+  OAUTH_CLIENT_SECRET: "ZXhhbXBsZS1hcHAtc2VjcmV0"


PriteshKiri · 2026-04-08T11:20:27Z

Hey @soorya38

Could you please check the Co-pilot comments?

soorya38 added 2 commits January 21, 2026 09:32

Docs: Add Generic OIDC Configuration with Dex Example

cb715ee

Signed-off-by: soorya38 <csasoorya@gmail.com>

soorya38 mentioned this pull request Jan 22, 2026

OIDC naming is Dex-specific but works with any OIDC provider #5391

Open

PriteshKiri added 2 commits February 18, 2026 15:08

Merge branch 'master' into master

2dd05db

Merge branch 'master' into master

e2dda89

SarthakJain26 requested a review from Copilot March 17, 2026 10:12

Copilot started reviewing on behalf of SarthakJain26 March 17, 2026 10:13 View session

Copilot AI reviewed Mar 17, 2026

View reviewed changes

PriteshKiri added 2 commits March 17, 2026 17:40

Merge branch 'master' into master

cfcff1f

Merge branch 'master' into master

4b82f69

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

refactor: generalize OIDC configuration and add documentation#5408

refactor: generalize OIDC configuration and add documentation#5408
soorya38 wants to merge 6 commits intolitmuschaos:masterfrom
soorya38:master

soorya38 commented Jan 21, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

PriteshKiri commented Apr 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		- '/auth/oauth2/callback'
		- 'http://localhost:8080/auth/oauth2/callback' # Included for local testing purposes

		- Litigation Chaos Center installed (version 3.0.0 or later recommended).
		- An OIDC provider (e.g., Dex, Keycloak, Okta, Google, etc.).

Conversation

soorya38 commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related issue: #5391

Types of changes

Checklist

Dependency

Special notes for your reviewer:

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

PriteshKiri commented Apr 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

soorya38 commented Jan 21, 2026 •

edited

Loading