Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Microsoft Graph stellt REST-APIs zum Verwalten von Identitäts- und Netzwerkzugriffsfunktionen bereit, von denen die meisten über Microsoft Entra verfügbar sind. Diese APIs helfen Ihnen, Aufgaben der Identitäts- und Netzwerkzugriffsverwaltung zu automatisieren, in Anwendungen zu integrieren und dienen als programmgesteuerte Alternative zu Administratorportalen wie dem Microsoft Entra Admin Center.
Microsoft Entra ist eine Familie von Identitäts- und Netzwerkzugriffslösungen, die die folgenden Produkte umfasst. Alle diese Funktionen sind über Microsoft Graph-APIs verfügbar:
- Microsoft Entra ID, die IAM-Funktionen (Identity and Access Management) gruppiert.
- Microsoft Entra ID Governance
- Microsoft Entra External ID
- Microsoft Entra Verified ID
- Microsoft Entra Permissions Management (veraltet)
- Microsoft Entra Internet Access und Netzwerkzugriff
Verwalten von Benutzeridentitäten
Benutzer sind die Hauptidentitäten in jeder Identitäts- und Zugriffslösung. Sie können den gesamten Lebenszyklus von Benutzern in Ihrer Organization, einschließlich Gästen, und deren Berechtigungen wie Lizenzen oder Gruppenmitgliedschaften mithilfe von Microsoft Graph-APIs verwalten. Weitere Informationen finden Sie unter Arbeiten mit Benutzern in Microsoft Graph.
Verwalten von Gruppen
Gruppen sind die Container, mit denen Sie die Berechtigungen für Identitäten als Einheit effizient verwalten können. Beispielsweise können Sie Benutzern über eine Gruppe Zugriff auf eine Ressource gewähren, z. B. eine SharePoint-Website. Alternativ können Sie ihnen Lizenzen zur Nutzung eines Dienstes erteilen. Weitere Informationen finden Sie unter Arbeiten mit Gruppen in Microsoft Graph.
Verwalten von Anwendungen
Sie können Microsoft Graph-APIs verwenden, um Ihre Anwendungen programmgesteuert zu registrieren und zu verwalten, sodass Sie die IAM-Funktionen von Microsoft nutzen können. Weitere Informationen finden Sie unter Verwalten von Microsoft Entra-Anwendungen und Dienstprinzipalen mit Microsoft Graph.
Agenten verwalten
KI-Agenten benötigen dieselben Frameworks für Identität, Zugriff, Sicherheit und Governance, die für Benutzer, Anwendungen und Geräte in Ihrer Organization gelten. Microsoft Graph-APIs unterstützen den gesamten Lebenszyklus der Agent-Identität, einschließlich:
- Erstellen und Verwalten von Agent-Identitäten : Programmgesteuertes Erstellen und Verwalten von Agent-Identitäts-Blaupausen, Agent-Identitäten und deren zugeordneten Metadaten wie Besitzern und Sponsoren.
- Sicherheit und Zugriffssteuerung: Wenden Sie Richtlinien für bedingten Zugriff an, um Zugriffssteuerungen für Agenten durchzusetzen, und verwenden Sie Zugriffspakete für die Berechtigungsverwaltung, um Agenten Zugriff auf Sicherheitsgruppen, Anwendungsberechtigungen und Microsoft Entra-Rollen zuzuweisen.
- Governance - Weisen Sie Sponsoren Agentidentitäten zu, um die menschliche Verantwortlichkeit über den gesamten Lebenszyklus der Agenten aufrechtzuerhalten. Verwenden Sie Zugriffsüberprüfungen, um regelmäßig zu überprüfen, ob Agent-Identitäten weiterhin ihren zugewiesenen Zugriff benötigen.
- Risikoerkennung und -überwachung : Überwachen Sie die Anmeldeaktivitäten von Agenten aus Compliance- und Sicherheitsgründen durch Überwachungsprotokolle.
Weitere Informationen zur Verwendung von Microsoft Graph-APIs zum Erreichen dieser Funktionen für Agents finden Sie unter Microsoft Entra-Agent-ID-APIs in der Microsoft Graph-Übersicht.
Mandantenverwaltung und Verzeichnisverwaltung
Eine Kernfunktionalität der Identitäts- und Zugriffsverwaltung ist die Verwaltung Ihrer Mandantenkonfiguration, administrativen Rollen und Einstellungen. Microsoft Graph stellt APIs zum Verwalten Ihres Microsoft Entra-Mandanten für die folgenden Szenarien bereit:
| Anwendungsfälle | API-Vorgänge |
|---|---|
Verwalten Sie Verwaltungseinheiten, einschließlich der folgenden Vorgänge:
|
administrativeUnit und zugehörige APIs |
| Abrufen von BitLocker-Wiederherstellungsschlüsseln | BitlockerRecoveryKey und zugehörige APIs |
| Verwalten benutzerdefinierter Sicherheitsattribute | Weitere Informationen finden Sie unter Übersicht über benutzerdefinierte Sicherheitsattribute mit der Microsoft Graph-API |
Sichern und Wiederherstellen kritischer Verzeichnisobjekte in einem zuvor bekannten guten Zustand, einschließlich Benutzern, Gruppen, Anwendungen, Dienstprinzipalen und Richtlinien für bedingten Zugriff, um Ihnen bei der Wiederherstellung nach versehentlichen Änderungen oder Sicherheitskompromittierungen zu helfen
|
Weitere Informationen finden Sie unter Übersicht über Microsoft Entra Backup and Recovery APIs |
Gelöschte Verzeichnisobjekte verwalten. Die Funktionalität zum Speichern gelöschter Objekte im "Papierkorb" wird für die folgenden Objekte unterstützt:
|
|
| Verwalten von Geräten in der Cloud |
|
| Zeigen Sie Anmeldeinformationen des lokalen Administrators für alle Geräteobjekte in Microsoft Entra ID an, für die LAPS (Local Admin Password Solution) aktiviert sind. Dieses Feature ist die cloudbasierte LAPS-Lösung | deviceLocalCredentialInfo und die zugehörigen APIs |
| Verzeichnisobjekte sind die Kernobjekte in Microsoft Entra ID, z. B. Benutzer, Gruppen und Anwendungen. Sie können den Ressourcentyp directoryObject und die zugehörigen APIs verwenden, um Mitgliedschaften bei Verzeichnisobjekten zu überprüfen, Änderungen für mehrere Verzeichnisobjekte nachzuverfolgen oder zu überprüfen, ob der Anzeigename oder der Mail-Spitzname einer Microsoft 365-Gruppe den Namensrichtlinien entspricht | directoryObject und die zugehörigen APIs |
Verwalten Sie Administratorrollen, einschließlich der folgenden Vorgänge:
|
Die folgenden Ressourcen und die zugehörigen APIs:
Verwenden Sie für Just-in-Time- und zeitgebundene Rollenzuweisungen anstelle von direkten, für immer aktive Zuweisungen Privileged Identity Management-APIs für Microsoft Entra-Rollen und -Gruppen |
Definieren Sie die folgenden Konfigurationen, die verwendet werden können, um die mandantenweiten und objektspezifischen Einschränkungen und das zulässige Verhalten anzupassen.
|
In beta: directorySetting und directorySettingTemplate und die zugehörigen APIs In v1.0: groupSetting und groupSettingTemplate und die zugehörigen APIs Weitere Informationen finden Sie unter Übersicht über Gruppeneinstellungen. |
Domänenverwaltungsvorgänge wie:
|
Domäne und zugehörige APIs |
Verwalten Sie die Profilobjekte für externe Benutzer, die Sie zur Zusammenarbeit über Teams eingeladen haben. Diese APIs ähneln nicht den Einladungs-APIs für die B2B-Zusammenarbeit mit Microsoft Entra External ID:
|
externalUserProfile und pendingExternalUserProfile und die zugehörigen APIs |
| Konfigurieren und Verwalten des gestaffelten Rollouts bestimmter Features von Microsoft Entra ID | featureRolloutPolicy und zugehörige APIs |
| Überwachen von Lizenzen und Abonnements für den Mandanten |
|
Verwalten der Richtlinien für die automatische Registrierung bei mobilen Geräteverwaltung (MDM) und mobilen Anwendungsverwaltung (Mobile Application Management, MAM) für Microsoft Entra verbundene und registrierte Geräte
|
Die folgenden Ressourcen und die zugehörigen APIs: |
| Konfigurieren Sie Optionen, die in Microsoft Entra Cloud Sync verfügbar sind, z. B. das Verhindern versehentlicher Löschungen und das Verwalten von Gruppenrückschreiben. | onPremisesDirectorySynchronization und die zugehörigen APIs |
Verwalten von Synchronisierungseinstellungen für Verzeichnisobjekte wie Benutzer, Gruppen und Organisationskontakte zwischen dem lokalen Active Directory und der Cloud
|
onPremisesSyncBehavior und zugehörige APIs |
| Verwalten der Basiseinstellungen für Ihren Microsoft Entra-Mandanten | organization and its associated APIs |
Verwalten Sie die mandantenweiten Einstellungen für Ihren Microsoft Entra-Mandanten, z. B. ob Personen- und Elementeinblicke für die organization aktiviert sind.
|
organizationSettings und die zugehörigen APIs |
| Rufen Sie die Organisationskontakte ab, die aus lokalen Verzeichnissen oder aus Exchange Online synchronisiert werden können | orgContact und die zugehörigen APIs |
| Ermitteln Sie die grundlegenden Details anderer Microsoft Entra-Mandanten, indem Sie mithilfe der Mandanten-ID oder des Domänennamens abfragen | tenantInformation und die zugehörigen APIs |
Identität und Anmeldung
| Anwendungsfälle | API-Vorgänge |
|---|---|
| Erteilen, Widerrufen und Abrufen von App-Rollen für eine Ressourcenanwendung für Benutzer, Gruppen oder Dienstprinzipale | appRoleAssignment und die zugehörigen APIs |
| Konfigurieren Sie Listener, die Ereignisse überwachen, die eine benutzerdefinierte Logik auslösen oder aufrufen sollen, die in der Regel außerhalb von Microsoft Entra ID definiert ist | authenticationEventListener und zugehörige APIs |
| Verwalten von Authentifizierungsmethoden, die in Microsoft Entra ID unterstützt werden | Weitere Informationen finden Sie unter Richtlinien für Microsoft Entra-Authentifizierungsmethoden API-Übersicht und Richtlinien für Microsoft Entra-Authentifizierungsmethoden API-Übersicht |
| Verwalten der Authentifizierungsmethoden oder Kombinationen von Authentifizierungsmethoden, die Sie als Grant Control in Microsoft Entra Conditional Access anwenden können | Siehe Übersicht über die API zur Microsoft Entra-Authentifizierungsstärke |
Verwalten Sie mandantenweite Autorisierungsrichtlinien, z. B.:
|
authorizationPolicy und zugehörige APIs |
Anpassen der Benutzeroberfläche/UX in Azure AD B2C mithilfe des Identity Experience Framework (IEF)
|
trustFrameworkKeySet und trustFrameworkPolicy und die zugehörigen APIs |
| Verwalten der Richtlinien für die zertifikatbasierte Authentifizierung im Mandanten | certificateBasedAuthConfiguration und zugehörige APIs |
| Verwalten von Microsoft Entra Richtlinien für bedingten Zugriff, einschließlich Netzwerkspeicherorte wie Länder, IP-Adressen und kompatible Netzwerke Auswerten der Auswirkungen von Richtlinien für bedingten Zugriff vor ihrer Erzwingung Konfigurieren Sie die fortlaufende Zugriffsauswertung (Continuous Access Evaluation, CAE), mit der Zugriffstoken basierend auf kritischen Ereignissen und der Richtlinienauswertung widerrufen werden können, anstatt sich auf den Tokenablauf basierend auf der Lebensdauer zu verlassen
|
Die folgenden Ressourcen und die zugehörigen APIs: |
| Verwalten Sie mandantenübergreifende Zugriffseinstellungen und verwalten Sie ausgehende Beschränkungen, eingehende Beschränkungen, Mandanteneinschränkungen und mandantenübergreifende Synchronisierung von Benutzern in mehrinstanzenfähigen Organisationen | Siehe Mandantenübergreifende Zugriffseinstellungen API-Übersicht |
Verwalten Sie die Benutzerprofile, die mit B2B Direct Connect für Sie oder externe Mandanten freigegeben werden, einschließlich des Entfernens und Exportierens personenbezogener Daten
|
inboundSharedUserProfile und outboundSharedUserProfile und die zugehörigen APIs |
| Konfigurieren Sie, wie und welche externen Systeme während einer Benutzerauthentifizierungssitzung mit Microsoft Entra ID interagieren. | customAuthenticationExtension und die zugehörigen APIs |
| Verwalten Sie Anforderungen an Benutzerdaten in der organization, z. B. das Exportieren personenbezogener Daten | dataPolicyOperation und zugehörige APIs |
Konfigurieren Sie die Richtlinien für die Verwaltung von Microsoft Entra-Beitritt und Microsoft Entra-Registrierungsgeräten
|
deviceRegistrationPolicy und die zugehörigen APIs |
Verwalten Sie die mandantenweite Richtlinie, die steuert, ob externe Benutzer einen Microsoft Entra-Mandanten über Self-Service-Steuerelemente verlassen können, z. B. über das Menü "Organisationen" des Portals "Mein Konto".
|
externalIdentitiesPolicy und die zugehörigen APIs |
| Erzwingen der automatischen Anmeldung, um den Bildschirm zur Eingabe des Benutzernamens zu überspringen und Benutzer automatisch an Verbundanmeldeendpunkte weiterzuleiten | homeRealmDiscoveryPolicy und zugehörige APIs |
| Erkennen, untersuchen und beheben Sie identitätsbasierte Risiken mithilfe von Microsoft Entra ID Protection und speisen Sie die Daten zur weiteren Untersuchung und Korrelation in SIEM-Tools (Security Information and Event Management) ein. | Weitere Informationen finden Sie unter Verwenden der Microsoft Graph Identity Protection-APIs |
Verwalten von Identitätsanbietern für Microsoft Entra ID-, Microsoft Entra External ID- und Azure AD B2C-Mandanten. Sie können die folgenden Vorgänge ausführen:
|
identityProviderBase und die zugehörigen APIs |
| Definieren Sie eine Gruppe von Mandanten, die zu Ihrer organization gehören, und optimieren Sie die mandantenübergreifende Zusammenarbeit innerhalb der organization | Siehe Übersicht über die Multitenant organization API |
| Verwalten der delegierten Berechtigungen und ihrer Zuweisungen an Dienstprinzipale im Mandanten | oAuth2PermissionGrant und die zugehörigen APIs |
| Passen Sie die Anmeldebenutzeroberflächen an Ihr Unternehmensbranding an, einschließlich der Anwendung eines Brandings, das auf der Browsersprache basiert. | organizationalBranding und zugehörige APIs |
| Konfigurieren Sie vertrauenswürdige Zertifizierungsstellen für Zertifikate, die Apps und Dienstprinzipalen im Mandanten zugewiesen werden können. | certificateBasedApplicationConfiguration und zugehörige APIs |
| Benutzerabläufe für Microsoft Entra External ID in Belegschaftsmandanten | the following resources and their associated APIs:
|
Benutzerabläufe für Azure AD B2C
|
the following resources and their associated APIs:
|
| Benutzerabläufe für Microsoft Entra External ID in externen Mandanten | the following resources and their associated APIs:
|
| Verwalten von App-Zustimmungsrichtlinien und Bedingungssätzen | permissionGrantPolicy |
Verwalten von Richtlinien für die Vorabgenehmigung von App-Einwilligungen
|
permissionGrantPreApprovalPolicy |
| Aktivieren oder Deaktivieren von Sicherheitsstandards in Microsoft Entra ID | identitySecurityDefaultsEnforcementPolicy |
Identity Governance
Weitere Informationen finden Sie unter Übersicht über Microsoft Entra ID Governance mit Microsoft Graph.
Microsoft Entra External ID in externen Mandanten
Die folgenden API-Anwendungsfälle werden unterstützt, um die Interaktion von Benutzern mit Ihren kundenorientierten Anwendungen anzupassen. Für Administratoren werden die meisten der in Microsoft Entra ID verfügbaren und auch für Microsoft Entra External ID in externen Mandanten unterstützten Features unterstützt. Beispiele: Domänenverwaltung, Anwendungsverwaltung und bedingter Zugriff. Weitere Informationen zu allen Funktionen, die in External ID unterstützt werden, finden Sie unter Unterstützte Features in Workforce und externen Mandanten.
| Anwendungsfälle | API-Vorgänge |
|---|---|
| Benutzerabläufe für Microsoft Entra External ID in externen Mandanten und Self-Service-Registrierungserfahrungen | authenticationEventsFlow und die zugehörigen APIs |
| Verwalten von Identitätsanbietern für Microsoft Entra External ID. Sie können die Identitätsanbieter identifizieren, die im Mandanten unterstützt oder konfiguriert werden | Siehe identityProviderBase und die zugehörigen APIs |
| Konfigurieren benutzerdefinierter URL-Domänen in Microsoft Entra External ID in externen Mandanten | Der CustomUrlDomain Wert für die supportedServices-Eigenschaft der Domäne und der zugehörigen APIs |
Passen Sie die Anmeldebenutzeroberflächen an Ihr Unternehmensbranding an, einschließlich der Anwendung eines Brandings, das auf der Browsersprache basiert, oder der Anwendung eines App-basierten Brandings
|
organizationalBranding und zugehörige APIs |
| Verwalten von Identitätsanbietern für Microsoft Entra External ID, z. B. Identitäten in sozialen Netzwerken | identityProviderBase und die zugehörigen APIs |
Mit einem Alias oder Benutzernamen anmelden
|
signInIdentifierBase und die zugehörigen APIs |
| Verwalten von Benutzerprofilen in Microsoft Entra External ID für Kunden | Weitere Informationen finden Sie unter Standardbenutzerberechtigungen in Kundenmandanten |
| Verwalten von Microsoft Entra Richtlinien für bedingten Zugriff, z. B. einschließlich aller Benutzer oder Ausschließen bestimmter Benutzer und Gruppen Targeting von Ressourcen und Authentifizierungskontext Anwenden von Bedingungen wie Geräteplattformen und Netzwerkspeicherorten wie Länder, IP-Adressen und kompatible Netzwerke Sitzungssteuerung (Anmeldehäufigkeit und persistente Browsersitzung) |
Die folgenden Ressourcen und die zugehörigen APIs: |
| Fügen Sie Ihre eigene Geschäftslogik zu den Authentifizierungserfahrungen hinzu, indem Sie Systeme integrieren, die außerhalb von Microsoft Entra ID liegen | authenticationEventListener und customAuthenticationExtension und die zugehörigen APIs |
| Integrieren Sie Anbieter von Betrugsschutz, um gefälschte Kontoanmeldungen und Bot-Angriffe während des Benutzerregistrierungsprozesses zu verhindern. Zu den unterstützten Anbietern gehören Arkose Labs und HUMAN Security | fraudProtectionProvider und onFraudProtectionLoadStartListener und die zugehörigen APIs |
| Integration mit Web Application Firewall-Anbietern wie Akamai und Cloudflare | webApplicationFirewallProvider und zugehörige APIs |
Multicloud-Berechtigungsverwaltung (veraltet)
Weitere Informationen finden Sie unter Ermitteln, Korrigieren und Überwachen von Berechtigungen in Multicloud-Infrastrukturen mithilfe von Berechtigungsverwaltungs-APIs.
Verwaltung des Netzwerkzugriffs
Weitere Informationen finden Sie unter Sicherer Zugriff auf Cloud-, öffentliche und private Apps mithilfe von Microsoft Graph-Netzwerkzugriffs-APIs.
Verwaltung von Partnermandanten
Microsoft Graph bietet auch die folgenden Identitäts- und Zugriffsfunktionen für Microsoft-Partner in den Programmen Cloud Solution Provider (CSP), Value Added Reseller (VAR) oder Advisor, um die Verwaltung ihrer Kundenmandanten zu unterstützen.
| Anwendungsfälle | API-Vorgänge |
|---|---|
| Verträge für den Partner mit seinen Kunden verwalten | contract and its associated APIs |
| Microsoft-Partner können ihre Kunden in die Lage versetzen, sicherzustellen, dass die Partner den am wenigsten privilegierten Zugriff auf die Mandanten ihrer Kunden gewähren. Dieses Feature bietet Kunden zusätzliche Kontrolle über ihren Sicherheitsstatus und ermöglicht es ihnen, Support von den Microsoft-Wiederverkäufern zu erhalten | Siehe Übersicht über die API für delegierte Administratorrechte (Granular Delegated Admin Rights, GDAP) |
Erhalten Sie Erkennungen und Sicherheitswarnungen für nicht autorisierten Missbrauch durch Parteien, Kontoübernahmen und anomale Verwendung von Azure-Abonnements in den Kundenmandanten, für die Sie verantwortlich sind.
|
Weitere Informationen finden Sie unter Verwenden der Partner-Sicherheitsbenachrichtigungs-API in Microsoft Graph |
Identitäts- und Zugriffsberichte
Microsoft Entra zeichnet jede Aktivität in Ihrem Mandanten auf und erstellt Berichte und Überwachungsprotokolle, die Sie zur Überwachung, Compliance und Problembehandlung analysieren können. Aufzeichnungen dieser Aktivitäten sind auch über Microsoft Graph-Berichts- und Überwachungsprotokoll-APIs verfügbar, die es Ihnen ermöglichen, die Aktivitäten mit Azure Monitor-Protokollen und Log Analytics zu analysieren oder zur weiteren Untersuchung an SIEM-Tools von Drittanbietern zu streamen. Weitere Informationen finden Sie unter API-Übersicht über Identitäts- und Zugriffsberichte.
Zero Trust
Dieses Feature hilft Organisationen, ihre Mandanten auf die drei Leitprinzipien einer Zero Trust-Architektur auszurichten:
- Explizit verifizieren
- Verwenden der geringsten Rechte
- Gehe von einem Verstoß aus
Weitere Informationen zu Zero Trust und anderen Möglichkeiten, Ihre organization an den Leitprinzipien auszurichten, finden Sie im Zero Trust Guidance Center.
Lizenzierung
Microsoft Entra ID Lizenzen umfassen Microsoft Entra ID Free, P1, P2 und Governance; Microsoft Entra Permissions Management und Microsoft Entra Workload ID.
Ausführliche Informationen zur Lizenzierung für verschiedene Features finden Sie unter Microsoft Entra ID-Lizenzierung.
Verwandte Inhalte
- Implementieren von Identitätsstandards mit Microsoft Entra ID
- Microsoft Entra ID Guide für unabhängige Softwareentwickler
- Überprüfen Sie die Microsoft Entra Bereitstellungspläne, um Ihren Plan zum Bereitstellen der Microsoft Entra Suite von Funktionen zu erstellen.