> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paylead.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up SSO for Shift

> Program × Developer: connect Shift to your identity provider with OpenID Connect, so your teammates sign in with their bank account and get their Shift roles from it.

[Shift](https://docs.paylead.fr/glossary.md#shift) signs your teammates in through your bank's identity provider (IdP) with OpenID Connect, and reads their identity and roles from it at each sign-in. For what your teammates see once SSO is on, see [Shift with SSO](https://docs.paylead.fr/program/shift/access-and-roles.md#shift-with-sso).

## What Shift expects from your IdP

### Claims

Shift reads these claims from the identity of each user.

| Claim | Description |
| - | - |
| `sub` | Stable technical identifier of the user. Shift matches a user to their Shift account on this claim, so it must never change and never be reused for someone else. |
| `email` | Email address of the user. |
| `given_name` | First name of the user. |
| `family_name` | Last name of the user. |
| Roles claim | Custom claim that lists the Shift roles of the user. You choose its name and tell Paylead which one it is. |

### Role values

The roles claim carries one or more of the following values. Each one grants the Shift role of the same row.

| Claim value | Shift role |
| - | - |
| `ADMIN` | **Administration** |
| `FINANCE` | **Financial** |
| `GIFT` | **Gifts** |
| `OFFER` | **Offers** |
| `REPORTING` | **Reporting** |
| `SUPPORT` | **Consumer support** |
| `TECHNICAL` | **Technical** |

Roles do not nest: see [Roles](https://docs.paylead.fr/program/shift/access-and-roles.md#roles) for the sections each one opens before you decide which values each user gets. You assign them in your IdP.

## Send Paylead your IdP details

Send the following for each environment, Sandbox and Production.

| Item | Description |
| - | - |
| Discovery URL | The `.well-known/openid-configuration` URL of your IdP. If you have none, send the issuer and the `/authorize` and `/token` endpoints instead. |
| `client_id` | Identifier of the client you registered for Shift. |
| `client_secret` | Secret of that client. Share it through the secure channel agreed with your Paylead contact, never by plain email. |
| `auth_mode` | How Shift authenticates against your token endpoint: `client_secret_basic` or `client_secret_post`. |
| Roles claim name | Name of the custom claim that carries the role values. |
| Logout URI | Optional. Where your IdP ends the session of a user. |

## What Paylead provides

Paylead returns a dedicated Shift URL for each environment of your Program. It replaces the standard sign-in URL.

## Set up SSO

**1. Register a client in your IdP**

Create a dedicated client for Shift in each environment, with its own `client_id` and `client_secret`. Do not reuse the client of the Paylead WebApp: it must not send `profile` or `email` claims, which Shift needs. Use the Authorization Code flow, and note the `client_id`, `client_secret` and authentication mode.

**2. Expose the claims**

Make every claim listed in [Claims](#claims) available in the identity of each user, with the values from [Role values](#role-values).

**3. Send the details to Paylead**

Send the items listed in [Send Paylead your IdP details](#send-paylead-your-idp-details), once for Sandbox and once for Production.

**4. Test in Sandbox**

Open the Sandbox Shift URL Paylead returned and [sign in with SSO](https://docs.paylead.fr/program/shift/access-and-roles.md#sign-in-with-sso).

**5. Repeat in Production**

Run the same sign-in against the Production Shift URL once Sandbox works.

> [!TIP]
>
> Shift opens with the sections granted by the role values your IdP sent.

## What's next

> [card] [See what your teammates get with SSO](https://docs.paylead.fr/program/shift/access-and-roles.md#shift-with-sso)
>
> The controls Shift hides once your IdP owns accounts.

> [card] [Choose the roles for a teammate](https://docs.paylead.fr/program/shift/access-and-roles.md#choose-the-roles-for-a-new-teammate)
>
> Match each job to the role values your IdP sends.
