Oidc Authentication Properties
The following properties are available for Oidc Authentication objects, grouped by the categories shown in the authentication service editors.
Claims
| Property | Type | Default | Description |
|---|---|---|---|
List<string> |
The optional audiences accepted by the application during token validation. |
||
List<string> |
The scopes requested during authentication. The server requires the openid scope and treats an empty list as openid alone; the profile scope supplies the preferred_username claim that the authenticated username derives from by default. |
||
string |
The token claim whose value becomes the authenticated username. A blank value is treated as preferred_username by the server; a login fails when the configured claim is not present in the token. This is resolved on every login under every PrincipalResolutionPolicy, including Principal, so a missing claim fails login even for an already fully-provisioned user. |
Client
| Property | Type | Default | Description |
|---|---|---|---|
string |
CLIENT_SECRET_BASIC), PropertyOrder(16 |
The client authentication method used at the token endpoint: CLIENT_SECRET_BASIC, CLIENT_SECRET_POST, or PUBLIC. A blank value is treated as CLIENT_SECRET_BASIC. PUBLIC is the standard OAuth2/OIDC "public client" pattern for an application that cannot keep a secret confidential - it is not a reduced-security option, and Dodeca always uses Authorization Code + PKCE for every OIDC login regardless of this setting. |
|
string |
The client identifier issued by the identity provider for this application. |
||
string |
The name of the tenant token containing the client secret. The secret value is stored as a tenant token on the server and is never stored in application metadata. Leave blank when ClientAuthenticationType is PUBLIC. |
||
string |
The callback URL registered with the identity provider, in the form \{metadata service URL}/sso-launch/{tenant}/{application}. The value must exactly match a redirect URL pre-registered with the identity provider. |
Configuration
| Property | Type | Default | Description |
|---|---|---|---|
string |
The issuer URL used for OIDC discovery and issuer validation. The value must match the issuer in the provider’s discovery document exactly, including any trailing slash. When set, the provider’s endpoints are discovered automatically and the Endpoints properties should be left blank. |
Endpoints
| Property | Type | Default | Description |
|---|---|---|---|
string |
An explicit authorization endpoint URL, used only when the identity provider does not support discovery. Leave blank when IssuerUrl provides discovery; when specified, TokenEndpointUrl and JwkSetUrl must also be specified. |
||
string |
An explicit JSON Web Key Set (JWKS) URL, used only when the identity provider does not support discovery. The key set publishes the provider’s public signing keys used to validate tokens. Leave blank when IssuerUrl provides discovery; when specified, AuthorizationEndpointUrl and TokenEndpointUrl must also be specified. |
||
string |
An explicit token endpoint URL, used only when the identity provider does not support discovery. Leave blank when IssuerUrl provides discovery; when specified, AuthorizationEndpointUrl and JwkSetUrl must also be specified. |
||
string |
An optional explicit user-info endpoint URL, used only when the identity provider does not support discovery. |