# Aprovisionamiento de grupos y usuarios de SCIM con Microsoft Azure AD
El sistema de gestión de identidades multidominio (SCIM) establece una comunicación estandarizada entre Modyo y Microsoft Azure para sincronizar automáticamente datos de usuarios y grupos. Esto te permite:
- Crear usuarios en Microsoft Azure y aprovisionarlos automáticamente en Modyo.
- Actualizar datos de usuario en Microsoft Azure y reflejar los cambios en Modyo.
- Eliminar usuarios en Microsoft Azure y desaprovisionarlos en Modyo
Esta integración de grupos y usuarios entre Modyo y Microsoft Azure Active Directory con la API SCIM de Modyo, simplifica la gestión de usuarios en diferentes sistemas y reduce errores, favoreciendo una administración eficiente.
Atención
La sincronización es unidireccional, lo que significa que los datos modificados en Modyo no afectarán los datos del usuario en Azure. Además, cualquier cambio realizado en Azure puede sobrescribir las modificaciones realizadas en Modyo.
# Paso 1: Crea tu aplicación en Azure Active Directory
- Accede al panel de administración de Azure Active Directory
- En el menú lateral selecciona Enterprise Application
- Selecciona la opción Crea tu propia aplicación en la parte superior de la galería de Azure
- Nombra tu aplicación y selecciona la opción Integrar cualquier otra aplicación que no se encuentre en la página como objetivo de la aplicación
- Haz click en Crear
# Paso 2: Aprovisionamiento
- Accede a tu aplicación en Azure
- En el menú lateral selecciona Aprovisamiento
- Da click en Introducción
- Selecciona aprovisionamiento Automático
- En las credenciales de administración, agrega lo siguiente:
- URL de inquilino: El URL de tu servidor de web compatible con SCIM, por ejemplo: https://tudominio.modyo.cloud/api/admin/scim
- Secret Token: El token de acceso del usuario administrativo de Modyo generado para la credencial de autenticación. Puedes encontrar información detallada de tokens en la sección de API de administración (opens new window)
- En la sección de Configuración puedes personalizar el envío de notificaciones y seleccionar el umbral de eliminación accidental. Para más información acerca de estas configuraciones, revisa la documentación de Azure (opens new window)
- Da click en Probar configuración para verificar la conexión
- Una vez confirmada la configuración da click en Guardar
- Si la configuración y guardado es correcto, debajo del botón de probar conexión podrás configurar la sección de Asignaciones
- Selecciona una asignación para proceder al paso de asignación de atributos
# Paso 3: Asignación de atributos
# Grupos
- Selecciona la asignación Provision Azure Active Directory Groups para configurar sus atributos.
- Selecciona las acciones del objeto de destino: Crear, actualizar y/ eliminar. Confirma que el mapeo sea:
Azure Active Directory Attribute | customApp Attribute |
---|---|
displayName | displayName |
objectId | externalId |
members | members |
- Da click en Guardar
# Usuarios
- Selecciona la asignación Provision Azure Active Directory Users para configurar los atributos de tus grupos.
- Selecciona únicamente las acciones: Crear y actualizar. Asegúrate que el mapeo sea:
Azure Active Directory Attribute | customApp Attribute |
---|---|
userPrincipalName | userName |
Switch([IsSoftDeleted],, "False", "True", "True", "False") | active |
emails[type eq "work".value] | |
givenName | name.givenName |
surname | name.familyName |
Join(" ",[givenName],[surname] | name.formatted |
- Da click en Guardar
- Una vez hecho lo anterior, en la sección de Aprovisionamiento, en las opciones de configuración tendrás ya la opción de Ámbito, selecciona Sincronizar todos los usuarios del grupo
- Da click en Guardar
Puedes confirmar que la configuración de tu mapeo es correcta siguiendo estos pasos:
- En Azure ve a aprovisionamiento
- Selecciona Aprovisionamiento a petición
- Confirma que el proceso corre sin mostrar errores
Tip
En el caso de grupos, no existe aprovisionamiento a petición por lo que, para probar la configuración de grupos, debes crear un usuario, agregarlo a un grupo y seleccionar comenzar aprovisionamiento.
Esta tarea se ejecuta cada 40 minutos, por lo que debes esperar este tiempo para ver los cambios reflejados en la plataforma.
Una vez configurado correctamente, puedes agregar usuarios en Active Directory. A la vez, tus grupos existentes también serán aprovisionados.
Atención
Nombre del usuario y correo electrónico son campos requeridos para generar usuarios. Sin ellos, fallará el aprovisionamiento del usuario.
# Referencias
- Para construir un API de SCIM compatible con Azure AD, sigue esta guía de Microsoft. Use SCIM to Provision Users and Groups (opens new window)
- Para más información de las APIs que Modyo ofrece, ve API de administración (opens new window).