---
title: Conecta un proveedor de OpenID Connect
description: Conecta Keycloak, Microsoft Entra ID, Auth0, Ping Identity u otro proveedor de OpenID Connect, define el claim de grupos y mapea los grupos a roles de Pyn.
sidebar:
  order: 2
area: integrations
feature: sso
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations/sso
  - integrations/sso/connect-okta
  - settings/users
intercom:
  - id: "16838066"
    title: Enabling Single Sign On (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16838066-enabling-single-sign-on-pyn-2
    note: replaces
translation:
  source: integrations/sso/connect-an-oidc-provider.mdx
  sourceSha: 6c4fc9c14619f4daa3b2e06d83cb418cd8d3b119
---

Tu proveedor de identidad habla OpenID Connect y quieres que dé acceso a Pyn a tu gente y decida sus roles. La integración Single Sign-On toma el proveedor, su issuer y un cliente con el flujo de código de autorización, comprueba la configuración OpenID del proveedor y muestra la URI de redirección y el enlace de inicio de sesión que necesitas.

## Antes de empezar

- Eres administrador o propietario en Pyn, y la integración Single Sign-On está habilitada para tu workspace.
- Alguien puede crear un cliente confidencial en tu proveedor: "The client needs the standard authorization code flow and a client secret." Pyn solicita los alcances `openid`, `profile` y `email`; para el mapeo de roles, el ID token necesita un claim `groups` (Entra emite `roles`), y cualquier alcance que lo desbloquee va en **Additional Scopes**.
- Tienes el issuer, el client ID y el client secret. Para Keycloak necesitas la **Keycloak Server URL** y el **Realm**; Pyn compone el issuer a partir de ellos.

![Connect single sign-on: choose the Provider, then enter the issuer, client ID, client secret and groups claim.](https://support.pyn.ai/media/integrations/sso/integrations-sso-connect.png)

## Pasos

1. En Pyn, abre **Settings** en la navegación izquierda y después **Available** bajo **Integrations**.

2. Selecciona el mosaico **Single Sign-On**. Se abre el diálogo **Connect single sign-on**.

3. Elige el **Provider**: **Keycloak**, **Okta**, **Microsoft Entra ID**, **Auth0**, **Ping Identity** o **Single Sign-On** para cualquier otro.

4. Para Keycloak introduce la **Keycloak Server URL** y el **Realm**; para los demás introduce la **Issuer URL**.

5. Introduce el **Client ID** y el **Client Secret**. Define **Groups Claim** si tu proveedor usa un nombre distinto de `groups`, y **Additional Scopes** si necesita más que `openid profile email`.

6. Copia la **Redirect URI** que muestra el diálogo: "Add this as a valid redirect URI on the client in your provider, then come back and connect."

7. Selecciona **Connect**. El diálogo muestra "Checking those details with your provider..." y después un aviso: "Single sign-on is configured. Use the sign-in link on the integration to let your people sign in with it."

8. En el panel, bajo **Group mappings**, introduce nombres de grupo separados por comas para **Owner groups**, **Admin groups**, **Power user groups** y **User groups**, empezando por los propietarios.

> **Caution:** En cuanto se define cualquier mapeo de grupos, el proveedor decide los roles en cada inicio de sesión y quien no coincide con ningún grupo pasa a ser User. Mapea primero a tus propietarios.

## Qué deberías ver

El mosaico muestra **Active** bajo **Installed** y el panel muestra la **Redirect URI** y el **Sign-in link**: "Share this with your people to sign in through your provider. Opening it signs you in." Si el diálogo lo rechaza, lee su motivo: "That address answered, but not with an OpenID configuration." significa que el issuer no es la URL base bajo la que el proveedor publica su configuración; "Could not reach that issuer." significa que no es accesible desde internet; "The issuer needs to be a full URL, starting with https://." es un problema de formato; "An unexpected error occurred. Please check the details and try again. If the error persists, contact support." significa que la solicitud no se completó, así que inténtalo otra vez. **Reconnect** en el menú **...** vuelve a abrir el diálogo para cambiar cualquier dato.

## Relacionado

- [Inicio de sesión único](https://support.pyn.ai/es/integrations/sso/) para el mapeo de roles y lo que ven los empleados.
- [Conecta Okta](https://support.pyn.ai/es/integrations/sso/connect-okta/) para la integración específica de Okta.
- [Users](https://support.pyn.ai/es/settings/users/) para los roles a los que se refieren las listas de grupos.
