Schnellstart: API-gesteuerte eingehende Bereitstellung mit cURL

Artikel
02/28/2024

Einführung

cURL ist ein beliebtes, kostenloses Open-Source-Befehlszeilentool, das von API-Entwickler*innen verwendet wird und standardmäßig unter Windows 10/11 verfügbar ist. In diesem Tutorial wird beschrieben, wie Sie die API-gesteuerte eingehende Bereitstellung mit cURL schnell testen können.

Voraussetzungen

Sie haben die API-gesteuerte eingehende Bereitstellungs-App konfiguriert.
Sie haben einen Dienstprinzipal mit Zugriff auf die API für die eingehende Bereitstellung konfiguriert. Notieren Sie die ClientId- und ClientSecret-Werte Ihrer Dienstprinzipal-App zur Verwendung in diesem Tutorial.

Hochladen von Benutzerdaten in die API für die eingehende Bereitstellung

Rufen Sie client_id und client_secret des Dienstprinzipals ab, der Zugriff auf die API für die eingehende Bereitstellung hat.
Verwenden Sie OAuth client_credentials-Gewährungsflow, um ein Zugriffstoken abzurufen. Ersetzen Sie die Variablen [yourClientId], [yourClientSecret] und [yourTenantId] durch Werte, die für Ihr Setup gelten, und führen Sie den folgenden cURL-Befehl aus. Kopieren des Werts des generierten Zugriffstoken
```
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"
```
Kopieren Sie die Massenanforderung mit dem Schema für SCIM-Enterprise-Benutzer*innen, und speichern Sie den Inhalt in einer Datei namens scim-bulk-upload-users.json.
Ersetzen Sie die Variable [InboundProvisioningAPIEndpoint] durch den Bereitstellungs-API-Endpunkt, der Ihrer Bereitstellungs-App zugeordnet ist. Verwenden Sie den [AccessToken]-Wert aus dem vorherigen Schritt, und führen Sie den folgenden curl-Befehl aus, um die Massenanforderung an den Bereitstellungs-API-Endpunkt hochzuladen.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Nach erfolgreichem Upload erhalten Sie den HTTP 202 Accepted-Antwortcode.
Der Bereitstellungsdienst beginnt sofort mit der Verarbeitung der Massenanforderungsnutzlast, und Sie können die Bereitstellungsdetails anzeigen, indem Sie auf die Bereitstellungsprotokolle der eingehenden Bereitstellungs-App zugreifen.

Überprüfen der Verarbeitung der Massenanforderungsnutzlast

Melden Sie sich beim Microsoft Entra Admin Center mindestens als Anwendungsadministrator an.
Navigieren Sie zu Microsoft Entra ID –> Anwendungen –> Unternehmensanwendungen.
Verwenden Sie unter allen Anwendungen das Suchfilter-Textfeld, um Ihre API-gesteuerte Bereitstellungsanwendung zu suchen und zu öffnen.
Öffnen Sie das Blatt „Bereitstellung“. Die Landing Page zeigt den Status der letzten Ausführung an.
Klicken Sie auf Bereitstellungsprotokolle anzeigen, um das Blatt „Bereitstellungsprotokolle“ zu öffnen. Alternativ können Sie auf die Menüoption Überwachen –> Bereitstellungsprotokolle klicken.
Klicken Sie in den Bereitstellungsprotokollen auf einen beliebigen Datensatz, um weitere Verarbeitungsdetails anzuzeigen.
Auf dem Bildschirm mit den Details des Bereitstellungsprotokolls werden alle Schritte angezeigt, die für einen bestimmten Benutzer ausgeführt werden.
- Sehen Sie sich im Schritt Importieren aus API Details zu den Benutzerdaten an, die aus der Massenanforderung extrahiert wurden.
- Der Schritt Abgleichen der Benutzer zeigt Details zu jeder Benutzerabgleichung basierend auf dem übereinstimmenden Bezeichner an. Wenn eine Benutzerübereinstimmung auftritt, führt der Bereitstellungsdienst einen Aktualisierungsvorgang aus. Wenn keine Benutzerübereinstimmung vorhanden ist, führt der Bereitstellungsdienst einen Erstellungsvorgang aus.
- Der Schritt Ermitteln, ob sich der Benutzer im Bereich befindet, zeigt Details zur Bereichsfilterauswertung an. Standardmäßig werden alle Benutzer verarbeitet. Wenn Sie einen Bereichsfilter festgelegt haben (z. B. nur Benutzer verarbeiten, die zur Vertriebsabteilung gehören), werden in diesem Schritt die Auswertungsdetails des Bereichsfilters angezeigt.
- Der Schritt Bereitstellen des Benutzers ruft den letzten Verarbeitungsschritt und die auf das Benutzerkonto angewendeten Änderungen auf.
- Verwenden Sie die Registerkarte Geänderte Eigenschaften, um Attributupdates anzuzeigen.

Anhang

Sehen Sie sich diesen Abschnitt an, um Informationen zur Massenanforderung mit SCIM Enterprise User Schema zu erfahren.

Massenanforderung mit Schema für SCIM-Enterprise-Benutzer

Die unten gezeigte Massenanforderung verwendet die SCIM-Standardschemas „Core User“ und „Enterprise User“.

Anforderungstext

{
    "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
}

Teilen über