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

# SSO Configuration

> Configure Single Sign-On (SSO) for your tenant

Configure and manage SSO providers for your tenant.

## List SSO Providers

<RequestExample>
  ```bash theme={null}
  curl -X GET https://cp.gosentrix.io/api/v1/sso \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Create SSO Provider

<RequestExample>
  ```bash theme={null}
  curl -X POST https://cp.gosentrix.io/api/v1/sso \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "provider_type": "saml",
      "name": "Corporate SSO",
      "metadata_url": "https://idp.example.com/metadata"
    }'
  ```
</RequestExample>

## Update SSO Provider

<RequestExample>
  ```bash theme={null}
  curl -X PATCH https://cp.gosentrix.io/api/v1/sso/{provider_id} \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "enabled": true
    }'
  ```
</RequestExample>

## Supported Providers

* **SAML 2.0**: Enterprise SSO standard
* **OIDC**: OpenID Connect
* **Google Workspace**: Google SSO
* **Microsoft Azure AD**: Azure AD SSO

## Notes

* Requires tenant admin role
* Disabling SSO requires step-up authentication
* See [SSO Guide](/guides/sso) for detailed setup instructions