Dienstprinzipale in Entra ID: Bewährte Methoden und häufige Probleme
Von Mirko Peters ·
Was ein Dienstprinzipal ist, worin er sich von einer App-Registrierung unterscheidet und welche Sicherheitspraktiken Microsoft dokumentiert: verwaltete Identitäten, Zertifikate, geringste Berechtigungen, Besitzer sowie bekannte Stolperfallen.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Ein Dienstprinzipal ist die Identität, die eine Anwendung innerhalb eines Microsoft Entra-Mandanten verwendet. Er legt fest, worauf die App dort zugreifen kann. Die Sicherheitspraktiken, die Microsoft dokumentiert, sind kurz gefasst: verwaltete Identitäten bevorzugen, auf Geheimnisse verzichten, nur die nötigen Berechtigungen vergeben, die Anzahl der Besitzer begrenzen und das Ganze regelmäßig überprüfen.
Das Wichtigste in Kürze
- Das Anwendungsobjekt ist die globale Vorlage im Basismandanten. Der Dienstprinzipal ist die lokale Instanz in jedem Mandanten und legt fest, was die App dort tun kann.
- Microsoft ordnet Anmeldeinformationen von der meistbevorzugten zur am wenigsten bevorzugten Option: verwaltete Identität, föderierte Anmeldeinformationen, Zertifikate. Geheimnisse (Kennwörter) sollten laut Microsoft nicht verwendet werden.
- Fordern Sie nur die am wenigsten weitreichende Berechtigung an, bevorzugen Sie delegierten gegenüber reinem App-Zugriff und entfernen Sie Berechtigungen, die die App nicht mehr benötigt.
- Halten Sie die Besitzer auf ein Minimum beschränkt, überprüfen Sie die Besitzerliste alle paar Monate und sorgen Sie dafür, dass jeder Dienstprinzipal mindestens zwei Besitzer hat.
- Gelöschte Apps und Dienstprinzipale lassen sich bis zu 30 Tage lang wiederherstellen. Benutzer ohne Administratorrechte können höchstens 250 App- und Dienstprinzipal-Objekte erstellen, gelöschte eingeschlossen.
Dieser Artikel folgt den Microsoft Learn-Seiten zu Anwendungs- und Dienstprinzipal-Objekten, zur Sicherheit von App-Registrierungen sowie zum Löschen und Wiederherstellen von Apps. Wo sich diese Seiten widersprechen oder schweigen, wird das ausdrücklich angemerkt.
Anwendungsobjekt versus Dienstprinzipal
Microsoft beschreibt zwei Objekte:
- Anwendungsobjekt. Die globale Repräsentation der App. Es liegt im Mandanten, in dem die App registriert wurde, dem sogenannten Basismandanten. Es funktioniert wie eine Vorlage für die daraus erstellten Dienstprinzipale.
- Dienstprinzipal. Die lokale Repräsentation der App in einem Mandanten. Er ist der Sicherheitsprinzipal, der die Zugriffsrichtlinie und die Berechtigungen der App in diesem Mandanten festlegt.
Eine Single-Tenant-App hat einen Dienstprinzipal, und zwar in ihrem Basismandanten. Eine Multitenant-App hat einen im Basismandanten und zusätzlich einen in jedem Mandanten, in dem jemand der Nutzung zugestimmt hat. Wenn Sie eine App im Portal registrieren, werden beide Objekte erstellt. Registrieren Sie die App über Microsoft Graph, ist das Erstellen des Dienstprinzipals ein separater Schritt.
Änderungen am Anwendungsobjekt wirken sich nur im Basismandanten auf den Dienstprinzipal aus. Sie werden nicht an Dienstprinzipale in anderen Mandanten weitergegeben.
Die drei Arten von Dienstprinzipalen
| Typ | Verknüpftes App-Objekt | Kann es bearbeitet werden? | |---|---|---| | Anwendung | Ja | Wird über das App-Objekt gesteuert, mit mandantenspezifischen Einstellungen | | Verwaltete Identität | Nein | Kann Zugriff erhalten, lässt sich aber nicht direkt ändern | | Legacy | Nein | Verfügt über bearbeitbare Eigenschaften wie Anmeldeinformationen und Antwort-URLs |
Legacy-Dienstprinzipale werden nur in dem Mandanten verwendet, in dem sie erstellt wurden. In Microsoft Graph erscheint der Typ als Eigenschaft servicePrincipalType. Die Referenz enthält mehr Werte als diese drei, darunter ServiceIdentity (eine Agent-Identität) und SocialIdp (für den internen Gebrauch). Microsoft Graph dokumentiert, dass für einen Anwendungs-Dienstprinzipal, dessen App-Registrierung fehlt, keine Token ausgestellt werden.
Einen auf die dokumentierte Weise erstellen
- Melden Sie sich am Microsoft Entra Admin Center mindestens als Cloud Application Administrator an.
- Navigieren Sie zu Entra ID > App-Registrierungen und wählen Sie Neue Registrierung.
- Geben Sie einen Namen ein und wählen Sie Nur Konten in diesem Organisationsverzeichnis, wenn die App single-tenant ist.
- Wählen Sie Registrieren. Der Dienstprinzipal wird automatisch erstellt.
Um Berechtigungen, Zustimmungen und Anmeldeinformationen anschließend zu verwalten, verwenden Sie Unternehmensanwendungen. Für den Azure-Zugriff beschreibt dieselbe Seite die Zuweisung einer Rolle auf Abonnement-, Ressourcengruppen- oder Ressourcenebene, wobei untergeordnete Bereiche die Berechtigungen erben. Den engsten Bereich zu wählen, der funktioniert, ist allgemeine Least-Privilege-Praxis und keine Anforderung, die dort genannt wird.
Best Practices von Microsoft
Den richtigen Identitätstyp wählen
Ziehen Sie eine verwaltete Identität statt einer App-Registrierung in Betracht, wenn der Dienst in Azure läuft, keine Benutzer anmeldet, keine Web-API ist und keine mehreren Mandanten benötigt.
Anmeldeinformationen priorisieren
Microsoft listet die Optionen von der meistbevorzugten bis zur am wenigsten bevorzugten auf. Die Seite bezeichnet dies nicht als formale Rangfolge:
- Eine verwaltete Identität als Anmeldeinformation. Microsoft bezeichnet dies als dringend empfohlen, da keine Verwaltung von Anmeldeinformationen nötig ist.
- Föderierte Anmeldeinformationen von einer vertrauenswürdigen Plattform. Microsoft rät zur Vorsicht und empfiehlt, föderierte Anmeldeinformationen nur für vertrauenswürdige Plattformen zu konfigurieren.
- Ein Zertifikat. Speichern Sie es in einem Key Vault wie Azure Key Vault und bevorzugen Sie eines von einer vertrauenswürdigen Zertifizierungsstelle.
- Ein geheimer Schlüssel (Client Secret). Die Seite sagt: "Don't use password credentials." (Verwenden Sie keine Kennwortanmeldeinformationen.)
Weitere Regeln von derselben Seite: Verwenden Sie Anwendungsverwaltungsrichtlinien, um die Lebensdauer von Geheimnissen zu begrenzen oder Geheimnisse zu blockieren, hinterlegen Sie keine Anmeldeinformationen in öffentlichen oder installierten Clients, rotieren Sie Anmeldeinformationen häufig, teilen Sie Anmeldeinformationen nie zwischen Apps und vermeiden Sie viele Anmeldeinformationen an einer App. Außerdem empfiehlt die Seite einen Credential Scanner in Build-Pipelines, damit Anmeldeinformationen nicht in Repositories landen. Die Seite nennt kein festes Rotationsintervall.
Umleitungs-URIs unter Kontrolle halten
Besitzen Sie jeden Umleitungs-URI, überwachen Sie die DNS-Einträge dahinter, vermeiden Sie Platzhalter und unsichere Schemata wie http und entfernen Sie überflüssige Einträge aus der Liste. Die Seite warnt, dass ein Verlust der Kontrolle über einen URI zur Kompromittierung der Anwendung führen kann.
Berechtigungen begrenzen
Fordern Sie nur die am wenigsten weitreichende Berechtigung an, prüfen Sie Berechtigungen regelmäßig und entfernen Sie solche, die die App nicht mehr benötigt. Bevorzugen Sie delegierten Zugriff gegenüber App-only-Zugriff, wann immer möglich.
Instanz sperren und Besitzer begrenzen
Ein Mandantenadministrator kann den Dienstprinzipal in jedem Mandanten anpassen. Dadurch können unerwartete Änderungen entstehen, etwa Anmeldeinformationen, die der App-Besitzer kontrollieren sollte. Microsoft empfiehlt, die Eigenschaftssperre der App-Instanz zu konfigurieren und jede verfügbare sensible Eigenschaft zu sperren. Das ist besonders bei Multitenant-Apps kritisch.
Beschränken Sie die Anwendungsbesitzer auf einen minimalen Personenkreis. Ein Administrator sollte die Besitzerliste etwa alle paar Monate prüfen. Microsoft Entra Zugriffsüberprüfungen können das automatisieren. Die Microsoft-Graph-Referenz empfiehlt zusätzlich mindestens zwei Besitzer pro Dienstprinzipal.
Identifier-URIs korrekt verwenden
Für Apps, die v1.0-Token erhalten, verwenden Sie nur die Standard-URIs api://<appId> und api://<tenantId>/<appId>. Für v2.0-Token ist api://<appId> das empfohlene Format. Der Wert muss im Mandanten eindeutig sein und darf nicht mit einem Schrägstrich enden. Ressourcen-Apps mit benutzerdefinierten Identifier-URIs sollten das v2.0-Zugriffstokenformat verwenden.
Häufige Probleme und was die Dokumentation dazu sagt
Anmeldungen sind schwer nachzuverfolgen. Entra erfasst Anmeldungen von Dienstprinzipalen und verwalteten Identitäten in eigenen Anmeldeprotokollen, getrennt von Benutzeranmeldungen. Öffnen Sie das Microsoft Entra Admin Center mit mindestens der Rolle Berichtleser und navigieren Sie zu Entra ID > Überwachung und Integrität > Anmeldeprotokolle. Die Seite, die ich gelesen habe, sagt nicht, auf welcher Registerkarte die Anmeldungen von Dienstprinzipalen angezeigt werden.
Eine App erhält keine Token mehr. Prüfen Sie zuerst, ob die App-Registrierung noch existiert. Kontrollieren Sie außerdem die Eigenschaften accountEnabled und appRoleAssignmentRequired am Dienstprinzipal. Ist accountEnabled auf false gesetzt, kann sich kein Benutzer anmelden, auch wenn er zugewiesen ist. Ist appRoleAssignmentRequired auf true gesetzt, ist zuerst eine App-Rollenzuweisung erforderlich.
Kontingentfehler bei der Erstellung. Ein Benutzer ohne Administratorrechte kann insgesamt nicht mehr als 250 Apps und Dienstprinzipale erstellen. Dabei zählen sowohl aktive Objekte als auch wiederherstellbare gelöschte Objekte. Kontingent wird erst frei, wenn Sie Objekte endgültig aus dem Container für gelöschte Elemente entfernen.
Die Wiederherstellung hat nicht alles zurückgebracht. Microsoft Learn enthält zwei widersprüchlich wirkende Aussagen. Laut der Seite zu App-Objekten stellt das Wiederherstellen eines Anwendungsobjekts in der Benutzeroberfläche für App-Registrierungen den zugehörigen Dienstprinzipal nicht wieder her. Die FAQ zum Löschen und Wiederherstellen besagt dagegen, dass beim Wiederherstellen der Registrierung auch der Dienstprinzipal wiederhergestellt wird, wenn beide gelöscht wurden. Prüfen Sie das Ergebnis nach jeder Wiederherstellung. Die FAQ hält außerdem fest, dass Richtlinien für Dienstprinzipale nicht wiederhergestellt werden können und erneut konfiguriert werden müssen. Die Bereitstellungsdaten können bis zu 40 Minuten bis einen Tag benötigen, bis sie wieder erscheinen.
Sie möchten eine App pausieren, nicht löschen. Microsoft Learn beschreibt das Deaktivieren einer Anwendung. Dabei werden keine neuen Token mehr ausgestellt, die Objekte bleiben jedoch für Untersuchungen oder eine spätere Reaktivierung erhalten.
Eine kurze Prüfroutine
- Listen Sie Apps mit Geheimnissen auf und stellen Sie sie auf Zertifikate oder verwaltete Identitäten um.
- Entfernen Sie Berechtigungen, die niemand nutzt.
- Prüfen Sie Besitzer und Ablaufdaten.
- Kontrollieren Sie, ob die Domains der Umleitungs-URIs noch in Ihrem Besitz sind.
- Prüfen Sie die Anmeldeprotokolle von Dienstprinzipalen auf nicht genutzte Apps.
Verwandte Themen
Quellen
- Microsoft Learn: Sicherheitsbest Practices für Anwendungseigenschaften in Microsoft Entra ID
- Microsoft Learn: Anwendungsobjekte und Dienstprinzipale in Microsoft Entra ID
- Microsoft Learn: Eine Microsoft Entra-App registrieren und einen Dienstprinzipal erstellen
- Microsoft Learn: Löschen und Wiederherstellen von Anwendungen und Dienstprinzipalen
- Microsoft Learn: servicePrincipal resource type (Microsoft Graph)
- Microsoft Learn: Anmeldeprotokolle in Microsoft Entra ID
FAQ
Worin unterscheidet sich eine App-Registrierung von einem Dienstprinzipal?
Laut Microsoft Learn ist das Anwendungsobjekt (die App-Registrierung) die globale Repräsentation einer App und liegt in deren Basismandanten. Der Dienstprinzipal ist die lokale Repräsentation in einem bestimmten Mandanten und legt dort die Zugriffsrichtlinie und die Berechtigungen fest. Wenn Sie eine App im Portal registrieren, werden beide Objekte im Basismandanten erstellt.
Sollte ich für einen Dienstprinzipal einen Clientschlüssel oder ein Zertifikat verwenden?
Die Sicherheitsempfehlungen von Microsoft führen eine verwaltete Identität als dringend empfohlen auf, danach föderierte Anmeldeinformationen nur von Plattformen, denen Sie vertrauen, und anschließend Zertifikatsanmeldeinformationen, falls keine der beiden Optionen möglich ist. Kennwortanmeldeinformationen, auch Geheimnisse genannt, sollten laut Microsoft nicht verwendet werden.
Wann sollte ich eine verwaltete Identität statt eines Dienstprinzipals verwenden?
Microsoft Learn nennt vier Bedingungen: Der Dienst läuft in Azure, er meldet keine Benutzer an, er agiert nicht als Web-API-Ressource und er muss nicht in mehreren Mandanten laufen. Wenn alle vier zutreffen, sollten Sie eine verwaltete Identität in Betracht ziehen. Eine verwaltete Identität ist selbst eine Art Dienstprinzipal, den Sie nicht direkt bearbeiten können.
Kann ich einen gelöschten Dienstprinzipal wiederherstellen?
Laut den FAQ zum Löschen und Wiederherstellen auf Microsoft Learn können vorläufig gelöschte Anwendungen und Dienstprinzipale bis zu 30 Tage lang wiederhergestellt werden. Danach werden sie endgültig gelöscht. App-Registrierungen stellen Sie im Microsoft Entra Admin Center wieder her. Dienstprinzipale stellen Sie mit PowerShell oder Microsoft Graph wieder her, da gelöschte Dienstprinzipale im Admin Center nicht angezeigt werden.
Warum erhalte ich beim Erstellen von Apps den Fehler Directory_QuotaExceeded?
Die FAQ auf Learn besagt, dass ein Benutzer ohne Administratorrechte nicht mehr als 250 Anwendungen und Dienstprinzipale erstellen kann. Dabei zählen sowohl aktive als auch wiederherstellbare gelöschte Objekte. Das Löschen von Objekten gibt das Kontingent allein nicht frei. Sie müssen die Objekte im Container für gelöschte Elemente endgültig entfernen.