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

# Enterprise SSO and SCIM

> Set up SAML 2.0 or OIDC single sign-on, direct SSO sign-in links, domain capture, SCIM 2.0 user and group sync, and workspace sign-in controls on Ando Business.

Enterprise SSO and SCIM directory sync are included on the **Business** plan. Workspace owners configure both directly in **Settings → General → Member sign-in**, without filing a support ticket.

## Set up SAML 2.0 or OIDC SSO

1. Open **Settings → General** and scroll to **Member sign-in**.
2. Click **Set up SAML / OIDC SSO**. Ando opens the guided setup portal for your workspace.
3. Choose your identity provider (Okta, Microsoft Entra ID, Google Workspace, OneLogin, Ping, JumpCloud, CyberArk, Rippling, AD FS, or generic SAML 2.0 / OIDC) and follow the provider steps to exchange metadata or client credentials.
4. Return to **Settings → General**. Your connection appears under **Member sign-in** with its live status (`Active`, `Draft`, or `Needs attention`).
5. Click **Test SSO sign-in** to sign in through your identity provider and verify the connection.

Once your own session is authenticated through SSO, the **SSO only** radio option unlocks. Ando requires an active SSO session before turning on **SSO only** so you cannot lock yourself out of the workspace.

### Direct SSO sign-in link

Once an active SSO connection is configured, click **Copy SSO link** under **Member sign-in** to share your workspace's direct sign-in URL (`https://app.ando.so/sso/<workspace-slug>`). Opening that link redirects teammates straight to your identity provider without entering an email address first.

## Verify company domains and domain capture

1. Under **Member sign-in**, click **Verify domains**.
2. Add your company email domain and publish the DNS TXT record shown in the portal.
3. Once verified, teammates who enter their work email on the sign-in screen route straight to your identity provider.

Verified and pending domains appear directly under **Member sign-in**.

To prevent shadow-IT workspaces on your company domain, expand **Advanced SSO options** and enable **Block new workspaces on verified domains (domain capture)**. When enabled, teammates with an email address on your verified domains cannot create separate Ando workspaces and are directed to your SSO link instead. Active owners of the capturing workspace remain allowed to create approved workspaces.

## Set up SCIM 2.0 user and group sync

SCIM 2.0 keeps workspace membership, roles, channels, and `@groups` in sync with your identity provider.

1. Under **Member sign-in**, click **SCIM directory sync**.
2. Choose your directory provider (Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, Rippling, or generic SCIM 2.0) and copy the SCIM endpoint URL and bearer token into your provider.
3. Assign people or groups to the Ando app in your identity provider.

What SCIM syncs automatically:

* **Provisioning**: Existing Ando users are added to the workspace immediately. People without an Ando account yet receive a pending grant and join automatically on their first SSO sign-in.
* **Deprovisioning**: Removing or suspending a user in your directory archives their workspace membership and revokes their active SSO sessions for that organization. The workspace's Primary Owner is protected from accidental SCIM removal.
* **Reactivation**: Re-activating the same directory user restores their archived membership. Reassigning a departed employee's email address to a new directory user never restores the departed employee's account.
* **Group mappings**: Synced SCIM directory groups appear under **Directory groups** in **Settings → General → Member sign-in**. Click **Configure** on any synced group to map its members automatically to:
  * **Workspace admin role** (never modifies owners or guests; preserves admin if the member still belongs to another admin-granting group).
  * **Channels** (up to 20 active channels per group).
  * **Custom `@group`** (link an existing `@group` or create a synced `@group` automatically).
  * Group rules also apply automatically when pre-provisioned new hires complete their first SSO sign-in.

## Sign-in, session, and logout policies

Under **Settings → General → Member sign-in**, workspace owners can configure:

* **Sign-in method**:
  * **Any sign-in method**: emailed codes, Google, Apple, or SSO.
  * **SSO, Google, Apple, or two-step verification**: blocks bare emailed sign-in codes unless the member confirms a passkey, authenticator app, or SMS second step.
  * **SSO only**: requires sign-in through your workspace's bound SSO connection. Blocked members see a one-click **Sign in with SSO** button. If an enforced SSO connection is deactivated or deleted, Ando surfaces a degraded-connection alert directly in **Member sign-in** and records an alert in **Settings → Activity**.
* **External guests**: choose whether guests follow the same rule as members (**Same as members** — the default), require **SSO, Google, Apple, or two-step verification**, or are **Exempt from sign-in requirement**.
* **Session re-authentication**: optionally require members to sign in again every **12 hours**, **24 hours**, **7 days**, **14 days**, or **30 days**. Timers measure from the original sign-in, so refreshing tokens or opening new tabs does not extend the window.
* **Single logout propagation**: signing out of an Ando browser session revokes the Ando session family immediately and propagates revocation to the upstream WorkOS session.

### Advanced SSO options

Expand **Advanced SSO options** under **Member sign-in** for opt-in controls:

* **Allow owner break-glass recovery**: lets workspace owners who already have an active second factor (passkey, authenticator app, or SMS) enter an **SSO only** workspace if your identity provider is down. Bare emailed codes never qualify.
* **Allow IdP-initiated sign-in**: lets members launch Ando directly from an Okta chiclet, Microsoft Entra My Apps tile, or another identity provider dashboard. Off by default and scoped to your workspace's bound organization.
* **Auto-provision members on first SSO sign-in (SAML JIT)**: adds new employees to the workspace automatically on their first verified SSO sign-in without SCIM or a manual invite. Off by default; never revives archived or removed members.
* **Block new workspaces on verified domains (domain capture)**: prevents teammates on your verified company domains from creating separate workspaces outside your SSO organization.

## Audit trail

Every SSO organization link, sign-in policy change, SSO connection status or outage alert, domain capture block, SCIM directory status change, SCIM member provision/deprovision/reactivation, SAML JIT provision, and SCIM group sync or mapping change is logged in **Settings → Activity** under **Governance** and **Members**, and included in **Download CSV** exports.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.