> 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/provisioning-scim.md).

# Aprovisionamiento automático de colaboradores (Provisioning / SCIM)

### ¿Qué es el aprovisionamiento?

El provisioning (aprovisionamiento) es la sincronización automática y continua de los usuarios desde un proveedor de identidad hacia Steeple. A diferencia del SSO, que solo actúa en la autenticación, el provisioning mantiene los datos actualizados de forma permanente.

#### Lo que se sincroniza automáticamente

* **Datos de identidad** : nombre, apellido, correo electrónico
* **Derechos de acceso** a las Comunidades
* **Asignación de roles**

#### Protocolo

Steeple utiliza el protocolo **SCIM** (Sistema de gestión de identidades entre dominios). La comunicación es **unidireccional** : del proveedor de identidad hacia Steeple.

#### Recursos sincronizados

* Usuarios
* Grupos
* Pertenencias usuario-grupo

### Requisito previo importante

El **El SSO debe configurarse antes del aprovisionamiento**. No es posible configurar el aprovisionamiento por sí solo, sea cual sea el proveedor.

### Proveedores compatibles

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

Google Workspace solo admite el SSO, no el aprovisionamiento SCIM.

### Mapeo de grupos → Comunidades

Los grupos del proveedor de identidad no se corresponden directamente con las Comunidades Steeple. Una **asociación intermedia** es necesario: cada grupo está vinculado a una pareja (comunidad, rol), lo que traduce la pertenencia al grupo en acceso comunitario con un rol específico.

**Recomendación** : crear al menos **dos grupos por comunidad** (colaboradores y administradores).

### Configurar el aprovisionamiento

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

#### Aprovisionamiento con Azure Active Directory

1. En Steeple: Administración > Integraciones > Instalar > hacer clic en "Mostrar" en la sección Identificación para obtener el**URL SCIM** y el **Token Bearer**
   * El token es un secreto: nunca lo compartas en un canal no seguro (chat, email, ticket público)
2. En Azure: Directory Overview > Provisioning > pasar al modo **Automático**
3. Pegar la URL (Tenant URL) y el Token (Secret Token), probar la conexión
4. Si se necesita soft-delete: añadir un mapeo de expresión `Switch([IsSoftDeleted], , "False", "True", "True", "False")` sobre el atributo **activo**
5. Asignar los grupos precreados en "Users and Groups"
6. Iniciar el aprovisionamiento — **Azure sincroniza cada 25 a 40 minutos**
7. En Steeple: asignar los roles a los grupos y Comunidades vinculadas
8. Verificar que el número de usuarios y de grupos coincide, luego activar la sincronización

#### Aprovisionamiento con Okta

1. En Steeple: Administración > Integraciones > Okta SCIM > Instalar para obtener el**URL del tenant** y el **Token secreto**
   * El token es un secreto: nunca lo compartas en un canal no seguro (chat, email, ticket público)
2. En Okta: General > App Settings > activar manualmente el aprovisionamiento > guardar
3. Aprovisionamiento > Integración > configurar el conector SCIM:
   * Pegar la URL del tenant
   * Identificador único: **userName**
   * Marcar solo las casillas **Push**
   * Modo de autenticación: **Encabezado HTTP** con el Secret Token
   * Probar y luego guardar
4. Aprovisionamiento > Configuración > To App: activar **Crear usuarios**, **Actualizar atributos del usuario**, **Desactivar usuarios**
5. Asignar usuarios/grupos, configurar Push Groups para el mapeo hacia las Comunidades
6. Activar la sincronización en Steeple — **Okta aplica los cambios casi inmediatamente**

### Advertencias importantes

* **Desactivar o eliminar a un usuario** del lado del proveedor de identidad **elimina al usuario de la organización Steeple** y hace que sus Publicaciones sean invisibles
* Solo una intervención manual del soporte puede reasignar las Publicaciones de un usuario eliminado
* A todo usuario ausente del Directorio de la empresa se le **retirarán todos sus accesos** por defecto

### Opciones adicionales

* **Envío automático de correos de invitación** a los usuarios recién creados (opcional con SSO, ya que el SSO permite la conexión sin invitación)
* **Creación manual de cuentas** fuera del Directorio de la empresa (estas cuentas usan la autenticación clásica de correo electrónico/contraseña y deben eliminarse manualmente)

### Caso específico

Si no encuentra a uno de sus colaboradores en el Directorio de Steeple, verifique en su proveedor de identidad (Entra-Okta...) :&#x20;

* que su colaborador está realmente presente&#x20;
* que el usuario está correctamente vinculado a un grupo que da acceso a la aplicación Steeple

### Lo que el asistente puede hacer

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