> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/es/administration/authentification-sso.md).

# Métodos de autenticación y Single Sign-On (SSO)

### Métodos de autenticación

Steeple propone dos métodos de autenticación:

* **Correo electrónico + contraseña** : método por defecto, cada colaborador inicia sesión con sus credenciales Steeple
* **Inicio de sesión único (SSO)** : conexión mediante un proveedor de identidad empresarial (Azure AD, Okta, Google Workspace)

### ¿Qué es el SSO?

El SSO (Inicio de sesión único) permite a los colaboradores iniciar sesión en Steeple con sus credenciales empresariales existentes, sin crear una cuenta separada.

#### Ventajas

* Gestión centralizada de los accesos
* No hay cuentas duplicadas
* Seguridad alineada con las herramientas de la empresa
* Posibilidad de automatizar el aprovisionamiento de usuarios

#### Protocolo

Steeple implementa el SSO mediante **SAML V2.0**.

#### Punto importante

Steeple no gestiona **el Single Logout (SLO)** : una vez establecida la sesión Steeple, es independiente de la sesión del proveedor de identidad y expira según su propia duración de validez.

### Proveedores de identidad admitidos

* **Azure Active Directory** (Microsoft Entra ID)
* **Okta**
* **Google Workspace**

### Configurar el SSO

La configuración se realiza desde **Administración** > **Integraciones** (`/administración/integraciones`).

#### SSO con Azure Active Directory

1. Crear una aplicación empresarial sin galería en Azure (Identity > Applications > Enterprise Applications)
2. En Steeple: Administración > Intégrations > Instalar, configurar el nombre del botón SSO y los dominios reservados
3. Copiar los metadatos de Steeple en la configuración SAML básica de Azure
4. Configurar los atributos de usuario (email, first\_name, last\_name, provider\_identifier)
5. Copiar la URL de los metadatos de federación desde Azure
6. Importar en Steeple pegando la URL y haciendo clic en "Importar los metadatos"
7. Asignar usuarios y grupos en Azure — el administrador que configura también debe ser asignado

#### SSO con Okta

1. Crear una integración SAML 2.0 en Okta (Applications > Create App Integration)
2. Copiar las URL de Steeple (desde Administración > Intégrations > Okta SAML > Instalar) en Okta
3. Configurar el formato Name ID en **EmailAddress**
4. Configurar los atributos como se especifica
5. Recuperar la URL de los metadatos desde la pestaña "Sign on" de Okta
6. Importar en Steeple

#### SSO con Google Workspace

1. Crear una aplicación SAML personalizada en Google (Aplicaciones > Web y móvil > Añadir una app)
2. Descargar el archivo XML de metadatos de Google
3. Configurar los metadatos de Steeple en Google Workspace y viceversa
4. El archivo XML de Google debe estar alojado en una URL accesible (utilizar un alojamiento interno seguro, no utilizar un servicio público de terceros) para poder importarse en Steeple
5. Configurar los atributos de usuario

### Migración al SSO

* **Mismo email** en el Directorio de la empresa y en Steeple: transición transparente, se conserva la cuenta existente
* **Email diferente** : se crea una nueva cuenta — el usuario debe unificar sus direcciones de email antes de la migración

### Arquitecturas multi-Comunidades (padre/hijo)

Para las organizaciones con Comunidades padre/hijo, es posible mapear grupos del proveedor de identidad a Comunidades Steeple específicas. La configuración varía según el proveedor:

* **Azure AD** : usar los claims de grupo con el object\_id del grupo
* **Okta** : configurar los grupos de Okta (reemplazar los espacios por guiones bajos en los nombres)
* **Google Workspace** : agregar el atributo sso\_group\_id

### Lo que puede hacer el asistente

El asistente puede guiar al usuario hacia la página **Integraciones** mediante navigate\_to y explicar los conceptos de autenticación. Para la configuración técnica detallada, dirigir a <https://help.steeple.com/>
