Aprovisionamiento de entrada controlado por API con Azure Logic Apps

En este tutorial se describe cómo usar el flujo de trabajo de Azure Logic Apps para implementar el aprovisionamiento de entrada controlado por API de Microsoft Entra ID. Siguiendo los pasos de este tutorial, puede convertir un archivo CSV que contenga datos de RRHH en una carga útil de solicitud masiva y enviarla al punto final de la API /bulkUpload de aprovisionamiento de Microsoft Entra. En el artículo también se proporcionan instrucciones sobre cómo se puede usar el mismo patrón de integración con cualquier sistema de registro.

Escenario de integración

Requisitos empresariales

El sistema de registro genera exportaciones periódicas de archivos CSV que contienen datos de trabajo. Quiere implementar una integración que lea datos del archivo CSV y aprovisione automáticamente cuentas de usuario en el directorio de destino (Active Directory local para usuarios híbridos y Microsoft Entra ID para usuarios solo en la nube).

Requisito de implementación

Desde una perspectiva de implementación:

• Quiere usar un flujo de trabajo de Azure Logic Apps para leer datos de las exportaciones de archivos CSV disponibles en un recurso compartido de archivos de Azure y enviarlos al punto de conexión de la API de aprovisionamiento de entrada.
• En el flujo de trabajo de Azure Logic Apps, no quiere implementar la lógica compleja de comparar los datos de identidad entre el sistema de registro y el directorio de destino.
• Desea utilizar el servicio de aprovisionamiento de Microsoft Entra para aplicar sus reglas de aprovisionamiento gestionadas por TI para crear/actualizar/habilitar/deshabilitar automáticamente cuentas en el directorio de destino (Active Directory local o Microsoft Entra ID).

Variaciones del escenario de integración

Aunque en este tutorial se usa un archivo CSV como sistema de registro, puede personalizar el flujo de trabajo de Azure Logic Apps de ejemplo para leer datos de cualquier sistema de registro. Azure Logic Apps proporciona una amplia gama de conectores integrados y conectores administrados con desencadenadores y acciones pregenerados que puede usar en el flujo de trabajo de integración.

Esta es una lista de variaciones de escenarios de integración empresarial, donde el aprovisionamiento entrante controlado por API se puede implementar con un flujo de trabajo de Logic Apps.

Después de leer los datos de origen, aplique las reglas de preprocesamiento y convierta la salida del sistema de registro en una solicitud masiva que se pueda enviar al punto de conexión de API bulkUpload de aprovisionamiento de Microsoft Entra.

Cómo usar este tutorial

La plantilla de implementación de Logic Apps publicada en el repositorio GitHub de aprovisionamiento entrante de Microsoft Entra automatiza varias tareas. También tiene lógica para controlar archivos CSV grandes y fragmentar la solicitud masiva para enviar 50 registros en cada solicitud. Aquí se muestra cómo puede probarla y personalizarla según sus requisitos de integración.

Paso 1: Creación de una cuenta de Azure Storage para hospedar el archivo CSV

Los pasos documentados en esta sección son opcionales. Si ya tiene una cuenta de almacenamiento existente o desea leer el archivo CSV desde otro origen, como el sitio de SharePoint o Blob Storage, actualice la aplicación lógica para usar el conector que prefiera.

1. Inicie sesión en Azure Portal al menos como Administrador de aplicaciones.
2. Busque "Cuentas de almacenamiento" y cree una nueva cuenta de almacenamiento.
3. Asigne un grupo de recursos y asígnele un nombre.
4. Después de que se cree la cuenta de almacenamiento, vaya al recurso.
5. Haga clic en la opción de menú "Recurso compartido de archivos" y cree un nuevo recurso compartido de archivos.
6. Compruebe que la creación del recurso compartido de archivos se ha realizado correctamente.
7. Cargue un archivo CSV de ejemplo en el recurso compartido de archivos mediante la opción de carga.
8. Esta es una captura de pantalla de las columnas del archivo CSV.

Paso 2: Configuración del convertidor CSV2JSON de la función de Azure

1. En el navegador asociado a su Azure portal, abra la URL del repositorio GitHub - https://github.com/joelbyford/CSVtoJSONcore.

2. Haga clic en el vínculo "Implementar en Azure" para implementar esta función de Azure en el inquilino de Azure.

3. Especifique el grupo de recursos en el que se va a implementar esta función de Azure.

   Si recibe el error "Esta región tiene cuota de 0 instancias", pruebe a seleccionar otra región.

4. Asegúrese de que la implementación de la función de Azure como App Service sea correcta.

5. Vaya al grupo de recursos y abra la configuración de la aplicación web. Asegúrese de que está en estado "En ejecución". Copie el nombre de dominio predeterminado asociado a la aplicación web.

6. Ejecuta el siguiente script de PowerShell para probar si el punto de conexión CSVtoJSON funciona del modo esperado. Establece los valores correctos para las variables $csvFilePath y $uri en el script.

   # Step 1: Read the CSV file 
   $csvFilePath = "C:\Path-to-CSV-file\hr-user-data.csv" 
   $csvContent = Get-Content -Path $csvFilePath 
   
   # Step 2: Set up the request 
   $uri = "https://az-function-webapp-your-domain/csvtojson" 
   $headers = @{ 
        "Content-Type" = "text/csv" 
   } 
   $body = $csvContent -join "`n"  # Join the CSV lines into a single string 
   
   # Step 3: Send the POST request 
   $response = Invoke-WebRequest -Uri $uri -Method POST -Headers $headers -Body $body 
   
   # Output and format the JSON response 
   $response.Content | ConvertFrom-JSON | ConvertTo-JSON 
   

7. Si el despliegue de la característica de Azure se realiza correctamente, la última línea del script genera la versión JSON del archivo CSV.

    .

8. Para permitir que Logic Apps invoque esta función de Azure, en la configuración de CORS de la aplicación web escriba asterisco (*) y guarde la configuración.

Paso 3: Configuración del aprovisionamiento entrante de usuarios controlado por API

• Configure el aprovisionamiento entrante de usuarios controlado por API.

Paso 4: Configuración del flujo de trabajo de Azure Logic Apps

1. Haga clic en el botón siguiente para implementar la plantilla de Azure Resource Manager para el flujo de trabajo CSV2SCIMBulkUpload de Logic Apps.

   

2. En los detalles de la instancia, actualice los elementos resaltados copiando y pegando los valores de los pasos anteriores.

3. Para el parámetro Azurefile_access Key, abra la cuenta de almacenamiento de archivos de Azure y copie la clave de acceso que aparece en "Seguridad y redes".
   

4. Haga clic en la opción "Revisar y crear" para iniciar la implementación.

5. Una vez que haya completado la implementación, verá el mensaje siguiente.

Paso 5: Configuración de una identidad administrada asignada por el sistema

1. Visite la configuración:> hoja Identidad del flujo de trabajo de Logic Apps.
2. Habilite Identidad administrada asignada por el sistema.
3. Recibirá un mensaje para confirmar el uso de la identidad administrada. Haga clic en Sí.
4. Conceda a la identidad administrada permisos para realizar la carga masiva.

Paso 6: Revisión y ajuste de los pasos del flujo de trabajo

1. Abra la aplicación lógica en la vista de diseñador.

2. Revise la configuración de cada paso del flujo de trabajo para asegurarse de que es correcta.

3. Abra el paso "Obtener contenido de archivo mediante la ruta de acceso" y corríjalo para ir al almacenamiento de archivos de Azure en su inquilino.

4. Actualice la conexión si es necesario.

5. Asegúrese de que el paso "Convertir CSV a JSON" apunta a la instancia correcta de la aplicación web de la función de Azure.

6. Si el contenido o los encabezados del archivo CSV son diferentes, actualice el paso "Analizar JSON" con la salida de JSON que puede recuperar de la llamada API a la función de Azure. Usa la salida de PowerShell del paso 2.

7. En el paso "Construir SCIMUser", asegúrese de que los campos CSV se asignan correctamente a los atributos SCIM que se usarán para el procesamiento.

   

8. En el paso "Enviar SCIMBulkPayload al punto de conexión de API", asegúrese de que usa el punto de conexión de API y el mecanismo de autenticación correctos.

   

Paso 7: Ejecución del desencadenador y prueba del flujo de trabajo de Logic Apps

1. En la versión "Disponible con carácter general" del diseñador de Logic Apps, haga clic en Ejecutar desencadenador para ejecutar manualmente el flujo de trabajo.
2. Una vez completada la ejecución, revise la acción que Logic Apps realizó en cada iteración.
3. En la iteración final, debería ver que Logic Apps carga datos en el punto de conexión de la API de aprovisionamiento de entrada. Busque el código de estado 202 Accept. Puede copiar y pegar y comprobar la solicitud de carga masiva.

Pasos siguientes

• Solución de problemas con la API de aprovisionamiento de entrada
• Conceptos de aprovisionamiento de entrada controlados por API
• Preguntas más frecuentes sobre el aprovisionamiento de entrada controlado por API