This guide is for customers who want to use SAML instead of the native Microsoft Entra ID (OIDC) or Okta (OIDC) integrations. We generally recommend using the native OIDC integration when possible, but there are certain situations in which SAML SSO is preferred instead.
What You’ll Need
The following information is required to set up SAML SSO for Devin. You will collect these during the setup steps below and use them to add the connection in Step 4.- Sign In URL - Your IdP’s SAML SSO endpoint (e.g.,
https://idp.example.com/sso/saml) - X509 Signing Certificate - The public certificate your IdP uses to sign SAML assertions
- Identity Provider Domains - All company email domains that will authenticate through this IdP (e.g.,
example.com,subsidiary.example.com)
Setup Instructions
Step 1: Create a SAML Application in Your IdP
In your identity provider’s admin console, create a new SAML 2.0 application with the following settings:Step 2: Configure SAML Attributes
Ensure your IdP sends the following attributes in the SAML assertion:Devin uses the
nameidentifier attribute to identify users. Most IdPs populate this automatically from the SAML Name ID value. If your IdP does not send nameidentifier as a separate attribute, ensure the Name ID Value in Step 1 is set to the user’s email address.Step 3: Configure Group Assertions (Required for IdP Groups)
To enable IdP group syncing, configure a group attribute in your SAML application:Devin reads group memberships from these SAML attribute names, so use one of them:
http://schemas.xmlsoap.org/claims/Grouphttp://schemas.microsoft.com/ws/2008/06/identity/claims/groupsgroupsmemberOf
Microsoft Entra ID with SAML
If you are using Microsoft Entra ID with SAML instead of the native OIDC integration:- In the Azure portal, go to Enterprise Applications > your SAML app > Single sign-on
- Under Attributes & Claims, click Add a group claim
- Select Groups assigned to the application (recommended) or All groups
- Set the Source attribute to a value appropriate for your setup (e.g.,
sAMAccountNameorDisplay name) - Keep the Claim name that Azure generates (
http://schemas.microsoft.com/ws/2008/06/identity/claims/groups)
Other SAML Identity Providers
For other IdPs (ADFS, Ping Identity, OneLogin, etc.):- Add a group attribute statement to your SAML application configuration
- Configure it to send the user’s group memberships
- Name the attribute using one of the names listed above
Step 4: Add the Connection
Collect the following information to add the connection:- Sign-in URL (e.g.,
https://idp.example.com/sso/saml) - Signing certificate (PEM) (the PEM-encoded public certificate)
- Email domains (all email domains for this IdP)
Step 5: Complete Configuration
The connection name (sso-...) is shown on its row under SSO connections. Download the metadata from the URL below: it contains the Entity ID (entityID). Set your SAML application’s Entity ID / Audience URI to that value.
Devin sends signed SAML authentication requests. Your SAML metadata file is available at:Import this metadata into your IdP to complete the trust configuration and enable request signature verification.
Verifying Your Setup
After you have updated the Entity ID:- Navigate to your Devin Enterprise URL (e.g.,
https://<your_subdomain>.devinenterprise.com) - Click Sign in with SAML (or the equivalent SSO button) to initiate the login flow
- You should be redirected to your IdP’s login page
- After authenticating, you should land in your Devin Enterprise organization
- Go to Settings > Membership in the Devin webapp and select the Groups (IdP) tab
- You should see your IdP groups listed after at least one group member has logged in
- Groups are synced on each login, so any membership changes in your IdP will take effect the next time a user signs in
IdP groups are fetched upon user login, so changes in group membership will require reauthentication. See IdP Group Integration for more details on configuring group-based access control.

