Sincronización de directorio (SCIM)
Con la sincronización de directorio, tu proveedor de identidad administra a las personas de tu cuenta de linkable.id a través de SCIM:
- Las personas asignadas a linkable.id en tu proveedor de identidad obtienen una cuenta, lista para iniciar sesión con inicio de sesión único.
- Su nombre y correo se mantienen al día.
- Cuando alguien se desactiva, se desasigna o se elimina allí, su cuenta queda suspendida aquí de inmediato: se cierra su sesión en todas partes, sus tokens de API y conexiones con Claude se detienen, y su trabajo se conserva. Al reactivar a la persona allí, vuelve.
- Sus espacios de trabajo y roles pueden seguir sus grupos en tu proveedor de identidad.
Disponibilidad: el plan Enterprise, junto con el inicio de sesión único; funciona con Microsoft Entra ID y Okta. El soporte de linkable.id la configura con tu equipo de TI (consulta Para tu equipo de TI).
Google Workspace no puede enviar SCIM a apps fuera de su propio catálogo, así que no es compatible. Con el SSO obligatorio, alguien suspendido en Google no puede iniciar sesión; un super admin suspende su cuenta aquí para detener también sus tokens y conexiones. Para sincronizar automáticamente, puedes poner Okta o Microsoft Entra ID delante de Google Workspace.
A quién administra tu proveedor de identidad
Solo a las personas de los dominios de inicio de sesión único de tu empresa. Cuando envía a alguien que ya tiene usuario en linkable.id (agregado a mano o por un inicio de sesión con SSO anterior), ese usuario pasa a ser administrado por él: su trabajo e historial se conservan. Las personas fuera de tus dominios, como una agencia, nunca se tocan.
Tu proveedor de identidad nunca convierte a nadie en super admin, y nunca suspende una cuenta de emergencia ni cambia su correo, ni el de un super admin. En Usuarios, la columna Administrado por muestra a quién administra tu proveedor de identidad, y quien fue desactivado allí muestra Suspendido por tu proveedor de identidad: se reactiva allí, no aquí.
Asignar grupos a espacios de trabajo
Los super admins asignan grupos en Configuración → Sincronización de directorio. Cada asignación es un grupo, un espacio de trabajo y un rol: por ejemplo, "Ventas" → el espacio de trabajo Ventas → Editor.
- Las personas nuevas llegan al espacio de trabajo y rol predeterminados de tu cuenta.
- Cuando un espacio de trabajo tiene una asignación, las personas que administra tu proveedor de identidad están en él exactamente mientras pertenezcan a un grupo asignado, con los roles de todos sus grupos asignados allí. Salir del grupo las quita de ese espacio de trabajo y detiene sus conexiones con Claude y tokens de API para él.
- Los espacios de trabajo sin asignación nunca cambian: agrega y quita personas allí como siempre.
- Un espacio de trabajo donde alguien es super admin nunca cambia para esa persona.
- Solo puedes asignar grupos a espacios de trabajo donde eres super admin, y nunca al rol de super admin.
Asigna tus grupos antes de asignar personas a linkable.id en tu proveedor de identidad, para que todos lleguen a los espacios de trabajo correctos desde el inicio. En un espacio de trabajo que sigue a los grupos, las personas que administra tu proveedor de identidad muestran "Administrado por tu proveedor de identidad", y se agregan o quitan a través de sus grupos y no a mano.
Para tu equipo de TI
Pide al soporte de linkable.id tu URL base de SCIM (https://tu-dominio-de-administracion/scim/v2) y tu token SCIM, por un canal seguro. El inicio de sesión único ya debe funcionar.
Microsoft Entra ID: Microsoft no permite el aprovisionamiento en el registro de aplicación que usas para el inicio de sesión único, así que el aprovisionamiento usa una segunda aplicación: Aplicaciones empresariales (Enterprise applications) → Nueva aplicación → Crear su propia aplicación → "Integrar cualquier otra aplicación que no se encuentre en la galería (no de galería)", con un nombre como "linkable.id aprovisionamiento". Asigna los mismos grupos a ambas aplicaciones, para que todas las personas aprovisionadas también puedan iniciar sesión.
- En la aplicación nueva, Aprovisionamiento (Provisioning) → modo Automático. URL de inquilino (Tenant URL): la URL base de SCIM. Token secreto (Secret token): el token SCIM. Probar conexión (Test connection) y guarda.
- Asignaciones → Aprovisionar usuarios de Microsoft Entra ID: conserva
userPrincipalName→userName(debe ser el correo de trabajo de la persona en tus dominios) como atributo de coincidencia. linkable.id ignora los atributos que no guarda, como direcciones y teléfonos; puedes quitarlos. - Asignaciones → Aprovisionar grupos de Microsoft Entra ID: activado, si usas grupos.
- Configuración → Ámbito: "Sincronizar solo los usuarios y grupos asignados". Asigna las personas y los grupos, y luego inicia el aprovisionamiento.
Okta (la integración de app OIDC que usas para el inicio de sesión único, si se creó con el App Integration Wizard; Okta no admite SCIM en integraciones OIDC creadas en su experiencia Classic, así que en ese caso crea una nueva):
- General → Provisioning: SCIM. SCIM connector base URL: la URL base de SCIM. Unique identifier field for users:
userName. Supported provisioning actions: Push New Users, Push Profile Updates, Push Groups. Authentication Mode: HTTP Header, con el token SCIM como token bearer. Test Connector Configuration y guarda. - Provisioning → To App: activa Create Users, Update User Attributes y Deactivate Users.
- Push Groups: envía los grupos que quieras asignar.
Los nombres de los menús en las consolas de administración cambian con el tiempo y según el idioma; lo que importa son los valores de arriba.
Si algo sale mal
Los registros de aprovisionamiento de tu proveedor de identidad muestran la respuesta de linkable.id para cada persona:
- "El correo no pertenece a los dominios de inicio de sesión único de esta cuenta": el userName de la persona no está en los dominios de tu empresa.
- "Ya existe un usuario con este correo y no se puede aprovisionar": el correo pertenece a un usuario eliminado; un super admin lo restaura o lo quita en Usuarios.
- "El plan de la cuenta no tiene espacio para otro usuario": se alcanzó el límite de usuarios de tu plan.
- "El correo de esta cuenta no se puede cambiar a través de SCIM": el correo de un super admin o de una cuenta de emergencia; un super admin lo cambia aquí.
Con Claude
Claude aún no puede administrar la sincronización de directorio: eso queda en el panel.