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

# SAML SSO

> Configure el inicio de sesión único SAML 2.0 para su organización.

Truthlocks admite el inicio de sesión único nativo SAML 2.0 para que su equipo pueda autenticarse a través de su proveedor de identidad (IdP) existente. Cuando SAML está configurado, los usuarios son redirigidos automáticamente a su IdP durante el inicio de sesión.

> [!NOTE]
>
> El inicio de sesión único SAML está disponible en el plan **Business** y superiores.

## Cómo funciona

**1. Configure su IdP**

Registra Truthlocks como proveedor de servicios (SP) en tu proveedor de identidad.
Necesita la ID de entidad SP y la URL del Servicio de Consumidor de Aserciones (ACS) del
pantalla de configuración.

**2. Añadir conexión en Truthlocks**

En la consola, ve a **Configuración > SSO** y crea una nueva conexión SAML.
Introduzca la URL de metadatos de su IdP o proporcione manualmente el ID de entidad del IdP, la URL de SSO,
y certificado de firma.

**3. Los usuarios inician sesión a través de IdP**

Una vez activos, los usuarios que visiten la página de inicio de sesión de la consola serán redirigidos a tu
IdP. Después de autenticarse, regresan a Truthlocks con una sesión.

## Detalles del proveedor de servicios

Proporcione estos valores a su IdP al registrar Truthlocks:

| Campo | Valor |
| - | - |
| ID de entidad SP | `urn:truthlocks:TENANT_ID` |
| URL de ACS | `https://console.truthlocks.com/api/auth/saml/acs` |
| Formato NameID | `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` |
| Enlace | HTTP-POST |

## Campos de configuración de IdP

Al crear una conexión SAML en la consola, puede configurar su IdP de dos maneras:

### Opción A: URL de metadatos

Proporcione la URL de metadatos de su IdP y Truthlocks obtendrá automáticamente el ID de entidad, la URL de SSO y el certificado de firma.

### Opción B: configuración manual

| Campo | Descripción |
| - | - |
| ID de Entidad IdP | El identificador único de su proveedor de identidad |
| URL de SSO de IdP | La URL a la que Truthlocks envía las solicitudes de autenticación SAML |
| Certificado IdP | El certificado de firma X.509 de su IdP (formato PEM) |

## Creación de una conexión a través de la API

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_type": "SAML",
    "idp_metadata_url": "https://idp.example.com/metadata",
    "role_mapping_mode": "GROUPS"
  }'
```

Si prefiere la configuración manual, omita `idp_metadata_url` y proporcione `idp_entity_id`, `idp_sso_url` y `idp_certificate` en su lugar.

## Mapeo de roles

Truthlocks mapea las aserciones de grupo de IdP a roles internos durante el inicio de sesión. Hay dos modos disponibles:

| Modo | Comportamiento |
| - | - |
| `STATIC` | Todos los usuarios de SAML reciben un rol predeterminado fijo (por ejemplo, `viewer`) |
| `GROUPS` | Los nombres de grupo de IdP se asignan automáticamente a los roles de Truthlocks (`admin`, `editor`, `auditor`) |

Establezca el modo al crear o actualizar la conexión SSO.

## Aprovisionamiento de usuarios

Cuando un usuario se autentica por primera vez a través de SAML, Truthlocks crea automáticamente su cuenta utilizando atributos de la aserción SAML (correo electrónico, nombre, apellido). Esto se denomina aprovisionamiento justo a tiempo (JIT).

Para la sincronización masiva de usuarios y el desaprovisionamiento, utilice [aprovisionamiento SCIM](https://docs.truthlocks.com/es/security/scim.md).

## Detalles de la sesión

* Las sesiones duran **12 horas** después del inicio de sesión SAML.
* Las cookies de sesión son `HttpOnly` y `SameSite=Lax`.
* Se aplica una tolerancia de desviación de reloj de 2 minutos al validar aserciones SAML.

## Probando una conexión

Después de crear una conexión SAML, pruébela antes de habilitarla para todos los usuarios:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/test \
  -H "Authorization: Bearer <admin_token>"
```

Esto valida que Truthlocks puede llegar a su IdP y analizar los metadatos correctamente.

## Deshabilitar SSO

Para volver a la autenticación estándar por correo electrónico/contraseña:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/disable \
  -H "Authorization: Bearer <admin_token>"
```

## Relacionado

* [Aprovisionamiento SCIM](https://docs.truthlocks.com/es/security/scim.md) — Automatice la sincronización de usuarios y grupos desde su IdP.
* [RBAC y permisos](https://docs.truthlocks.com/es/security/rbac.md) — Comprenda los roles a los que se asignan los usuarios de SAML.
* [Autenticación](https://docs.truthlocks.com/es/security/auth.md) — Métodos de autenticación de clave API y JWT.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.