Provisionnement entrant piloté par l’API avec Azure Logic Apps

Ce tutoriel explique comment utiliser le workflow Azure Logic Apps pour implémenter le provisionnement entrant piloté par l’API avec Microsoft Entra ID. Suivez les étapes présentées ci-après pour convertir un fichier CSV contenant des données RH dans la charge utile d’une requête en bloc et l’envoyer au point de terminaison de l’API de provisionnement /bulkUpload de Microsoft Entra. L’article fournit également des conseils sur la façon d’adapter ce même modèle d’intégration pour l’utiliser avec n’importe quel système d’enregistrement.

Scénario d’intégration

Exigence commerciale

Votre système d’enregistrement génère régulièrement des fichiers CSV contenant des données sur les employés. Vous souhaitez implémenter une intégration qui lit les données issues de ces fichiers CSV et provisionne automatiquement les comptes d’utilisateur dans votre annuaire cible (Active Directory local pour les utilisateurs hybrides et Microsoft Entra ID pour les utilisateurs cloud uniquement).

Exigences d’implémentation

D’un point de vue technique :

• Vous souhaitez utiliser un workflow Azure Logic Apps pour lire les données issues des fichiers CSV stockés dans un partage de fichiers Azure et les envoyer au point de terminaison de l’API de provisionnement entrant.
• Dans votre workflow Azure Logic Apps, vous ne souhaitez pas implémenter la logique complexe de comparaison des données d’identité entre votre système d’enregistrement et votre annuaire cible.
• Vous souhaitez vous appuyer sur le service de provisionnement Microsoft Entra pour appliquer vos règles de provisionnement gérées par le service informatique afin de créer,mettre à jour, activer ou désactiver automatiquement des comptes dans l’annuaire cible (Active Directory local ou Microsoft Entra ID).

Variantes du scénario d’intégration

Bien que ce tutoriel utilise un fichier CSV comme système d’enregistrement, vous pouvez adapter le workflow Azure Logic Apps proposé pour lire les données depuis n’importe quel système d’enregistrement. Azure Logic Apps offre un vaste éventail de connecteurs intégrés et de connecteurs managés, avec des déclencheurs et des actions prédéfinis, que vous pouvez utiliser dans votre workflow d’intégration.

Voici quelques exemples de variantes au scénario d’intégration d’entreprise, dans lesquelles le provisionnement entrant piloté par l’API peut être implémenté avec un workflow Logic Apps.

Une fois les données sources lues, appliquez vos règles de prétraitement et convertissez la sortie de votre système d’enregistrement en une requête en bloc à envoyer au point de terminaison de l’API de provisionnement /bulkUpload de Microsoft Entra.

Utilisation du tutoriel

Le modèle de déploiement Logic Apps publié dans le référentiel GitHub de provisionnement entrant de Microsoft Entra automatise plusieurs tâches. Il contient également une logique de gestion des fichiers CSV volumineux, en divisant automatiquement les requêtes en lots de 50 enregistrements. Voici comment vous pouvez le tester et le personnaliser en fonction de vos besoins d’intégration.

Étape 1 : Créer un compte de stockage Azure pour héberger le fichier CSV

Les étapes documentées dans cette section sont facultatives. Si vous disposez déjà d’un compte de stockage ou si vous préférez lire le fichier CSV depuis une autre source (comme un site SharePoint ou un stockage Blob), vous pouvez simplement adapter l’application logique de façon à utiliser le connecteur de votre choix.

1. Connectez-vous au portail Azure avec un compte disposant au moins du rôle Administrateur d’application.
2. Recherchez « Comptes de stockage » et créez un compte de stockage.
3. Attribuez un groupe de ressources et donnez-lui un nom.
4. Une fois le compte de stockage créé, accédez à la ressource.
5. Sélectionnez l’option de menu « Partage de fichiers » et créez un partage de fichiers.
6. Vérifiez que le partage de fichiers a bien été créé.
7. Chargez un exemple de fichier CSV dans le partage de fichiers à l’aide de l’option prévue à cet effet.
8. Voici une capture d’écran des colonnes du fichier CSV.

Étape 2 : Configurer le convertisseur CSV2JSON Azure Function

1. Dans votre navigateur connecté au portail Azure, ouvrez l’URL du référentiel GitHub - https://github.com/joelbyford/CSVtoJSONcore.

2. Sélectionnez le lien « Déployer sur Azure » pour déployer cette fonction Azure sur votre locataire Azure.

3. Spécifiez le groupe de ressources dans lequel vous souhaitez déployer la fonction.

   Si vous obtenez l’erreur « Cette région a un quota de 0 instance », essayez de sélectionner une autre région.

4. Vérifiez que le déploiement de la fonction Azure en tant qu’App Service aboutit.

5. Accédez au groupe de ressources et ouvrez la configuration de l’application web. Vérifiez que son état est « En cours d’exécution ». Copiez le nom de domaine par défaut associé à l’application web.

6. Exécutez le script PowerShell suivant pour tester si le point de terminaison CSVtoJSON fonctionne correctement. Définissez les variables $csvFilePath et $uri sur les bonnes valeurs dans le 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 le déploiement de la fonction Azure aboutit, la dernière ligne du script renvoie la version JSON du fichier CSV.

   .

8. Pour permettre à Logic Apps d’appeler la fonction Azure, accédez aux paramètres CORS de l’application web, entrez un astérisque (*) et enregistrez la configuration.

Étape 3 : Configurer le provisionnement d’utilisateurs entrant piloté par l’API

• Configurez le provisionnement d’utilisateurs entrant piloté par l’API.

Étape 4 : Configurer votre workflow Azure Logic Apps

1. Sélectionnez le bouton ci-dessous pour déployer le modèle Azure Resource Manager pour le flux de travail CSV2SCIMBulkUpload Logic Apps.

   

2. Sous la section des informations sur l’instance, mettez à jour les champs en surbrillance en copiant-collant les valeurs obtenues lors des étapes précédentes.

3. Pour le paramètre Azurefile_access Key, accédez à votre compte de stockage Azure et copiez la clé d’accès située dans la section « Sécurité et mise en réseau ».
   

4. Sélectionnez l’option « Vérifier et créer » pour démarrer le déploiement.

5. Une fois le déploiement terminé, le message suivant s’affiche.

Étape 5 : Configurer une identité managée affectée par le système

1. Accédez à Paramètres -> Identité dans votre workflow Logic Apps.
2. Activez l’identité managée affectée par le système.
3. Une invite de confirmation s’affiche pour valider l’activation de l’identité managée. Sélectionnez Oui.
4. Accordez à l’identité managée les autorisations nécessaires pour effectuer un chargement en bloc.

Étape 6 : Passer en revue et ajuster les étapes du workflow

1. Ouvrez l’application logique dans la vue du concepteur.

2. Passez en revue la configuration de chaque étape du flux de travail pour vous assurer qu’elle est correcte.

3. Ouvrez l’étape « Get file content using path » (Obtenir le contenu du fichier à l’aide du chemin) et modifiez le chemin pour qu’il pointe vers le stockage de fichiers Azure dans votre locataire.

4. Mettez à jour la connexion si nécessaire.

5. Assurez-vous que l’étape « Convert CSV to JSON » (Convertir CSV en JSON) pointe vers la bonne instance d’application web de la fonction Azure.

6. Si le contenu ou les en-têtes du fichier CSV sont différents, modifiez l’étape « Parse JSON » avec la sortie JSON obtenue suite à votre appel d’API à la fonction Azure. Utilisez la sortie PowerShell de l’étape 2.

7. À l’étape « Construct SCIMUser », vérifiez que les champs de votre fichier CSV sont correctement mappés aux attributs SCIM à utiliser pour le traitement.

   

8. À l’étape « Envoyer SCIMBulkPayload au point de terminaison d’API », vérifiez que vous utilisez le bon point de terminaison d’API et le mécanisme d’authentification.

   

Étape 7 : Exécuter le déclencheur et tester le workflow Logic Apps

1. Dans la version « Disponibilité générale » du concepteur Logic Apps, sélectionnez le déclencheur d’exécution pour exécuter manuellement le flux de travail.
2. Une fois l’exécution terminée, examinez l’action que Logic Apps a effectuée dans chaque itération.
3. Dans l’itération finale, les données de chargement de Logic Apps vers le point de terminaison de l’API de provisionnement entrant doivent s’afficher. Recherchez code d’état 202 Accept. Vous pouvez copier-coller et vérifier la requête de chargement en bloc.

Étapes suivantes

• Résolution des problèmes liés à l’API de provisionnement entrant
• Concepts de provisionnement entrant piloté par API
• Questions fréquentes sur l’approvisionnement entrant piloté par l'API