Skip to content

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.

  1. 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.
  2. 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.
  3. Asignaciones → Aprovisionar grupos de Microsoft Entra ID: activado, si usas grupos.
  4. 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):

  1. 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.
  2. Provisioning → To App: activa Create Users, Update User Attributes y Deactivate Users.
  3. 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.