# 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

  1. Accede al panel de administración de Azure Active Directory
  2. En el menú lateral selecciona Enterprise Application
  3. Selecciona la opción Crea tu propia aplicación en la parte superior de la galería de Azure
  4. 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
  5. Haz click en Crear

# Paso 2: Aprovisionamiento

  1. Accede a tu aplicación en Azure
  2. En el menú lateral selecciona Aprovisamiento
  3. Da click en Introducción
  4. Selecciona aprovisionamiento Automático
  5. 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)
  6. 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)
  7. Da click en Probar configuración para verificar la conexión
  8. Una vez confirmada la configuración da click en Guardar
  9. Si la configuración y guardado es correcto, debajo del botón de probar conexión podrás configurar la sección de Asignaciones
  10. Selecciona una asignación para proceder al paso de asignación de atributos

# Paso 3: Asignación de atributos

# Grupos

  1. Selecciona la asignación Provision Azure Active Directory Groups para configurar sus atributos.
  2. 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
  1. Da click en Guardar

# Usuarios

  1. Selecciona la asignación Provision Azure Active Directory Users para configurar los atributos de tus grupos.
  2. 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
mail emails[type eq "work".value]
givenName name.givenName
surname name.familyName
Join(" ",[givenName],[surname] name.formatted
  1. Da click en Guardar
  2. 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
  3. Da click en Guardar

Puedes confirmar que la configuración de tu mapeo es correcta siguiendo estos pasos:

  1. En Azure ve a aprovisionamiento
  2. Selecciona Aprovisionamiento a petición
  3. 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