Este artículo proporciona instrucciones paso a paso para configurar la conexión SCIM entre Microsoft Entra ID y deskbird, permitiendo la sincronización automática de datos de usuarios y grupos.
💡 Nota: Después de configurar SCIM, la primera sincronización puede tardar entre 1 y 2 horas. Por favor, espera y vuelve a comprobar más tarde.
⚠️ Los objetos de aprovisionamiento deben incluir solo los usuarios y/o grupos que necesiten acceso a deskbird. Cualquier objeto incluido en la sincronización se aprovisionará automáticamente.
- Crea el token SCIM en deskbird
- Configura la aplicación SCIM
- Pasos para aprovisionar los objetos seleccionados
1. Crea el token SCIM en deskbird
- Ve a Admin > Empresa: Claves API.
- Haz clic en Generate key, introduce un Nombre y selecciona SCIM.
3. Elige tu proveedor SCIM y genera tu token (solo hay un token por empresa)
4. Copia tu token SCIM y guárdalo en un lugar seguro (el token no será visible en la interfaz)
5. Siempre puedes revocar una clave existente y generar una nueva
Ahora tienes todo lo necesario para continuar con la configuración de tu aplicación SCIM
2. Configura la aplicación SCIM
- Ve a https://entra.microsoft.com/ y haz clic en Enterprise applications
- Haz clic en New application
- Haz clic en Create your own application
- Ponle un nombre y asegúrate de que la opción Integrate any other application you don't find in the gallery (Non-gallery) esté marcada:
- Haz clic en Create
- Ahora deberías ser redirigido a la aplicación recién creada
- Ve a Provisioning
- Haz clic en Get started
- Selecciona Automatic en el menú desplegable
- En el campo Tenant URL, introduce la siguiente URL: https://api.deskbird.app/v2/scim
- En el campo Secret Token, introduce el token SCIM de la empresa que generaste en el primer paso
- Haz clic en Test Connection
Si todo funciona correctamente, verás una ventana de confirmación.
- Haz clic en Save
- Haz clic en Provision Microsoft Entra ID Users en la sección Mappings
- Desplázate hasta el final de la página y elimina el atributo mailNickname
- Al final de la página, haz clic en Add New Mapping
- Ve a Source attribute y selecciona objectId en el menú desplegable
- Ve a Target attribute y selecciona externalId en el menú desplegable
- Haz clic en Save
- Ahora deberías ver la asignación añadida en la lista:
- Haz clic en Provision Microsoft Entra ID Users en la sección Mappings
💡 Comprobación recomendada para el aprovisionamiento basado en grupos:
Si usas aprovisionamiento SCIM basado en grupos, te recomendamos verificar las asignaciones de atributos de grupo para asegurarte de que los usuarios se desactiven correctamente en deskbird cuando se eliminen de un grupo de Entra ID.
- En la sección Mappings, selecciona Provision Microsoft Entra ID Groups en el menú desplegable.
- Desplázate hasta el final y haz clic en Show advanced options.
- Busca el atributo cuyo target attribute sea members.
Asegúrate de tener la siguiente configuración:
- ❌ urn:ietf:params:scim:schemas:core:2.0:Group no está seleccionado
- ✅ urn:ietf:params:scim:schemas:extension:enterprise:2.0:User permanece seleccionado
Guarda los cambios y espera unos minutos para que Microsoft Entra ID los aplique. Con esta configuración, los usuarios eliminados de los grupos de Entra ID se marcarán correctamente como Inactivo en deskbird durante el siguiente ciclo de aprovisionamiento.
- Ve a Enterprise Applications y selecciona Users and Groups
- Haz clic en Add user/group
- Haz clic en None selected
- Busca y elige los grupos/usuarios que quieras aprovisionar. Haz clic en Select
- Haz clic en Assign
¡Todo debería estar configurado ahora!
3. Pasos para aprovisionar los objetos seleccionados
- Ve a tu aplicación SCIM y haz clic en Provisioning
- Ve a Start provisioning
- El proceso se ejecutará en segundo plano. Una vez completado, debería verse así:
💡 Nota: Después de configurar SCIM, la primera sincronización puede tardar entre 1 y 2 horas. Por favor, espera y vuelve a comprobar más tarde. Tras la configuración inicial, se realizará una sincronización cada 40 minutos.