# Configurar el inicio de sesión único (SSO)

> Configura el inicio de sesión con SAML 2.0 u OpenID Connect para AI CodeOps en el plan Enterprise: verifica tu dominio, crea una conexión, configura tu IdP y actívala.

Fuente: https://aicodeops.dev/es/docs/sso · Última actualización: 2026-10-18

El inicio de sesión único permite que tu gente inicie sesión en AI CodeOps a través de tu propio proveedor de identidad (IdP), con SAML 2.0 u OpenID Connect (OIDC). Sirve cualquier IdP que admita uno de los dos protocolos; introduces tú mismo sus datos, así que no hay ajustes predefinidos por proveedor.

## Antes de empezar

- **Plan.** El SSO forma parte del plan Enterprise, igual que la verificación de dominios. Sin él, la tarjeta muestra "SSO (SAML 2.0 / OIDC) is available on the Enterprise plan." Consulta [Enterprise](https://aicodeops.dev/es/enterprise).
- **Quién puede configurarlo.** El SSO pertenece a la organización, no a un único espacio de trabajo. Los propietarios y administradores de la organización ven la tarjeta. Solo un propietario puede crear, editar y activar una conexión. Los propietarios y los administradores pueden verificar dominios, fijar el espacio de trabajo por defecto del SSO, y desactivar y eliminar conexiones.
- **Acceso al DNS.** Tienes que añadir un registro TXT para tu dominio de correo electrónico.

Los ajustes están en **Configure → Settings**, en la tarjeta **Single sign-on**.

## 1. Verifica tu dominio

1. En **Verified Domains**, introduce tu dominio de correo electrónico, por ejemplo `example.com`, y elige **Verify a domain**.
2. Añade a tu DNS el registro TXT que se muestra:
   - Nombre: `_codeopsstudio-verify.example.com`
   - Valor: el token que aparece en pantalla
3. Elige **Check now**. Los cambios de DNS pueden tardar en aparecer, así que vuelve a comprobarlo más tarde si todavía no está verificado.

No puedes crear una conexión para un dominio hasta que esté verificado.

## 2. Crea una conexión

1. Elige **Add SSO connection**.
2. En **New SSO Connection**, rellena:

| Campo            | SAML 2.0                                                      | OpenID Connect                                   |
| ---------------- | ------------------------------------------------------------- | ------------------------------------------------ |
| **Protocol**     | SAML 2.0                                                      | OpenID Connect                                   |
| **Display Name** | Un nombre que reconozcas, como "Okta"                         | Un nombre, como "Azure AD"                       |
| **Email Domain** | Un dominio verificado                                         | Un dominio verificado                            |
| **Default Role** | Member, Developer o Viewer                                    | Member, Developer o Viewer                       |
| Datos del IdP    | **IdP Entity ID**, **IdP SSO URL**, **IdP Certificate (PEM)** | **Issuer URL**, **Client ID**, **Client Secret** |

3. Elige **Create Connection**.

El client secret de OIDC se cifra en reposo. No hay ningún campo para una URL de metadatos del IdP; copia los valores desde tu IdP.

## 3. Configura tu proveedor de identidad

La tarjeta de la conexión muestra los valores que necesita tu IdP:

| Protocolo | Etiqueta         | Ruta                                 | Uso                                                  |
| --------- | ---------------- | ------------------------------------ | ---------------------------------------------------- |
| SAML      | **Metadata URL** | `/sso/saml/<connection-id>/metadata` | Metadatos del proveedor de servicios, y su entity ID |
| SAML      | **ACS URL**      | `/sso/saml/<connection-id>/acs`      | Assertion Consumer Service (HTTP-POST)               |
| OIDC      | **Redirect URI** | `/sso/oidc/<connection-id>/callback` | URI de redirección para tu aplicación OIDC           |

Las rutas van sobre la dirección de la consola, por ejemplo `https://console.aicodeops.dev`.

**SAML.** Envía la dirección de correo electrónico del usuario como NameID (formato de dirección de correo electrónico) o como un atributo `email`. Las aserciones deben ir firmadas con el certificado que introdujiste. AI CodeOps comprueba la firma, la audiencia, la caducidad y que la respuesta corresponda a un inicio de sesión que él mismo empezó. El inicio de sesión debe empezar en AI CodeOps; un icono en el panel de tu IdP no funcionará.

**OIDC.** AI CodeOps solicita los scopes `openid email profile` y usa PKCE.

## 4. Activa y comparte el enlace

Una conexión nueva está en pruebas hasta que la activas. Mientras lo está, solo inicia la sesión de personas que ya están en tu organización, y no crea cuentas. Para probarla con tu propia cuenta, abre `/sso/saml/<connection-id>/login` o `/sso/oidc/<connection-id>/login` sobre la dirección de la consola.

1. En la tarjeta de la conexión, elige **Activate**.
2. Comparte el enlace de inicio de sesión con tu gente:

```text
https://console.aicodeops.dev/sso/login?domain=example.com
```

El enlace abre **Continue with single sign-on** si falta el dominio, de modo que la gente también puede escribir allí su correo electrónico de trabajo. Busca la conexión activa del dominio y los envía a tu IdP.

## Usuarios nuevos y roles

El primer inicio de sesión con SSO crea la cuenta de la persona si no tiene una y la añade a tu organización.

Para poner a las personas nuevas directamente en un espacio de trabajo, abre los ajustes de ese espacio de trabajo y elige **Set this workspace as SSO default** en la tarjeta de la conexión. Se unen a él con el **Default Role** de la conexión. Sin un espacio de trabajo por defecto, llegan a su propio espacio de trabajo personal hasta que alguien [los invita](https://aicodeops.dev/es/docs/members). Puedes cambiar su rol más tarde; consulta [Roles y permisos](https://aicodeops.dev/es/docs/roles-and-permissions).

## Las sesiones se quedan dentro de tu organización

Un inicio de sesión a través de tu SSO solo accede a los espacios de trabajo de tu organización y al espacio de trabajo personal de la propia persona. Los espacios de trabajo de otras organizaciones quedan bloqueados para esa sesión, aunque la persona sea miembro de ellos.

## Desactivar o eliminar

- **Deactivate** detiene los nuevos inicios de sesión con SSO y conserva la configuración.
- **Delete** elimina la conexión después de que confirmes con **Delete connection**. Sus usuarios inician sesión entonces con una contraseña o con una cuenta social.

Los cambios de SSO se registran como eventos de auditoría `sso.connection.*` y `sso.domain.*` para la organización. No aparecen en la página del [registro de auditoría](https://aicodeops.dev/es/docs/audit-logs) de un espacio de trabajo, y se conservan 7 días.

## Siguientes pasos

- [Resumen de Enterprise](https://aicodeops.dev/es/docs/enterprise)
- [Roles y permisos](https://aicodeops.dev/es/docs/roles-and-permissions)
- [Plan Enterprise](https://aicodeops.dev/es/enterprise)

## Preguntas frecuentes

### ¿Qué plan incluye SSO?

Enterprise. En los demás planes, la tarjeta Single sign-on dice que el SSO está disponible en el plan Enterprise.

### ¿Dónde está la URL de metadatos de SAML?

En la tarjeta de la conexión después de crearla, con la etiqueta Metadata URL. Tiene la forma /sso/saml/<connection-id>/metadata y es también el entity ID del proveedor de servicios.

### ¿Se puede seguir iniciando sesión con contraseña cuando el SSO está activo?

Sí. El SSO añade una forma de iniciar sesión; no desactiva el inicio de sesión con contraseña ni con cuentas sociales para tu dominio.
