Approvisionnement entrant piloté par l’API avec l’Explorateur Graph

Ce tutoriel explique comment tester rapidement le provisionnement entrant piloté par l’API avec l’Explorateur Microsoft Graph.

Prerequisite

• Vous avez configuré l’application d’approvisionnement entrante pilotée par l’API.

Charger des données utilisateur vers l’API d’approvisionnement entrant

1. Ouvrez une nouvel onglet ou une nouvelle fenêtre de navigateur.

2. Lancez l’URL https://aka.ms/ge pour accéder à l’Explorateur graphique Microsoft.

3. Sélectionnez l’icône de profil utilisateur pour vous connecter.

   

4. Terminez le processus de connexion avec un compte d’utilisateur disposant d’un accès au rôle Administrateur d’utilisateur .

5. Une fois la connexion établie, les informations relatives au locataire affichent votre nom de locataire.

   

   Vous êtes maintenant prêt à appeler l’API.

6. Dans le panneau de requête d’API, définissez le type de requête HTTP sur POST.

7. Copiez et collez le point de terminaison de l’API d’approvisionnement récupéré à partir de la page vue d’ensemble de l’application d’approvisionnement.

8. Dans le panneau En-têtes de requête, ajoutez une nouvelle paire de valeurs de clé de Content-Type = application/scim+json.

9. Sous le panneau Corps de la demande , copiez-collez la requête en bloc avec le schéma utilisateur SCIM Enterprise

10. Sélectionnez le bouton Exécuter la requête pour envoyer la requête au point de terminaison de l’API d’approvisionnement.

11. Si la requête est envoyée avec succès, vous recevrez une réponse Accepted 202 du point de terminaison de l’API.

12. Ouvrez le panneau En-têtes Réponse et copiez la valeur d’URL de l’attribut d’emplacement. Cela pointe vers le point de terminaison de l'API des journaux d’approvisionnement que vous pouvez interroger pour vérifier l’état d’approvisionnement des utilisateurs présents dans la demande en bloc.

Vérifiez le traitement de la charge utile de la requête groupée

Vous pouvez vérifier le traitement soit à partir du centre d'administration Microsoft Entra, soit à l'aide de l'Explorateur graphique.

Vérifier le traitement sur le centre d’administration Microsoft Entra

1. Connectez-vous au Centre d’administration Microsoft Entra avec au moins les informations d’identification de connexion de l’administrateur d’application .

2. Parcourez Entra ID>Applications d’entreprise.

3. Sous Toutes les applications, utilisez la zone de filtre de recherche pour rechercher et ouvrir votre application d'approvisionnement pilotée par l'API.

4. Ouvrez le panneau Provisionnement. La page d’accueil affiche l’état de la dernière exécution.

5. Sélectionnez Afficher les journaux d’approvisionnement pour ouvrir le panneau Journaux d’approvisionnement. Vous pouvez également sélectionner l’option de menu Surveiller les>journaux d’approvisionnement.

   

6. Sélectionnez un enregistrement dans les journaux d’approvisionnement pour afficher des détails de traitement supplémentaires.

7. L’écran des détails du journal d’approvisionnement affiche toutes les étapes exécutées pour un utilisateur spécifique.

   • Sous l’étape Importer à partir de l’API , consultez les détails des données utilisateur extraites de la requête en bloc.
   • L’étape de correspondance d'utilisateur affiche les détails de toute correspondance d'utilisateur en fonction de l’identificateur correspondant. Si une correspondance utilisateur est trouvée, le service d’approvisionnement effectue une opération de mise à jour. S’il n’y a pas de correspondance utilisateur, le service d’approvisionnement effectue une opération de création.
   • La phase Déterminer si l'utilisateur est dans le périmètre montre les détails de l'évaluation du filtre de portée. Par défaut, tous les utilisateurs sont traités. Si vous définissez un filtre d’étendue (par exemple, traitez uniquement les utilisateurs appartenant au service Ventes), les détails d’évaluation du filtre d’étendue s’affichent à cette étape.
   • L’étape Provisionner l’utilisateur appelle l’étape de traitement finale et les modifications appliquées au compte d’utilisateur.
   • Utilisez l’onglet Propriétés modifiées pour afficher les mises à jour des attributs.

Vérifier le traitement à l’aide de l’API de journaux d’approvisionnement dans l’Explorateur graphique

Vous pouvez inspecter le traitement à l’aide de l’URL de l’API de journaux d’approvisionnement retournée dans l’en-tête de réponse de localisation dans l’appel d’API d’approvisionnement.

1. Dans l'Explorateur Graph, dans la zone de texte URL de requête, copiez-collez l'URL de localisation retournée par le point de terminaison de l'API de provisionnement ou vous pouvez la construire en utilisant le format suivant : https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>', en récupérant le jobId à partir de la page de vue d'ensemble de l'application de provisionnement.
2. Utilisez la méthode GET et sélectionnez Exécuter la requête pour récupérer les journaux d’approvisionnement. Par défaut, la réponse renvoyée contient tous les enregistrements du journal.
3. Vous pouvez définir d'autres filtres pour ne récupérer que les données postérieures à une certaine période ou ayant une valeur d'état spécifique. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z Vous pouvez également vérifier l’état de l’utilisateur à l'aide de la valeur externalId utilisée dans votre système source qui est utilisée comme propriété d’ancrage/de jonction source. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Appendix

Demande en bloc avec le schéma utilisateur Entreprise SCIM

La demande en bloc qui suit utilise le schéma de l'utilisateur de base et de l'utilisateur d'entreprise selon la norme SCIM.

Request body

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Universal City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91608",
              "country": "USA",
              "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}

Next steps

• Résoudre les problèmes liés à l’API d’approvisionnement entrant
• Questions fréquentes sur le provisionnement entrant basé sur l'API
• Démarrage rapide à l’aide de PowerShell
• Démarrage rapide à l’aide d’Azure Logic Apps