Wie gestaltet man Berechtigungen für die Microsoft Graph API?

Berechtigungsdesign für die Microsoft Graph API: Unterschied zwischen delegated und application, Eingrenzung mit Sites.Selected und Exchange RBAC, Administratorzustimmung, Zertifikatsverwaltung und Throttling.
In diesem Beitrag6 Abschnitte

Die für eine Berichtsanwendung erteilte Application-Berechtigung Mail.Read gibt dieser Anwendung das Recht, alle Postfächer im Tenant zu lesen. Gelangt der geheime Schlüssel der Anwendung aus einer Konfigurationsdatei nach außen, ist nicht der Schlüssel eines Berichts abgeflossen, sondern die gesamte E-Mail des Unternehmens. Microsoft Graph bietet Zugriff auf Daten zu Nutzern, Gruppen, Teams, SharePoint, Outlook und Intune über eine einzige API; deshalb ist das Berechtigungsdesign die riskanteste Entscheidung einer Integration. Unten finden Sie den Unterschied zwischen delegated- und application-Berechtigungen, Mechanismen zur Eingrenzung und das schrittweise Design nach dem Prinzip minimaler Rechte.

Zwei Berechtigungsarten: delegated und application

Delegated (delegiert) Application (Anwendung)
In wessen Namen? Angemeldeter Nutzer Die Anwendung selbst; kein Nutzer
Effektiver Zugriff Berechtigung ∩ eigene Rechte des Nutzers Der gesamte von der Berechtigung umfasste Tenant (sofern nicht eingegrenzt)
Typische Verwendung Oberflächen, die mit den eigenen Daten des Nutzers arbeiten Hintergrunddienste, Synchronisierung, Automatisierung
Genehmigung Nutzer oder Administrator (je nach Berechtigung) Immer Administratorzustimmung

Grundregel: Gibt es eine Benutzeroberfläche, wird zuerst eine Lösung mit delegated-Berechtigungen gesucht. Application-Berechtigungen werden nur in tatsächlich nutzerlosen Szenarien und mit dem engstmöglichen Umfang vergeben.

Bei delegated-Berechtigungen ist der effektive Zugriff eine Schnittmenge. Selbst wenn die Anwendung Files.Read.All hat, sieht der Nutzer nur die Dateien, auf die er selbst zugreifen kann. Bei application-Berechtigungen fehlt diese Bremse. Der häufigste Fehler in der Praxis: Der Entwickler fügt beim Testen eine application-Berechtigung hinzu, „damit es funktioniert“, und die Anwendung geht so in Produktion. Hat eine App-Registrierung sowohl delegated- als auch application-Berechtigungen, prüfen Sie, welche tatsächlich genutzt wird; entfernen Sie die ungenutzte.

Mechanismen zur Eingrenzung

  • SharePoint und OneDrive – Sites.Selected: Gibt der Anwendung nicht Zugriff auf alle Websites, sondern nur auf die vom Administrator ausdrücklich berechtigten (Lesen oder Schreiben). Bei Helpdesk- oder Intranetintegrationen zu bevorzugen.
  • Exchange Online – Anwendungszugriff einschränken: Application-Berechtigungen für E-Mail und Kalender lassen sich über die rollenbasierte Zugriffssteuerung von Exchange für Anwendungen (RBAC for Applications) auf bestimmte Postfächer beschränken.
  • Teams – ressourcenspezifische Zustimmung (RSC): Die Anwendung erhält Berechtigungen nur im Team oder Chat, in dem sie installiert ist.
  • Trennung von Lesen und Schreiben: Genügt .Read, wird kein .ReadWrite vergeben; .All-Bereiche werden nicht ohne Begründung genutzt.

Sites.Selected hat zwei Schritte, und das wird oft übersehen. Die Berechtigung zur App-Registrierung hinzuzufügen und die Administratorzustimmung zu erteilen, öffnet allein keinen Zugriff auf eine Website; anschließend muss ein berechtigter Administrator der Anwendung für die betreffende Website ausdrücklich eine Berechtigung zuweisen (über den Endpunkt für Websiteberechtigungen in Graph oder mit PnP PowerShell). Fehlt dieser Schritt, erhält die Anwendung einen 403-Fehler, und der Entwickler fordert zur Lösung meist Sites.ReadWrite.All an. Lehnen Sie das ab. Es fehlt nicht die Berechtigung, sondern die Autorisierung auf Websiteebene.

Designschritte

  1. Szenario schreiben: Welche Daten nutzt die Anwendung für welchen Vorgang wie häufig; gibt es einen Nutzerkontext?
  2. Nötige API-Aufrufe auflisten: Wählen Sie für jeden Aufruf aus der Berechtigungstabelle auf Microsoft Learn die Berechtigung mit den geringsten Rechten.
  3. Eingrenzung anwenden: Sites.Selected, Exchange-Anwendungsbereich oder RSC.
  4. Authentifizierungsmethode wählen: Zertifikat oder verwaltete Identität; ist ein geheimer Schlüssel unvermeidlich, kurzlebig und im Tresor.
  5. Berechtigungsprotokoll führen: Anwendung, Eigentümer, Berechtigung, Begründung, Genehmigender, Datum und Datum der jährlichen Überprüfung.
  6. Stützen Sie die Administratorzustimmung auf dieses Protokoll.

Im zweiten Schritt ist der Abschnitt „Permissions“ auf jeder Endpunktseite der Graph-Dokumentation maßgeblich; diese Tabelle ordnet Berechtigungen von den geringsten zu den umfassendsten Rechten. Die unterste Berechtigung der Liste zu wählen ist einfach, aber unbegründet. Verlangen Sie vom Entwickler, der die Administratorzustimmung anfordert, diese Aufrufliste. Ohne Liste keine Zustimmung.

Beispiel: Helpdesk-Integration

Der Hintergrunddienst eines Microsoft-365-Helpdesks muss den Vorgesetzten des Antragstellers lesen, in die Ticketliste der betreffenden SharePoint-Website schreiben und Benachrichtigungen an einen Teams-Kanal senden. Design mit minimalen Rechten: grundlegende Profil-Leseberechtigung für Nutzer- und Vorgesetzteninformationen, für SharePoint Schreibrecht per Sites.Selected nur auf die Helpdesk-Website, für Benachrichtigungen Teams Workflows oder eine kanalbezogene Berechtigung. Umfassende Berechtigungen wie „Sites.ReadWrite.All“ oder „Directory.ReadWrite.All“ sind nicht nötig.

Der praktische Nutzen dieses Designs: Im Fall eines Lecks bleibt der Schaden begrenzt. Selbst wenn die Zugangsdaten des Dienstes übernommen werden, kann der Angreifer nur in die Helpdesk-Website schreiben und Nutzerprofile lesen; auf E-Mails, andere Websites oder Verzeichnisänderungen hat er keinen Zugriff. Der Explosionsradius schrumpft.

Betrieb und Sicherheit

  • Ablaufdaten von Zertifikaten und geheimen Schlüsseln werden überwacht; das Erneuerungsverfahren ist schriftlich festgehalten.
  • App-Registrierungen und Berechtigungen werden jährlich überprüft; ungenutzte Anwendungen werden entfernt.
  • Anmeldungen von Anwendungen und Graph-Aktivitäten werden über die Protokolle von Entra ID überwacht.
  • Lassen sich Richtlinien für bedingten Zugriff auf Workload-Identitäten anwenden (lizenzabhängig), wird dies geprüft.
  • Für Throttling werden Wiederholungen unter Beachtung von Retry-After, Batch-Anfragen und Delta-Abfragen genutzt.

Ein abgelaufenes Zertifikat ist der häufigste Grund, warum Integrationen morgens stillschweigend stoppen. Berichten Sie Ablaufdaten regelmäßig aus den App-Registrierungen in Entra ID und planen Sie die Erneuerung mindestens einige Wochen im Voraus; altes und neues Zertifikat können eine Zeit lang parallel definiert sein, was einen unterbrechungsfreien Wechsel ermöglicht. Als Eigentümer der Anwendung sollte nicht eine einzelne Person, sondern mindestens zwei Personen eingetragen sein. Eine App-Registrierung, deren Eigentümer ausgeschieden ist, ist eine Identität, für die niemand Verantwortung übernimmt. Auf Tenant-Ebene zu beschränken, dass Nutzer Anwendungen selbst zustimmen, und den Workflow für Administratorzustimmung (Admin Consent Workflow) zu aktivieren, verhindert Schattenintegrationen.

Häufig gestellte Fragen

Greift eine Anwendung mit Application-Berechtigung auf den gesamten Tenant zu?

Standardmäßig ja; die Application-Berechtigung Mail.Read umfasst zum Beispiel alle Postfächer. Deshalb sollten Eingrenzungsmechanismen genutzt werden: für Exchange der Anwendungszugriffsbereich, für SharePoint Sites.Selected.

Geheimer Clientschlüssel (Client Secret) oder Zertifikat?

Zertifikatsbasierte Authentifizierung oder bei Diensten in Azure eine verwaltete Identität ist vorzuziehen. Wird ein geheimer Schlüssel verwendet, sollte er kurzlebig sein, in einem sicheren Tresor liegen und sein Ablaufdatum überwacht werden.

Warum liefern Graph-API-Aufrufe den Fehler 429?

Graph wendet dienstbezogene Anfragelimits an (Throttling). Die Retry-After-Zeit in der 429-Antwort muss eingehalten, Massenvorgänge sollten mit Batch-Anfragen durchgeführt und zur Verfolgung von Änderungen Delta-Abfragen oder Änderungsbenachrichtigungen genutzt werden.

Da sich Namen und Verhalten von Berechtigungen im Lauf der Zeit ändern können, sollte vor der Umsetzung die aktuelle Berechtigungsreferenz auf Microsoft Learn geprüft werden. Um Ihre Integration mit einem sicheren Berechtigungsmodell aufzubauen, siehe unsere Leistung Integrationen mit der Microsoft Graph API.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge