> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Trusona (OIDC)

The Trusona connector integrates the Maverics Orchestrator with Trusona -- enabling OIDC-based passwordless authentication and identity verification.

<Note>
  **Console terminology:** In the Maverics Console, this section is called
  **Identity Fabric**. The YAML configuration uses the `connectors` key to define
  identity provider integrations.
</Note>

## Overview

The Trusona connector uses OpenID Connect. Trusona specializes in passwordless authentication and identity proofing -- making it a strong choice for environments that need to eliminate passwords or verify user identity with high assurance.

## Use Cases

* **Passwordless authentication** -- Replace password-based login with Trusona's passwordless verification, delivering a more secure and frictionless user experience across legacy and modern applications
* **Identity proofing for high-assurance access** -- Leverage Trusona's identity verification capabilities to confirm user identity before granting access to sensitive or regulated applications
* **Unify SSO with step-up verification** -- Orchestrate Trusona alongside a primary IdP to add identity proofing as a step-up authentication layer, extending strong verification to applications that don't natively support it
* **Authentication resilience** -- Include Trusona as part of a multi-IdP failover strategy, ensuring passwordless authentication remains available even if another identity provider experiences an outage

## Setup

<Tabs>
  <Tab title="Console UI">
    To create a Trusona (OIDC) connector in the Maverics Console:

    1. Navigate to **Identity Fabric** in the Console sidebar.
    2. Click **Create** and select **Trusona (OIDC)**.
    3. Enter a **Name** -- this is the friendly name that identifies your provider.
    4. Enter the **OIDC Well Known URL** -- the Trusona OIDC discovery endpoint provided by your Trusona account.
    5. Enter the **OAuth Client ID** -- the client ID from your Trusona application configuration.
    6. Enter the **OAuth Client Secret** -- the client secret from your Trusona application configuration.
    7. Under **Redirect URLs**, add the callback URL where Trusona will redirect after authentication. This URL must match the redirect URI configured in your Trusona application.
    8. Optionally configure **Logout Callback URLs** for single logout support.
    9. Optionally set **Scopes** (space-separated). Default scopes are typically `openid profile email`.
    10. The **PKCE** toggle is enabled by default. Disable it only if your Trusona application is not configured to support Proof Key for Code Exchange.
    11. Optionally enable **Offline Access** for token refresh support (Proxy apps only).
    12. Click **Save**.
  </Tab>

  <Tab title="Configuration">
    ```yaml maverics.yaml theme={null}
    connectors:
      - name: trusona
        type: oidc
        oidcWellKnownURL: "https://{{ env.TRUSONA_HOST }}/.well-known/openid-configuration"
        oauthClientID: "{{ env.TRUSONA_CLIENT_ID }}"
        oauthClientSecret: <vault.trusona_client_secret>
        oauthRedirectURL: "https://app.example.com/oidc/callback"
        scopes: "openid profile email"
    ```

    ## Configuration Reference

    | Key                 | Type   | Required | Description                                                    |
    | ------------------- | ------ | -------- | -------------------------------------------------------------- |
    | `name`              | string | Yes      | Unique connector identifier referenced in app policies         |
    | `type`              | string | Yes      | Must be `oidc`                                                 |
    | `oidcWellKnownURL`  | string | Yes      | Trusona OIDC discovery endpoint URL                            |
    | `oauthClientID`     | string | Yes      | OAuth 2.0 client ID from Trusona                               |
    | `oauthClientSecret` | string | Yes      | OAuth 2.0 client secret (use secret reference syntax)          |
    | `oauthRedirectURL`  | string | Yes      | Callback URL registered with the Trusona application           |
    | `scopes`            | string | No       | Space-separated OAuth scopes (default: `openid profile email`) |
    | `tls`               | string | No       | Named TLS profile for provider communication                   |

    For the complete field reference including health checks, offline access, and PKCE settings, see [Identity Fabric](/reference/orchestrator/identity-fabric#configuration-reference).
  </Tab>
</Tabs>

## Troubleshooting

* **Verify the well-known URL is accessible** from the Orchestrator host -- ensure the Trusona endpoint is correct
* **Ensure the redirect URL matches exactly** what is registered in your Trusona application
* **Check that the client secret reference resolves correctly** via your secret provider
* **Confirm the Trusona application is active** -- disabled applications will not respond to authentication requests

## Related Pages

<CardGroup cols={2}>
  <Card title="Identity Fabric" icon="id-badge" href="/reference/orchestrator/identity-fabric">
    Overview of all identity providers
  </Card>

  <Card title="Generic OIDC" icon="key" href="/reference/orchestrator/identity-fabric/custom-oidc">
    Generic OpenID Connect connector
  </Card>

  <Card title="Okta" icon="shield-halved" href="/reference/orchestrator/identity-fabric/okta">
    OIDC connector for Okta
  </Card>

  <Card title="Keycloak" icon="key" href="/reference/orchestrator/identity-fabric/keycloak">
    OIDC connector for Keycloak
  </Card>
</CardGroup>