You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Optional OIDC configuration (when `WebServer.AuthenticationMethod` is set to `oidc`) enables SSO via OpenID Connect. Register a new OIDC application with your identity provider to get a Client ID and Secret for the TOML fields. When OIDC is enabled, the chainlink node will redirect users to the provider and use the returned ID token for authentication and role assignment. The Client Secret should be populated in the your `secrets.toml` as follows:
926
+
927
+
```toml
928
+
[WebServer.OIDC]
929
+
clientSecret = "secret"# Example
930
+
```
931
+
932
+
### ClientID
933
+
934
+
`ClientID` is the identifier issued by your OIDC provider when registering the Chainlink node application. It represents the expected audience of the ID token. **Required**.
935
+
936
+
### ProviderURL
937
+
938
+
`ProviderURL` is the base issuer or discovery URL for your OIDC provider (e.g., the `.well-known/openid-configuration` endpoint). **Required**.
939
+
940
+
### RedirectURL
941
+
942
+
`RedirectURL` is the callback URL on the Chainlink node (this should be path: `/signin`) to which the IdP redirects after login. This must match the allowed redirect URIs configured in your IdP. **Required**.
943
+
944
+
### ClaimName
945
+
946
+
`ClaimName` specifies the JWT claim containing group or role information (default: `groups`). Change if your provider uses a different claim name.
947
+
948
+
### AdminClaim
949
+
950
+
`AdminClaim` is the claim value (within `ClaimName`) that maps to the Chainlink **Admin** role (default: `NodeAdmins`).
951
+
952
+
### EditClaim
953
+
954
+
`EditClaim` is the claim value that maps to the **Edit** role (default: `NodeEditors`).
955
+
956
+
### RunClaim
957
+
958
+
`RunClaim` is the claim value that maps to the **Run** role (default: `NodeRunners`).
959
+
960
+
### ReadClaim
961
+
962
+
`ReadClaim` is the claim value that maps to the **Read-Only** role (default: `NodeReadOnly`).
963
+
964
+
### SessionTimeout
965
+
966
+
`SessionTimeout` defines how long an OIDC session can remain idle before timing out (default: `15m0s`).
967
+
968
+
### UserApiTokenEnabled
969
+
970
+
`UserApiTokenEnabled` enables OIDC users to generate API tokens with the same permissions as their role (default: `false`).
971
+
972
+
### UserAPITokenDuration
973
+
974
+
`UserAPITokenDuration` sets the lifespan of API tokens issued by OIDC users (default: `240h0m0s`).
975
+
976
+
> **Note:** Configure the OIDC client’s secret (`WebServer.OIDC.ClientSecret`) via the node’s secret management (e.g., environment variable `CL_WEB_SERVER_OIDC_CLIENT_SECRET`). Keep the client secret secure and do not expose it in plaintext configuration.
0 commit comments