---
title: "Set up single sign-on"
description: "Connect your identity provider over OpenID Connect so your team signs in to Gleap with the accounts IT already manages. Enterprise plan."
url: https://help.gleap.ai/en/articles/371-set-up-single-sign-on
collection: "Security and account access"
updated: 2026-11-16
language: en
---

# Set up single sign-on

Connect your identity provider over OpenID Connect so your team signs in to Gleap with the accounts IT already manages. Enterprise plan.

With single sign-on (SSO), your team signs in through your own identity provider. Access follows the accounts your IT team already manages. With **Require SSO** switched on, people with your allowed email domains can only sign in through SSO, so somebody you remove from your identity provider can no longer sign in to Gleap. SSO is part of the Enterprise plan; on other plans the SSO page shows an upgrade card. Only organisation administrators can set it up.

> **Info:** Gleap's SSO is OpenID Connect (OIDC). Google Workspace, Azure AD, Okta and nearly every other identity provider support it. There is no SAML.

### Before you start

In your identity provider, create an OIDC application and keep its **Issuer URL**, **Client ID** and **Client secret** to hand. You'll register Gleap's redirect URI there in step 2. If your organisation isn't on Enterprise, **SSO configuration** shows an **Enterprise** badge and **Contact sales** instead of the form.

![Single sign-on setup entry in project Security settings in the Pied Piper demo project.](https://staticfiles.gleap.io/p613b5dd730aed737108f87ab/bP6KUHGOCt7wWTywiGbP7juVVn2RewHIuIeQlnfC7ooWBcq1Yol1nX0LR9kJweuFVzHZLyBcgJw.png)

### Set it up

1.  Open your profile menu (your avatar), choose **Organizations**, then **SSO configuration**.
    
2.  Copy the **Redirect URI** under **Provider** and register it in your identity provider's OIDC application exactly as shown. A mismatch here is the most common reason a first attempt fails, and providers reject it rather than explaining.
    
3.  Pick a **Provider template**: Google Workspace, Azure AD, Okta or Custom. It fills in the issuer URL for the common providers.
    
4.  Enter the **Issuer URL**, the **Client ID** and the **Client secret**.
    
5.  Check the **Scope**. `openid email profile` covers it; without `email`, Gleap can't tell who is signing in.
    
6.  Under **Access**, add your **Allowed email domains**. Leave it empty and any domain your provider authenticates is accepted, so set it to your own domains unless you have a reason not to.
    
7.  Pick the **Default role**: the role every new person signing in through SSO gets.
    
8.  Turn on **Enable SSO**.
    

Changes save as you go. Once SSO is on, the page shows the **SSO login URL**. That's the link to give your team, or to put behind your provider's app launcher: people arrive already authenticated, without going through the normal login screen.

> **Warning:** The default role applies to every new person automatically. Setting it to Administrator makes everyone who can authenticate an administrator. Pick the lowest role that lets people do their job, and promote individuals afterwards.

### Organisation or project SSO

The page above signs people into your whole organisation. A project can also have its own SSO under **Settings → Security → SSO**, with the same fields, a project role as the default and its own login URL. Use it when one project, and only that project, should be reached through a particular identity provider.

### Test it with a second account

Before you tell the team, sign in through the SSO login URL as somebody who isn't you, ideally in a private window. That's what confirms the redirect URI, the allowed domains and the default role are right. Testing with your own already-signed-in session proves nothing.

### When it doesn't work

Most failures are one of three things: the redirect URI doesn't match, the scope is missing `email`, or the person's address is on a domain you didn't allow. A person who would need a new seat when none is free is refused too.

The error your provider shows is usually more specific than the one Gleap can display, so read that first.

### Related

-   [Sign in to Gleap](https://help.gleap.ai/en/articles/370-sign-in-to-gleap.md)
    
-   [Roles and permissions](https://help.gleap.ai/en/articles/372-roles-and-permissions.md)
    
-   [Plans, seats and AI credits](https://help.gleap.ai/en/articles/377-plans-seats-and-ai-credits.md)
