Oidc Authentication Properties

The following properties are available for Oidc Authentication objects, grouped by the categories shown in the authentication service editors.

Behavior

Property Type Default Description

ClockSkewSeconds

int

The allowed clock skew, in seconds, when validating token timestamps.

Debug

bool

Whether additional authentication diagnostics are enabled. Enables additional diagnostic detail in server-side failure responses and in the client login form.

Claims

Property Type Default Description

Audiences

List<string>

The optional audiences accepted by the application during token validation.

Scopes

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.

UsernameClaim

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

ClientAuthenticationType

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.

ClientId

string

The client identifier issued by the identity provider for this application.

ClientSecretToken

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.

RedirectUrl

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

IssuerUrl

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

AuthorizationEndpointUrl

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.

JwkSetUrl

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.

TokenEndpointUrl

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.

UserInfoEndpointUrl

string

An optional explicit user-info endpoint URL, used only when the identity provider does not support discovery.

Misc

Property Type Default Description

AllowSingleSignOnWithPrimaryAccount

bool

true

Whether the hosted browser should attempt to allow single sign on using the operating system’s logged in account.

AuthenticatedUsernameAttribute

string

The identity provider attribute that should be mapped to an authenticated username. If omitted, the authenticated username matches the Dodeca username for the client session.

AuthenticatedUsernameProvider

bool

false

Whether the authentication provider should set the authenticated username for the client session.

AuthenticationFormSize
displayed as AuthenticationFormSizeDefaults

Size

400, 600

Sets the default width and height of the authentication form. When Authentication Form Size Policy is AutoSize, only the width is used; the height is determined automatically from the page content.