Self-Service Single Sign-On

Self-Service Single Sign-On (SSO) provides business-to-business customers with the tools needed to delegate SSO setup to their enterprise customers. By delegating this task, you can streamline your onboarding process and grant customers more autonomy over their sign-on experience. You can also reduce the time and costs associated with managing SSO across your customer base. 

Self-Service SSO requires minimal configuration in your Auth0 tenant and provides your customers with a setup assistant that guides them through the enablement process. After a customer completes their setup, the SSO integration is automatically added to your tenant as an Enterprise connection.

Supported Providers

During the Early Access period, Self-Service SSO supports the following identity providers:

• Okta Workforce Identity Cloud (using OIDC)

• Entra ID

• Google Workspace (using OIDC)

• Microsoft Active Directory Federation Services (ADFS)

• Generic OIDC

• Generic SAML

Self-Service SSO uses the following components to delegate setup to your customers:

• Self-service profile: Defines the user attributes (e.g., email) your customers must capture through SSO and provides branding for the SSO setup assistant. You can create multiple profiles as needed to accommodate different customers or segments.

• Self-service access ticket: Specifies key details for the SSO integration and grants customer admins access to the SSO setup assistant.

• SSO setup assistant: Guides customer admins through the SSO setup process.

At a high level, the Self-Service SSO workflow includes the following tasks: 

1. You (the Auth0 customer) create a self-service profile in your tenant using the Auth0 Dashboard or the Management API. 

2. Using the Management API, you next create a self-service access ticket that allows customer admins to configure SSO. 

3. You retrieve the ticket URL from the asset created in Step 2 and send this link to your customer admin.

4. Your customer admin launches the SSO setup assistant and follows the steps provided to create an application with their identity provider. 

5. A new Enterprise connection pointing to the customer’s application is added to your Auth0 tenant.

Select the diagram for an expanded view.

The sections below provide expanded steps for configuring a self-service profile in your tenant and creating self-service access tickets to share with customer admins.

You can create a self-service profile using the Auth0 Dashboard or the Management API.

{
  "name": "Example Profile",
  "description": "An example profile for all customers",
  "user_attributes": [
    {
      "name": "email",
      "description": "User's email",
      "is_optional": false,
    }
  ],
  "branding": {
     "logo_url": "https://example.com/logo.png",
     "colors": {
       "primary": "#334455"
     }
  }
}

After creating your self-service profile, you can create a self-service access ticket using the Management API. This ticket provides a customer admin with access to the SSO setup assistant.

1. Retrieve the ID of the self-service profile you created for your tenant using the Retrieve Self-Service Profiles endpoint.

2. Call the SSO Access Ticket endpoint using the ID of the self-service profile you previously created in your tenant:

POST  /api/v2/self-service-profiles/{id}/sso-ticket

In the request body, specify the following parameters:

Example Request Body

{
  "connection_id": "con_PzXxgqxYD1QryUT2",
  "connection_config": {
    "name": "sso-generated-SAML-customer-12"
  },
  "enabled_clients": [
    "NaByIDEzMQErqouDb9DWGZSOlqhR8JgO",
    "SFwh3of2k09hfywg7lfBTEnEPqZPm0S3
  ],
  "enabled_organizations": [
    {
      "organization_id": "org_mrW0HjyX5kAfccO6"
    },
    {
      "organization_id": "org_C5NbiK4QBbNc15Yu"
    }
  ]
}

In response, you receive a URL to the self-service access ticket:

{
  "ticket": "https://{domain}/self-service/connections-flow?ticket={id}"
}

Share this URL with your customer admin to grant them access to the SSO setup assistant. The assistant will then guide them through each step of the SSO setup process.

You can choose to wrap ticket generation in your own self-service portal or send access ticket links to customer admins through email, chat, or another communication channel.

To manage Self-Service SSO, the following Management API endpoints are available:

• Retrieve self-service profiles

• Create a self-service profile

• Retrieve a self-service profile by ID

• Delete a self-service profile by ID

• Update a self-service profile

• Create an SSO-access ticket to initiate the self-service SSO flow

When using Self-Service SSO, the following rate limits apply: