Anwendungs- und Dienstprinzipalobjekte in Microsoft Entra ID
In diesem Artikel werden die Anwendungsregistrierung, Anwendungsobjekte und Dienstprinzipale in Microsoft Entra ID mit ihren Eigenschaften, Verwendungsmöglichkeiten und den wechselseitigen Beziehungen beschrieben. Außerdem wird ein Beispielszenario mit mehreren Mandanten vorgestellt, um die Beziehung zwischen dem Anwendungsobjekt einer Anwendung und den entsprechenden Dienstprinzipalobjekten zu veranschaulichen.
Anwendungsregistrierung
Um Identitäts- und Zugriffsverwaltungsfunktionen an Microsoft Entra ID zu delegieren, muss eine Anwendung bei einem Microsoft Entra-Mandanten registriert sein. Wenn Sie Ihre Anwendung bei Microsoft Entra ID registrieren, erstellen Sie eine Identitätskonfiguration für Ihre Anwendung, die deren Integration in Microsoft Entra ID ermöglicht. Beim Registrieren einer App wählen Sie aus, ob es sich um eine Einzelinstanz-App oder eine mehrinstanzenfähige App handelt. Optional können Sie außerdem einen Umleitungs-URI festlegen. Eine ausführliche Anleitung zum Registrieren einer App finden Sie im Schnellstart zur App-Registrierung.
Wenn Sie die App-Registrierung abgeschlossen haben, verfügen Sie über eine global eindeutige Instanz der App (das Anwendungsobjekt), die sich in Ihrem Basismandanten oder -verzeichnis befindet. Außerdem verfügen Sie über eine global eindeutige ID für Ihre App (App- oder Client-ID). Darüber hinaus können Sie geheime Clientschlüssel oder Zertifikate und Geltungsbereiche hinzufügen, damit Ihre App funktioniert, das Branding Ihrer App im Anmeldedialogfeld anpassen und vieles mehr.
Wenn Sie eine Anwendung registrieren, werden automatisch ein Anwendungsobjekt und ein Dienstprinzipalobjekt in Ihrem Basismandanten erstellt. Wenn Sie eine Anwendung mit den Microsoft Graph-APIs registrieren/erstellen, wird das Dienstprinzipalobjekt in einem separaten Schritt erstellt.
Anwendungsobjekt
Eine Microsoft Entra-Anwendung wird durch ein einziges, eindeutiges Anwendungsobjekt definiert, das sich im Microsoft Entra-Mandanten befindet, bei dem die Anwendung registriert wurde (der sogenannte Basis-Mandant der Anwendung). Ein Anwendungsobjekt wird als Vorlage bzw. Blaupause zum Erstellen eines oder mehrerer Dienstprinzipalobjekte verwendet. Ein Dienstprinzipal wird in jedem Mandanten erstellt, in dem die Anwendung verwendet wird. Vergleichbar einer Klasse in der objektorientierten Programmierung hat das Anwendungsobjekt einige statische Eigenschaften, die auf alle erstellten Dienstprinzipale (oder Anwendungsinstanzen) angewendet werden.
Das Anwendungsobjekt beschreibt drei Aspekte einer Anwendung:
- Die Möglichkeit des Diensts zum Ausstellen von Token für den Zugriff auf die Anwendung
- Die Ressourcen, auf die die Anwendung möglicherweise zugreifen muss
- Die Aktionen, die die Anwendung ausführen kann
Sie können die Seite App-Registrierungen im Microsoft Entra Admin Center verwenden, um die Anwendungsobjekte in Ihrem Basismandanten aufzulisten und zu verwalten.
Die Application-Entität von Microsoft Graph definiert das Schema für die Eigenschaften eines Anwendungsobjekts.
Dienstprinzipalobjekt
Um auf Ressourcen zugreifen zu können, die von einem Microsoft Entra-Mandanten geschützt werden, muss die Entität, die Zugriff benötigt, durch einen Sicherheitsprinzipal dargestellt werden. Diese Anforderung gilt für Benutzer (Benutzerprinzipal) und Anwendungen (Dienstprinzipal). Der Sicherheitsprinzipal definiert die Zugriffsrichtlinie und Berechtigungen für den Benutzer/die Anwendung im Microsoft Entra-Mandanten. Dies aktiviert die Kernfunktionen wie die Authentifizierung des Benutzers/der Anwendung während der Anmeldung und die Autorisierung beim Zugriff auf Ressourcen.
Es stehen drei Arten von Dienstprinzipalen zur Verfügung:
Anwendung: Dieser Dienstprinzipaltyp ist die lokale Darstellung (bzw. Anwendungsinstanz) eines globalen Anwendungsobjekts in einem einzelnen Mandanten oder Verzeichnis. In diesem Fall ist der Dienstprinzipal eine konkrete Instanz, die aus dem Anwendungsobjekt erstellt wird und bestimmte Eigenschaften von diesem Anwendungsobjekt erbt. Ein Dienstprinzipal wird in jedem Mandanten erstellt, in dem die Anwendung verwendet wird, und verweist auf das global eindeutige Anwendungsobjekt. Das Dienstprinzipalobjekt definiert, was die App tatsächlich im jeweiligen Mandanten ausführen kann, wer auf die App zugreifen kann und auf welche Ressourcen die App zugreifen kann.
Wenn eine Anwendung die Berechtigung zum Zugriff auf Ressourcen in einem Mandanten erhält (bei der Registrierung oder Zustimmung), wird ein Dienstprinzipalobjekt erstellt. Wenn Sie eine Anwendung registrieren, wird ein Dienstprinzipal automatisch erstellt. Sie können auch mit Azure PowerShell, der Azure-Befehlszeilenschnittstelle, Microsoft Graph und mit anderen Tools Dienstprinzipalobjekte in einem Mandanten erstellen.
Verwaltete Identität: Dieser Dienstprinzipaltyp repräsentiert eine verwaltete Identität. Dank verwalteter Identitäten müssen Entwickler keine Anmeldeinformationen mehr verwalten. Verwaltete Identitäten stellen eine Identität bereit, mit deren Hilfe Anwendungen eine Verbindung mit Ressourcen herstellen können, welche die Microsoft Entra-Authentifizierung unterstützen. Wenn eine verwaltete Identität aktiviert ist, wird in Ihrem Mandanten ein Dienstprinzipal erstellt, der diese verwaltete Identität repräsentiert. Dienstprinzipale, die verwaltete Identitäten repräsentieren, können Zugriff und Berechtigungen erhalten, sie können jedoch nicht direkt aktualisiert oder geändert werden.
Legacy: Dieser Dienstprinzipaltyp repräsentiert eine Legacy-App. Bei einer Legacy-App handelt es sich um eine App, die vor der Einführung von App-Registrierungen oder über eine Legacybenutzeroberfläche erstellt wurde. Ein Legacydienstprinzipal kann Anmeldeinformationen, Dienstprinzipalnamen, Antwort-URLs und andere Eigenschaften aufweisen, die von einem autorisierten Benutzer bearbeitet werden können. Dieser Dienstprinzipaltyp kann jedoch keiner App-Registrierung zugeordnet werden. Ein Legacydienstprinzipal kann nur in dem Mandanten verwendet werden, in dem er erstellt wurde.
Die ServicePrincipal-Entität von Microsoft Graph definiert das Schema für die Eigenschaften eines Dienstprinzipalobjekts.
Auf der Seite Unternehmensanwendungen im Microsoft Entra Admin Center können die Dienstprinzipale in einem Mandanten aufgelistet und verwaltet werden. Sie können die Berechtigungen des Dienstprinzipals, die vom Benutzer genehmigten Berechtigungen, die Benutzer, die diese Genehmigung erteilt haben, die Anmeldeinformationen und mehr anzeigen.
Beziehung zwischen Anwendungsobjekten und Dienstprinzipalen
Das Anwendungsobjekt ist die globale Darstellung Ihrer Anwendung für die Verwendung bei allen Mandanten. Der Dienstprinzipal ist die lokale Darstellung für die Verwendung in einem bestimmten Mandanten. Das Anwendungsobjekt fungiert als Vorlage, aus der allgemeine und Standardeigenschaften zur Verwendung im entsprechenden Dienstprinzipal abgeleitet werden.
Für ein Anwendungsobjekt gilt Folgendes:
- Es weist eine 1:1-Beziehung mit der Softwareanwendung auf.
- Eine 1:n-Beziehung mit den entsprechenden Dienstprinzipalobjekten
Ein Dienstprinzipal muss in jedem Mandanten erstellt werden, in dem die Anwendung verwendet wird. Er ermöglicht, eine Identität für die Anmeldung und/oder den Zugriff auf vom Mandanten gesicherte Ressourcen einzurichten. Eine Einzelmandantenanwendung weist nur einen Dienstprinzipal (im eigenen Heimmandanten) auf, der während der Anwendungsregistrierung erstellt und für die Verwendung autorisiert wird. Eine Anwendung mit mehreren Mandanten verfügt außerdem über einen Dienstprinzipal, der in jedem Mandanten erstellt wird, in dem ein Benutzer oder eine Benutzerin des Mandanten der Verwendung zugestimmt hat.
Auflisten von einer App zugeordneten Dienstprinzipalen
So finden Sie die Dienstprinzipale, die einem Anwendungsobjekt zugeordnet sind.
Navigieren Sie im Microsoft Entra Admin Center zur Anwendungsregistrierungsübersicht. Wählen Sie Verwaltete Anwendung in lokalem Verzeichnis aus.
Konsequenzen des Änderns und Löschens von Anwendungen
Alle Änderungen, die Sie an Ihrem Anwendungsobjekt vornehmen, werden auch in seinem Dienstprinzipalobjekt ausschließlich im Basismandanten der Anwendung widergespiegelt (der Mandant, in dem die Anwendung registriert wurde). Das bedeutet, dass beim Löschen eines Anwendungsobjekts auch das Dienstprinzipalobjekt des Basismandanten gelöscht wird. Durch das Wiederherstellen dieses Anwendungsobjekts über die Benutzeroberfläche der App-Registrierungen wird der entsprechende Dienstprinzipal jedoch nicht wiederhergestellt. Weitere Informationen zum Löschen und Wiederherstellen von Anwendungen und ihren Dienstprinzipalobjekten finden Sie unter Häufig gestellte Fragen zum Wiederherstellen gelöschter Anwendungen in Azure Active Directory.
Beispiel
Die folgende Abbildung veranschaulicht die Beziehung zwischen einem Anwendungsobjekt der Anwendung und den entsprechenden Dienstprinzipalobjekten im Kontext einer mehrinstanzenfähigen Beispielanwendung mit dem Namen HR App. In diesem Beispielszenario gibt es drei Microsoft Entra-Mandanten:
- Adatum: Der Mandant, der von dem Unternehmen verwendet wird, das die Personal-App entwickelt hat
- Contoso: Der Mandant, der von der Organisation Contoso (einem Endkunden der Personal-App) verwendet wird
- Fabrikam: Der von der Organisation Fabrikam (ebenfalls ein Endkunde der Person-App) verwendete Mandant
Dieses Beispielszenario:
| Schritt | Beschreibung |
|---|---|
| 1 | Der Prozess zur Erstellung der Anwendungs- und Dienstprinzipalobjekte im Basismandanten der Anwendung. |
| 2 | Nachdem die Administratoren von Contoso und Fabrikam die Zustimmung erteilt haben, wird im Microsoft Entra-Mandanten des Unternehmens ein Dienstprinzipalobjekt erstellt und mit den Berechtigungen versehen, die vom Administrator gewährt wurden. Beachten Sie auch, dass die HR App so konfiguriert bzw. entworfen werden kann, dass die Zustimmung für die individuelle Nutzung durch die Benutzer erteilt wird. |
| 3 | Die Endkundenmandanten der Personalanwendung (Contoso und Fabrikam) erhalten jeweils ein eigenes Dienstprinzipalobjekt. Jedes Objekt repräsentiert die Verwendung einer Instanz der Anwendung zur Laufzeit, gesteuert durch die Berechtigungen, die vom jeweiligen Administrator per Zustimmung erteilt wurden. |
Nächste Schritte
Informieren Sie sich, wie Sie einen Dienstprinzipal erstellen:
- Mit dem Microsoft Entra Admin Center
- Verwenden von Azure PowerShell
- Verwenden der Azure-Befehlszeilenschnittstelle
- Verwenden von Microsoft Graph und von Microsoft Graph-Tester, um die Anwendungs- und die Dienstprinzipalobjekte abzufragen.