Configuration options used to initialize MonoCloudWebJSClient.
| Property | Type | Description |
|---|---|---|
appUrl? | string | The base URL of the application implementing authentication. Used to construct redirect URLs and validate cross-origin messages received from popups or iframes. If omitted, it defaults to the current page's origin (window.location.origin). Example "https://example.com" |
authWindowTimeout? | number | Timeout (in seconds) for popup and silent (iframe) authentication windows before rejecting with a timeout error. Applies to signIn, signOut, and signInSilent. |
callbackPath? | string | Relative callback path where MonoCloud redirects the user after sign-in. This URL must be registered in the application's callback URL settings in MonoCloud. If omitted, the callback URL defaults to appUrl with path /. Example "/callback" |
clientAuthMethod? | ClientAuthMethod | Method used for client authentication when calling the token endpoint. |
clientId | string | Client identifier of the application registered in MonoCloud. |
clientSecret? | string | Jwk | Client secret or JSON Web Key used for client authentication. Only required for confidential clients (for example, when using client_secret_jwt or private_key_jwt). |
clockSkew? | number | Maximum allowed clock skew (in seconds) for claims validations. |
clockTolerance? | number | Maximum allowed clock tolerance (in seconds) applied to time-based claims validations. |
defaultAuthParams? | DefaultAuthParams | Default authorization parameters to include in authentication requests. Only a subset of AuthorizationParams is configurable here; per-request values (state, nonce, codeChallenge, codeChallengeMethod, redirectUri) are managed internally by the SDK. If scopes is not set (here or on the signIn call), the SDK defaults to 'openid profile email'. Hybrid response types (code id_token, code token, code id_token token) are supported, but the SDK always completes the back-channel authorization code exchange and uses those tokens. The front-channel id_token and access_token returned in the URL fragment are only checked for presence; they are not validated and are not stored on the session - the authoritative tokens come from the code exchange, where the ID token signature, nonce, and claims are validated. |
federatedSignOut? | boolean | When true, signs the user out from both the application and MonoCloud (Single Sign-Out). |
fetchUserinfo? | boolean | Determines whether user profile data is fetched from the UserInfo endpoint after authentication. |
filteredIdTokenClaims? | string[] | List of ID token claims to exclude when constructing the final user object stored on the session. If omitted, a default set of protocol claims are removed. |
idTokenSigningAlgorithm? | SecurityAlgorithms | Expected signing algorithm used to validate ID token signatures. |
jwksCacheDuration? | number | Duration (in seconds) to cache the JSON Web Key Set (JWKS) document after it is fetched from the authorization server. |
metadataCacheDuration? | number | Duration (in seconds) to cache OpenID Connect discovery metadata after it is fetched from the authorization server. |
onSessionCreating? | OnSessionCreating | Hook invoked while creating or updating session. |
popupWindowHeight? | number | The height of the popup window in pixels. Used to size and center the window when signIn or signOut is called with mode: 'popup'. |
popupWindowWidth? | number | The width of the popup window in pixels. Used to size and center the window when signIn or signOut is called with mode: 'popup'. |
postCallback? | PostCallback | Callback executed after a successful sign-in or sign-out callback. Useful for client-side router integration. |
resources? | Indicator[] | Additional resources that can be requested via getTokens(). |
sessionKey? | string | A unique identifier that differentiates sessions when multiple clients are used within the same application. This key is appended to the internal session storage key to prevent collisions when multiple MonoCloudWebJSClient instances share the same clientId. |
signOutPath? | string | Relative path where MonoCloud redirects the user after sign-out. This URL must be registered in the application's sign-out URLs in MonoCloud. If omitted, the sign-out callback URL defaults to appUrl with path /. Example "/signout" |
storage? | IStorage | Storage implementation used to persist sessions. Defaults to LocalStorage. |
tenantDomain | string | MonoCloud tenant domain. Example "https://your-tenant.us.monocloud.com" |
validateIdToken? | boolean | Determines whether the ID token signature and claims should be validated. Disabling validation is not recommended. |