Tutorial: Entwickeln eines SCIM-Beispielendpunkts in Microsoft Entra ID

In diesem Tutorial wird beschrieben, wie Sie den SCIM-Referenzcode mit Azure App Service bereitstellen. Testen Sie dann den Code mit einem Tool wie cURL oder durch Integration mit dem Microsoft Entra-Bereitstellungsdienst. Dieses Tutorial richtet sich an Entwickler, die mit SCIM beginnen möchten, und an andere Benutzer, die einen SCIM-Endpunkt testen möchten.

In diesem Tutorial lernen Sie Folgendes:

• Bereitstellen Ihres SCIM-Endpunkts in Azure.
• Testen Ihres SCIM-Endpunkts.

Bereitstellen Ihres SCIM-Endpunkts in Azure

In den folgenden Schritten wird der SCIM-Endpunkt mithilfe von Visual Studio 2019 und Visual Studio Code mit Azure App Service. Der SCIM-Referenzcode kann lokal ausgeführt, von einem lokalen Server gehostet oder für einen anderen externen Dienst bereitgestellt werden. Informationen zum Bereitstellen eines SCIM-Endpunkts finden Sie unter Tutorial: Entwickeln und Planen der Bereitstellung für einen SCIM-Endpunkt.

Bereitstellen der Beispiel-App

Navigieren Sie in GitHub zum Referenzcode, und wählen Sie Klonen oder herunterladen aus. Wählen Sie Auf Desktop öffnen aus, oder kopieren Sie den Link, öffnen Sie Visual Studio, und wählen Sie Code klonen oder auschecken aus, um den kopierten Link einzugeben und eine lokale Kopie zu erstellen. Speichern Sie die Dateien in einem Ordner, in dem die Gesamtlänge des Pfads 260 oder weniger Zeichen beträgt.

Visual Studio

1. Stellen Sie sicher, dass Sie sich in Visual Studio bei dem Konto anmelden, das Zugriff auf Ihre Hostingressourcen hat.

2. Öffnen Sie im Projektmappen-Explorer Microsoft.SCIM.sln, und klicken Sie mit der rechten Maustaste auf die Datei Microsoft.SCIM.WebHostSample. Klicken Sie auf Veröffentlichen.

   

   Hinweis

   Um diese Projektmappe lokal auszuführen, doppelklicken Sie auf das Projekt, und wählen Sie IIS Express aus, um das Projekt als Webseite mit einer URL für einen lokalen Host zu starten. Weitere Informationen finden Sie unter Übersicht über IIS Express.

3. Wählen Sie Profil erstellen aus, und stellen Sie sicher, dass App Service und Neu erstellen ausgewählt sind.

   

4. Durchlaufen Sie die Dialogfeldoptionen, und benennen Sie die App nach Wunsch. Dieser Name wird sowohl in der App als auch in der SCIM-Endpunkt-URL verwendet.

   

5. Wählen Sie die zu verwendende Ressourcengruppe und dann Veröffentlichen aus.

   

Visual Studio Code

1. Stellen Sie sicher, dass Sie sich in Visual Studio Code bei dem Konto anmelden, das Zugriff auf Ihre Hostingressourcen hat.

2. Öffnen Sie in Visual Studio Code den Ordner, der die Datei Microsoft.SCIM.sln enthält.

3. Öffnen Sie das integrierte Visual Studio Code-Terminal, und führen Sie den dotnet restore Befehl aus. Mit diesem Befehl werden die in den Projektdateien aufgeführten Pakete wiederhergestellt.

4. Ändern Sie im Terminal das Verzeichnis mithilfe des cd Microsoft.SCIM.WebHostSample Befehls

5. Um Ihre App lokal auszuführen, führen Sie im Terminal den .NET-CLI-Befehl aus. Die dotnet-Ausführung führt das Microsoft.SCIM.WebHostSample-Projekt mithilfe der Entwicklungsumgebung aus.

   dotnet run --environment Development
   

6. Wenn sie nicht installiert ist, fügen Sie Azure App Service für die Visual Studio Code-Erweiterung hinzu.

7. Um die Microsoft.SCIM.WebHostSample-App für Azure-App Services bereitzustellen, erstellen Sie eine neue App Services.

8. Führen Sie im Visual Studio Code-Terminal den .NET-CLI-Befehl aus. Dieser Befehl generiert einen bereitstellungsfähigen Veröffentlichungsordner für die App im Verzeichnis bin/debug/publish.

   dotnet publish -c Debug
   

9. Klicken Sie im Visual Studio Code-Explorer mit der rechten Maustaste auf den generierten Veröffentlichungsordner, und wählen Sie In Web-App bereitstellen aus.

10. In der Befehlspalette am oberen Bildschirmrand öffnet sich ein neuer Workflow. Wählen Sie das Abonnement aus, in dem Sie Ihre App veröffentlichen möchten.

11. Wählen Sie die zuvor erstellte App Service-Web-App aus.

12. Wenn Visual Studio Code Sie zum Bestätigen auffordert, klicken Sie auf Bereitstellen. Der Bereitstellungsvorgang kann einige Sekunden in Anspruch nehmen. Wenn der Vorgang abgeschlossen ist, sollte eine Benachrichtigung in der unteren rechten Ecke angezeigt werden, die Sie auffordert, zur bereitgestellten App zu navigieren.

Konfigurieren von App Service

Navigieren Sie in Azure App Service>Konfiguration zu Ihrer Anwendung, und wählen Sie Neue Anwendungseinstellung aus, um die Einstellung Token__TokenIssuer mit dem Wert https://sts.windows.net/<tenant_id>/ hinzuzufügen. Ersetzen Sie <tenant_id> mit Ihrer Microsoft Entra-Mandanten-ID.

Wenn Sie den Endpunkt mit einer Unternehmensanwendung im Microsoft Entra Admin Center testen, stehen Ihnen zwei Optionen zur Verfügung. Sie können die Umgebung in beibehalten Development und das Testtoken vom /scim/token-Endpunkt bereitstellen oder die Umgebung in Production ändern und das Tokenfeld leer lassen.

Das ist alles! Der SCIM-Endpunkt ist nun veröffentlicht und ermöglicht Ihnen die Verwendung der Azure App Service-URL zum Testen des SCIM-Endpunkts.

Testen Ihres SCIM-Endpunkts

Anforderungen an einen SCIM-Endpunkt erfordern eine Autorisierung. Im SCIM-Standard sind mehrere Optionen verfügbar. Anfragen können Cookies, Basisauthentifizierung, TLS-Client-Authentifizierung oder eine der in RFC 7644 aufgeführten Methoden verwenden.

Vermeiden Sie unbedingt unsichere Methoden wie Benutzername und Kennwort, sondern verwenden Sie eine sichere Methode wie OAuth. Microsoft Entra ID unterstützt Bearertoken mit langer Gültigkeitsdauer (für Kataloganwendungen und andere Anwendungen) und die OAuth-Autorisierungsgewährung (für Kataloganwendungen).

Hinweis

Die im Repository bereitgestellten Autorisierungsmethoden dienen nur zu Testzwecken. Bei der Integration in Microsoft Entra ID können Sie die Autorisierungsanleitung lesen. Weitere Informationen finden Sie unter Planen der Bereitstellung für einen SCIM-Endpunkt.

Die Entwicklungsumgebung ermöglicht Features, die in einer Produktionsumgebung zu unsicher wären, z. B. Referenzcode zum Steuern der Überprüfung von Sicherheitstoken. Der Code zur Überprüfung von Token verwendet ein selbstsigniertes Token, und der Signierungsschlüssel ist in der Konfigurationsdatei gespeichert. Beispiel: Token:IssuerSigningKey-Parameter in der Datei appsettings.Development.js.

"Token": {
    "TokenAudience": "Microsoft.Security.Bearer",
    "TokenIssuer": "Microsoft.Security.Bearer",
    "IssuerSigningKey": "A1B2C3D4E5F6A1B2C3D4E5F6",
    "TokenLifetimeInMins": "120"
}

Hinweis

Wenn Sie eine GET-Anforderung an den /scim/token-Endpunkt senden, wird ein Token mithilfe des konfigurierten Schlüssels ausgegeben. Dieses Token kann als Bearertoken für die nachfolgende Autorisierung verwendet werden.

Der Standardcode zur Tokenvalidierung ist für die Verwendung eines von Microsoft Entra ID ausgestellten Tokens konfiguriert. Außerdem muss der ausstellende Mandant mithilfe des Token:TokenIssuer-Parameters in der Datei appsettings.json konfiguriert sein.

"Token": {
    "TokenAudience": "8adf8e6e-67b2-4cf2-a259-e3dc5476c621",
    "TokenIssuer": "https://sts.windows.net/<tenant_id>/"
}

Nächste Schritte

• Tutorial: Überprüfen eines SCIM-Endpunkts
• Tutorial: Entwickeln eines SCIM-Endpunkts und Planen seiner Bereitstellung
• Tutorial: Konfigurieren der Bereitstellung für eine Katalog-App