AdminIdentity Providers

You are viewing the docs for Archestra v1.4. View the latest docs

Identity Providers

Connect your identity provider (IdP) to sign users in with their work accounts and run MCP tools with each user's own downstream permissions.

Archestra uses your IdP for two jobs:

  • Single Sign-On (SSO): Users sign in with their existing credentials. At each sign-in, claim rules map directory groups to Archestra roles and teams. See Single Sign-On.
  • Token exchange for tools: When an agent calls an MCP tool, Archestra exchanges the caller's IdP token for a downstream API token. The tool acts as that specific user instead of a shared service account. See Microsoft Entra ID or Okta.

Identity providers are an enterprise feature. See Pricing Model.

The Identity Providers settings page with a card for each supported provider

Supported Providers

ProviderProtocolDownstream Token ExchangeSetup Guide
Microsoft Entra IDOIDCOn-Behalf-Of (OBO) flowMicrosoft Entra ID
OktaOIDCToken exchange (private_key_jwt)Okta
Google, GitHub, GitLabOIDCRequires RFC 8693 endpointSingle Sign-On
Generic OIDC (Keycloak, Auth0)OIDCRFC 8693 token exchangeSingle Sign-On
Generic SAMLSAML 2.0Not supportedSingle Sign-On

Adding a Provider

Configuring an identity provider requires the identityProvider:create permission and admin access in your IdP.

  1. In your IdP, register Archestra as a web application with the callback URL matching your protocol:
ProtocolCallback URL
OIDChttps://<archestra-domain>/api/auth/sso/callback/<ProviderId>
SAML (ACS URL)https://<archestra-domain>/api/auth/sso/saml2/sp/acs/<ProviderId>

The <ProviderId> segment is case-sensitive: Okta, EntraID, Google, GitHub, or GitLab. For generic providers, use the exact Provider ID entered in Archestra.

  1. In Archestra, go to Settings → Identity Providers and click Enable on your provider card.
  2. Enter the Issuer, Client ID, and Client Secret (or SAML metadata).
  3. Configure optional Allowed Email Domains, Role Mapping, or Team Sync.
  4. Click Create Provider.

Test sign-in in an incognito window. To manage email and password account policies, see Account Security.

Explore