ACS-Verwaltungsdienst

  • Artikel

Aktualisiert: 19. Juni 2015

Gilt für: Azure

Gilt für:

Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS)

Zusammenfassung

ACS Management Service ist eine ACS-Komponente, mit der Sie die Einstellungen in einem Access Control-Namespace programmgesteuert verwalten und konfigurieren können. Sie können den ACS-Verwaltungsdienst als Alternative oder Ergänzung zum ACS-Verwaltungsportal verwenden, das eine Grafikschnittstelle für ACS bereitstellt.

In diesem Thema wird Folgendes erläutert:

  • Wie der ACS-Verwaltungsdienst in die allgemeine ACS-Architektur passt

  • Wenn es geeignet ist, den ACS-Verwaltungsdienst zu verwenden, um ACS-Einstellungen zu konfigurieren

  • So verwenden Sie den ACS-Verwaltungsdienst am effektivsten

Übersicht

Sie können das ACS-Verwaltungsdienst- und Open Data-Protokoll (OData) verwenden, um die ACS-Komponenten in einem Access Control Namespace programmgesteuert zu verwalten und zu konfigurieren.

Das folgende Diagramm veranschaulicht die Komponenten von ACS und deren Beziehungen.

ACS v2 Management Service

Die programmgesteuerte Verwaltung kann in den folgenden aufgeführten Szenarien besonders effektiv sein.

  • Hinzufügen neuer Mandanten zu einem SaaS-Dienst Wenn Sie über ein Software-as-a-Service-Produkt verfügen, z. B. Office 365, können Sie Code schreiben, der ausgeführt wird, wenn sich ein neuer Kunde für Ihren Dienst anmeldet. Der Code funktioniert mit dem ACS-Verwaltungsdienst, um den neuen Mandanten für den Identitätsanbieter zu konfigurieren, den sie auswählen. Ein Arbeitsbeispiel für SaaS-Anwendungscode, der neue Mandanten zu ACS hinzufügt, finden Sie unter https://www.fabrikamshipping.com/.

  • Bereitstellen von Lösungen – Wenn Sie neue Lösungen bereitstellen, können Sie eine benutzerdefinierte Aufgabe hinzufügen, um ACS als Teil der Bereitstellung zu konfigurieren. Der ACS-Verwaltungsdienst kann Ihnen helfen, die Bereitstellung zu automatisieren und manuelle Konfigurationsaufgaben zu minimieren, nachdem die Anwendung bereitgestellt wurde.

  • Benutzerdefinierte Benutzeroberfläche – Sie können das ACS-Verwaltungsportal verwenden, eine webbasierte Benutzeroberfläche, die in ihrer eigenen Domäne gehostet wird, um ACS-Komponenten zu verwalten und zu konfigurieren. Wenn die Benutzeroberfläche jedoch erneut in eine größere Verwaltungskonsole eingebettet oder über nicht webbasierte Benutzeroberfläche verfügbar gemacht wird, können Sie den ACS-Verwaltungsdienst verwenden, um Ihre ACS-Einstellungen zu verwalten und zu konfigurieren.

  • Zusätzliche Features Obwohl die meisten Aufgaben im ACS-Verwaltungsportal ausgeführt werden können, stehen einige nur mithilfe des ACS-Verwaltungsdiensts zur Verfügung. Sie können beispielsweise benutzerdefinierte OpenID-Identitätsanbieter nur mithilfe des ACS-Verwaltungsdiensts hinzufügen.

Zugreifen auf den ACS 2.0-Verwaltungsdienst

Um auf den ACS-Verwaltungsdienst für einen bestimmten Access Control Namespace zuzugreifen, müssen Sie die Verwaltungsdienst-Endpunkt-URL für den OData-Client bereitstellen.

Um die URL des Verwaltungsdienst-Endpunkts für einen Access Control-Namespace zu finden, verwenden Sie die folgende Prozedur.

  1. Wechseln Sie zum Microsoft Azure Verwaltungsportal (https://manage.WindowsAzure.com), melden Sie sich an, und klicken Sie dann auf Active Directory. (Problembehandlungstipps: Das Element "Active Directory" fehlt oder nicht verfügbar)

  2. Um einen Namespace für die Zugriffssteuerung zu verwalten, wählen Sie den Namespace aus und klicken Sie dann auf Verwalten. (Oder klicken Sie auf Namespaces für die Zugriffssteuerung, wählen Sie den Namespace aus und klicken Sie dann auf Verwalten.)

  3. Klicken Sie auf Verwaltungsdienst.

    Die URL wird im Abschnitt Management-Dienst-URL der Seite angezeigt.

Das Format für eine Endpunkt-URL ist https://< Namespace.accesscontrol.windows.net/v2/mgmt/service>, bei dem Namespace der Name Ihres Access Control Namespace ist.

Der ACS-Verwaltungsdienst verwendet ACS für die Authentifizierung. ACS akzeptiert eine in OAuth WRAP-Protokoll ausgestellte Verwaltungsanmeldeinformationen und stellt als Antwort ein SWT-Token für den Client bereit. Das SWT-Token ist für den Zugriff auf den ACS-Verwaltungsdienst erforderlich.

Verwenden Sie eine der folgenden Kontoanmeldeinformationen, um sich beim ACS-Verwaltungsdienst zu authentifizieren:

Sie können Verwaltungsdienstkonten mit allen diesen Anmeldeinformationentypen im ACS-Verwaltungsportal hinzufügen und konfigurieren. Weitere Informationen finden Sie im ACS-Verwaltungsportal.

Datenentitäten des ACS 2.0-Verwaltungsdiensts

Ein Entitätsdatenmodell organisiert die Konfigurationsdaten in Form von Datensätzen für Entitätstypen (oder Entitäten) sowie die Zuordnungen zwischen ihnen. Das Datenmodell für jeden Access Control Namespace wird im OData-Dienstmetadatendokument beschrieben, das unter: https://< namespace.accesscontrol.windows.net>/v2/mgmt/service/$metadata, wobei <Namespace> der Name des Access Control-Namespace ist.

Dieses XML-Dokument verwendet eine CDSL (Conceptual Schema Definition Language) zum Beschreiben des Entitätsmoduls. Sie können dieses Dokument herunterladen und dann zum Generieren typisierter Klassen in Ihrem Code verwenden.

Weitere Informationen zu den ACS-Entitätstypen und ihren Eigenschaften finden Sie unter ACS Management Service API Reference.

Standarddaten der Entität

Jeder Access Control-Namespace enthält Standardkonfigurationsdaten, die dem ACS-Verwaltungsdienst verfügbar gemacht werden, aber im ACS-Verwaltungsportal nicht verfügbar sind. Diese Konfigurationsdaten werden in der Regel intern vom Access Control-Namespace verwendet und sind nicht mit benutzerdefinierten vertrauenden Parteienanwendungen verknüpft. Diese Daten umfassen Folgendes:

  • AccessControlManagement-Anwendung mit vertrauenden Parteien – Stellt das ACS-Verwaltungsportal und den ACS-Verwaltungsdienst dar, der vertrauende Parteien des Access Control-Namespaces darstellt.

  • AccessControlManagement-Regelgruppe und -Regeln – Enthält die Zugriffsregeln für das ACS-Verwaltungsportal und den ACS-Verwaltungsdienst. Sie können die Regeln und Regelgruppen im ACS-Verwaltungsportal konfigurieren.

  • Windows Live ID-Identitätsanbieter und Aussteller – Stellt Windows Live ID (Microsoft-Konto), den Standardidentitätsanbieter und den Aussteller dar. Dieser Identitätsanbieter kann nicht gelöscht werden, da er von der AccessControlManagement-vertrauenden Partei für die Authentifizierung auf das ACS-Verwaltungsportal verwendet wird.

  • LOCAL_AUTHORITY Aussteller – Aussteller, der im ACS-Regelmodul für die Anspruchsausgabe von ACS verwendet wird.

Weitere Informationen

Aufgaben

Codebeispiel: Verwaltungsdienst

Konzepte

ACS 2.0-Komponenten
Referenz zur ACS-Verwaltungsdienst-API
Vorgehensweise: Anfordern eines Token von ACS über das OAuth WRAP-Protokoll
Vorgehensweise: Verwenden des ACS-Verwaltungsdiensts zum Konfigurieren von Facebook als Internet Identity Provider
Vorgehensweise: Verwenden des ACS-Verwaltungsdiensts zum Konfigurieren von AD FS 2.0 als Enterprise Identitätsanbieter
Vorgehensweise: Verwenden des ACS-Verwaltungsdiensts zum Konfigurieren eines OpenID-Identitätsanbieters

Weitere Ressourcen

https://www.fabrikamshipping.com/