AI & Agents

How to Set Up SSO for Claude: Okta, Google Workspace, Entra ID, and OneLogin

Claude supports SAML-based single sign-on on Team, Enterprise, and Console plans through Okta, Google Workspace, Microsoft Entra ID, and OneLogin. This guide walks through each identity provider setup from domain verification to SCIM provisioning, so your IT team can bring Claude under the same identity governance as every other SaaS tool in the stack.

Fast.io Editorial Team 13 min read
Organization hierarchy diagram showing parent organization and linked workspaces

Why Claude SSO Matters for Enterprise Identity Governance

The enterprise single sign-on market hit $5.48 billion in 2026, growing at 12.2% annually as organizations work to bring every SaaS tool under centralized identity governance. AI platforms are the newest category on that list. Claude now supports SAML-based SSO natively, which means employees authenticate with the same credentials they use for email, project management, and every other tool in the stack.

Claude SSO is available on three plan types: Team, Enterprise, and Console (the API platform). Once configured, users sign in through your identity provider instead of using email-based magic links. IT gets full control over who can access Claude and when access gets revoked.

The supported identity providers are Okta, Google Workspace, Microsoft Entra ID (formerly Azure AD), OneLogin, JumpCloud, and Duo. Anthropic handles the SAML integration through WorkOS, so the setup flow for every IdP follows the same pattern: verify your domain, create a SAML application in your IdP, exchange metadata with the WorkOS setup wizard, then enable SSO enforcement.

This guide covers the four most commonly deployed IdPs: Okta, Google Workspace, Entra ID, and OneLogin. Each walkthrough includes the exact configuration values and attribute mappings you need.

Prerequisites: Domain Verification and Parent Organizations

Before you touch your identity provider, two things need to happen in Claude's admin console: domain verification and parent organization setup. Skipping either one will block the SSO configuration flow entirely.

Domain verification requires adding a DNS TXT record to prove you own the email domain your employees use. Log into your Claude admin settings at claude.ai/admin-settings/identity for Team and Enterprise plans, or platform.claude.com/settings/identity for Console. Start the verification flow and the system will give you a TXT record value to add to your domain's DNS. Once the record propagates and Claude confirms it, your domain is locked to your parent organization. No other Claude organization can claim that domain after verification completes.

All verified domains must be managed through a single identity provider. If your company uses multiple email domains (like acme.com and acme.io), both need to be verified and both will use the same IdP.

Parent organizations are the container that holds your SSO configuration. Enterprise plans create one automatically. Team plans generate a parent organization when you first enable SSO. Console organizations need manual setup or an invitation to join an existing parent organization. The key constraint is that each parent organization links to exactly one identity provider. If you have multiple Claude organizations, say a Team plan for marketing and a Console org for engineering, they can share SSO settings by joining the same parent org, but they all must use the same IdP.

Before flipping the switch, communicate the timeline to your employees. Users with existing Free, Pro, or Max accounts on your verified domain will lose access to those personal accounts once you enable the "Require SSO for Claude" toggle. Their conversations are not deleted, but they cannot log in without going through your IdP. Give people a window to export any conversation history they want to keep. Schedule the cutover during a low-disruption period and make sure your IT team is ready to support questions on login day.

Audit log interface showing identity and access events

Identity Provider Setup Walkthroughs

Every IdP setup follows the same core pattern: create a SAML application, enter the ACS URL and Entity ID from the WorkOS setup flow, map the email attribute, download the IdP metadata, and upload it back to WorkOS. The specifics vary by provider.

All configuration values, including the ACS URL, Entity ID, and SCIM credentials, come from the WorkOS setup wizard inside your Claude admin settings. Keep that page open in a separate tab while you work through your IdP configuration.

One constraint worth noting early: you cannot mix identity providers within a single parent organization. If your engineering team uses Okta and your marketing team uses Google Workspace, you need to standardize on one before starting the SAML setup. Organizations that tried to run parallel IdPs and merge later reported spending more time on migration cleanup than on the original SSO rollout.

Okta SAML Setup

In the Okta Admin console, go to Applications, then Applications, then Create App Integration. Select SAML 2.0 as the sign-on method and name the application "Claude."

In the Configure SAML tab, enter these values from your WorkOS setup flow:

  • Single sign-on URL: paste the ACS URL from WorkOS
  • Audience URI (SP Entity ID): paste the Entity ID from WorkOS
  • Name ID format: EmailAddress
  • Application username: Email

Under Attribute Statements, add one entry: set the name to "email" and the value to "user.email." This tells Okta which field to send as the user's identity claim.

Download the Identity Provider metadata XML from Okta and upload it in the WorkOS setup flow when prompted.

For SCIM provisioning (Enterprise and eligible Console plans only), open the Provisioning tab, select Configure API Integration, and enable it. Enter the SCIM Base URL and API Token from WorkOS, then test the connection. Under "To App," enable Create Users, Update User Attributes, and Deactivate Users. Confirm that the email attribute maps to user.email in the attribute mappings.

The most common Okta issue is an email mismatch between SAML and SCIM. Both must use the same Okta field for email. If SAML sends user.email but SCIM sends user.login, users will be provisioned but unable to authenticate.

Finally, go to the Assignments tab and assign the users or groups that need Claude access.

Google Workspace SAML Setup

In the Google Admin console, navigate to Apps, then Web and mobile apps, then Add app, then Add custom SAML app. Name it "Claude" and download the IdP metadata XML file. You will upload this to WorkOS later.

On the Service Provider Details screen, enter:

  • ACS URL: from the WorkOS setup flow
  • Entity ID: from the WorkOS setup flow
  • Name ID format: EMAIL
  • Name ID: Basic Information, Primary email

For attribute mapping, map Google Directory's "Primary email" to the app attribute "email."

If you are on an Enterprise or eligible Console plan and want SCIM auto-provisioning, open the app's Auto-provisioning section. Enter the Endpoint URL and Access token from WorkOS, map primaryEmail to Claude's email field, then enable and save.

Under User access, turn on the application for the relevant organizational units or groups in your Google Workspace.

One critical detail for Google Workspace: both SAML and SCIM must use primaryEmail. If an employee has email aliases, their primary Google email must match what SCIM sends. Aliases will not work for authentication.

Microsoft Entra ID SAML Setup

Entra ID (formerly Azure AD) requires a P1 or P2 license for SCIM provisioning. You also need the Global Administrator or Application Administrator role in Entra.

In the Entra Admin Center, go to Enterprise applications, then New application. Search the gallery for "Claude" or select "Create your own application" and choose "Integrate any other application you don't find in the gallery." Name it "Claude."

Open Single sign-on, then select SAML. In the Basic SAML Configuration section, enter:

  • Identifier (Entity ID): from the WorkOS setup flow
  • Reply URL (ACS URL): from the WorkOS setup flow
  • Sign-on URL: https://claude.ai/login

Under Attributes and Claims, configure it to send the user's email via the user.mail attribute. Download the Federation Metadata XML and upload it to WorkOS.

For SCIM provisioning, go to Provisioning, then Get Started. Set Provisioning Mode to Automatic, enter the Tenant URL and Secret Token from WorkOS, and click Test Connection. Verify that the email attribute mapping matches the SSO email claim exactly, then enable the provisioning status.

Assign users and groups in the Users and groups section. After the initial provisioning cycle completes, test with a designated user account to confirm authentication works.

The attribute used for SCIM email and SSO email must be identical. If SAML sends user.mail but SCIM maps to user.userprincipalname, users will be provisioned but authentication will fail.

OneLogin SAML Setup

In the OneLogin Admin portal, go to Applications, then Add App. Search for "SAML Custom Connector (Advanced)" and name the application "Claude."

In the Configuration tab, enter:

  • Audience (EntityID): from the WorkOS setup flow
  • ACS (Consumer) URL: from the WorkOS setup flow
  • ACS URL Validator: from the WorkOS setup flow
  • SAML initiator: Service Provider
  • SAML nameID format: Email

In the SSO tab, download the Issuer URL metadata and upload it to WorkOS.

For attribute mapping, go to the Parameters tab and create a field with the name "email" and the value set to OneLogin's Email field.

For SCIM provisioning (Enterprise and eligible Console plans), enable provisioning in the Provisioning tab. Enter the SCIM Base URL and Bearer Token from WorkOS, then enable Create user, Delete user, and Update user operations. Map the email attribute to the same OneLogin field you used for SAML.

As with every other IdP in this guide, SAML and SCIM must send the same email value. Assign users or configure assignment rules in the Users tab, then check provisioning logs and test with a real user account.

Fastio features

Centralize your team's AI file outputs after SSO

Once your team authenticates through SSO, give them a shared workspace for everything Claude produces. 50GB free storage, no credit card, with built-in AI search and audit trails.

How to Choose the Right Provisioning Method

After SSO is active, you need to decide how user accounts get created in Claude. There are three options, and the right choice depends on your plan tier and how tightly you want to control access.

Invite-only is the most restrictive approach. An admin manually invites each user by email. The user still authenticates through SSO, but no account gets created until an admin sends the invitation. This works well for small teams or organizations that want to approve every seat individually. It is available on all plan types: Team, Enterprise, and Console.

Just-in-time (JIT) provisioning creates a Claude account automatically the first time someone authenticates through your IdP. If an employee with an email under your verified domain logs in via SSO and does not already have a Claude seat, JIT provisions one on the spot. This reduces admin overhead but means anyone in your IdP who can access the Claude SAML app will get a seat. JIT is also available on all plan types.

SCIM provisioning is the full lifecycle option. Your identity provider pushes user creation, updates, and deprovisioning events to Claude automatically. When you disable someone in Okta or Entra ID, their Claude access gets revoked without any manual intervention. SCIM is only available on Enterprise plans and eligible Console organizations. Team plans and Console orgs merged with Team plans cannot use SCIM.

For organizations above 50 users, SCIM is usually the right answer. It keeps Claude in sync with your identity provider and eliminates the need for ongoing manual seat management. For smaller teams, JIT provisioning with periodic access audits is typically sufficient.

If your team also uses workspace tools like Google Drive, Dropbox, or Fast.io for managing files that Claude agents produce, aligning your provisioning method across tools simplifies onboarding. When a new hire appears in your IdP, they get access to both the AI tools and the workspaces where those tools store their output.

How to Test and Troubleshoot Your SSO Configuration

Before you enforce SSO for your entire organization, test it with a single user account. Have someone who is assigned to the Claude app in your IdP navigate to claude.ai, enter their email, and confirm they get redirected to your identity provider's login page. After authenticating, they should land in your Claude organization's workspace.

If login fails, the most common cause is an email attribute mismatch. Install a SAML debugging browser extension like SAML-tracer and inspect the SAML response. Check the NameID and email claim values. They must contain an email address under your verified domain. Claude rejects email claims for unverified domains.

When both SAML and SCIM are configured, verify that both send the same email value. This is the single most frequent cause of "user is provisioned but can't log in" tickets. The correct field mappings by provider:

  • Okta: both SAML and SCIM should map to user.email
  • Google Workspace: both should use primaryEmail
  • Microsoft Entra ID: both should use user.mail
  • OneLogin: both should point to the same Email field

Certificate rotation is a maintenance task you need to plan for. The X.509 signing certificates that your IdP uses to sign SAML assertions have expiration dates. When a certificate expires, SSO breaks for everyone. Set a calendar reminder for 30 days before expiration, then update the certificate in the Metadata configuration section of your Claude identity settings.

After testing succeeds, enable the "Require SSO" toggle in your Claude admin settings. This disables email-based login for all users in your organization. The Primary Owner retains magic link access temporarily during initial setup, but you should migrate them to SSO as well. Test thoroughly before enforcing. A misconfigured SSO requirement with no fallback can lock your Primary Owner out of the admin console.

For organizations using Claude alongside persistent workspace tools, the SSO rollout is also a good time to standardize how your team stores and shares Claude's file outputs. Tools like Google Drive, S3, or Fast.io workspaces can serve as the collaboration layer where authenticated team members access what Claude produces. Fast.io's audit trail and granular permissions complement the identity governance SSO provides.

Dashboard showing audit trail and document review interface

Frequently Asked Questions

Does Claude support SSO?

Claude supports SAML-based single sign-on on Team, Enterprise, and Console plans. Supported identity providers include Okta, Google Workspace, Microsoft Entra ID, OneLogin, JumpCloud, and Duo. SSO is configured through Anthropic's WorkOS integration in the Claude admin settings.

How do I set up SSO for Claude?

Verify your email domain in Claude's admin settings (claude.ai/admin-settings/identity for Team and Enterprise, or platform.claude.com/settings/identity for Console). Then create a SAML application in your identity provider, enter the ACS URL and Entity ID from the WorkOS setup flow, map the email attribute, download your IdP metadata, and upload it to WorkOS. Enable SSO enforcement once testing passes.

What identity providers does Claude support for SSO?

Claude supports Okta, Google Workspace, Microsoft Entra ID (formerly Azure AD), OneLogin, JumpCloud, and Duo for SAML-based SSO. The setup process uses WorkOS as the integration layer, so the configuration flow is similar across all providers.

Is SSO available on Claude Team plans?

SSO is available on Team, Enterprise, and Console plans. The main difference is that SCIM provisioning (automated user lifecycle management) is only available on Enterprise and eligible Console plans. Team plans support SSO with invite-only or JIT provisioning.

Can I use multiple identity providers with Claude?

Each Claude parent organization links to exactly one identity provider. If you have multiple Claude organizations (a Team plan and a Console org, for example), they can share the same SSO configuration by joining the same parent organization, but all linked organizations must use the same IdP.

What happens to existing Claude accounts when I enable SSO?

Users with existing Free, Pro, or Max accounts on your verified domain lose access to those personal accounts when you enable the Require SSO toggle. Their conversation history is preserved but becomes inaccessible without email login. Advise affected employees to export conversations before the cutover and schedule the transition during a low-disruption period.

Does Claude support SCIM provisioning?

SCIM is available on Enterprise plans and eligible Console organizations. It automates user creation, updates, and deprovisioning from your identity provider. Team plans and Console organizations merged with Team plans cannot use SCIM and should use invite-only or JIT provisioning instead.

Related Resources

Fastio features

Centralize your team's AI file outputs after SSO

Once your team authenticates through SSO, give them a shared workspace for everything Claude produces. 50GB free storage, no credit card, with built-in AI search and audit trails.