> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/configuration/sso-configuration.md).

# SSO Configuration

Configure Single Sign-On for Silkline with Azure AD (OIDC), Google Workspace, or Okta Workforce as your identity provider

## Overview

Silkline authenticates users through its own identity service at `auth.silkline.ai`. Your identity provider (IdP) connects to that service as an upstream OpenID Connect provider: users click **Sign in** in Silkline, Silkline hands them to your IdP, and your IdP returns them to Silkline once they have authenticated.

The setup page provides the values specific to your Silkline organization:

* **A redirect URI** (also called a callback URL or sign-in redirect URI) that you register in your IdP. It is specific to your organization.
* **Verified email domains** that identify which accounts the connection covers.

## Silkline URLs

| Value                  | Production                                                          | Test / Gov                                                                  |
| ---------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Application            | `https://app.silkline.ai`                                           | `https://dev-app-gov.silkline.ai`                                           |
| Authentication host    | `https://auth.silkline.ai`                                          | `https://dev-auth-gov.silkline.ai`                                          |
| Issuer                 | `https://auth.silkline.ai/realms/silkline`                          | `https://dev-auth-gov.silkline.ai/realms/silkline`                          |
| Redirect URI (per org) | `https://auth.silkline.ai/realms/silkline/broker/<org-id>/endpoint` | `https://dev-auth-gov.silkline.ai/realms/silkline/broker/<org-id>/endpoint` |

{% hint style="info" %}
`<org-id>` is your organization's Silkline ID. Generate a link in **Settings → Single sign-on**, then copy the full redirect URI from its setup page. See [Self-service SSO setup](https://docs.silkline.ai/configuration/sso-configuration/self-service-sso.md).
{% endhint %}

{% hint style="warning" %}
Register the URLs for the environment you are connecting to. Most customers only need the production column — use the test / Gov column only if Silkline has directed you to that environment.
{% endhint %}

## Set up SSO

An organization admin generates a setup link in **Settings → Single sign-on** and shares it securely with the IdP administrator. The IdP administrator opens the link, follows the provider's instructions, and enters the issuer and client credentials directly on the setup page. The connection is provisioned when setup completes; test a real user sign-in to verify it.

See [Self-service SSO setup](https://docs.silkline.ai/configuration/sso-configuration/self-service-sso.md).

## Guides

* [Self-service SSO setup](https://docs.silkline.ai/configuration/sso-configuration/self-service-sso.md)
* [Troubleshooting SSO](https://docs.silkline.ai/configuration/sso-configuration/troubleshooting.md)
* [Azure AD (OIDC)](https://docs.silkline.ai/configuration/sso-configuration/azure-ad-oidc.md)
* [Google Workspace](https://docs.silkline.ai/configuration/sso-configuration/google-workspace.md)
* [Okta Workforce Enterprise](https://docs.silkline.ai/configuration/sso-configuration/okta-workforce-enterprise.md)

## Domain scoping

An SSO connection applies to the email domains registered for your organization (for example `your-company.com`). Silkline verifies each domain before a connection can be created, so sign-ins from addresses outside those domains are not routed to your IdP. Contact <support@silkline.ai> to add or change your domains.

## Troubleshooting by identity provider

* [Microsoft Entra ID (Azure AD)](https://docs.silkline.ai/configuration/sso-configuration/azure-ad-oidc.md#troubleshooting): setup validation, AADSTS codes, tenant/cloud, consent, and email claims.
* [Okta Workforce](https://docs.silkline.ai/configuration/sso-configuration/okta-workforce-enterprise.md#troubleshooting): app assignments, issuer/server selection, client credentials, and sign-on policy.
* [Google Workspace](https://docs.silkline.ai/configuration/sso-configuration/google-workspace.md#troubleshooting): OAuth client and redirect errors, Workspace access policy, account selection, and verification.
* [Other providers (generic OpenID Connect)](https://docs.silkline.ai/configuration/sso-configuration/troubleshooting.md#other-providers-generic-openid-connect): issuer discovery and endpoint requirements.
* [Shared SSO troubleshooting](https://docs.silkline.ai/configuration/sso-configuration/troubleshooting.md): setup links, domain and account checks, browser sessions, verification, and support evidence.
