Microsoft Identity Platform – Codebesipiele (V2.0-Endpunkt)Microsoft identity platform code samples (v2.0 endpoint)

Sie können mit der Microsoft Identity Platform folgende Aktionen ausführen:You can use Microsoft identity platform to:

  • Hinzufügen von Authentifizierungs- und Autorisierungsfeatures zu Ihren Webanwendungen und Web-APIsAdd authentication and authorization to your web applications and web APIs.
  • Anfordern eines Zugriffstokens für den Zugriff auf eine geschützte Web-APIRequire an access token to access a protected web API.

In diesem Artikel wird der Microsoft Identity Platform-Endpunkt kurz erläutert, und es werden Links zu Beispielen für den Endpunkt angegeben.This article briefly describes and provides you with links to samples for the Microsoft identity platform endpoint. Anhand dieser Beispiele wird die Vorgehensweise erläutert, und es werden Codeausschnitte bereitgestellt, die Sie in Ihren Anwendungen verwenden können.These samples show you how it's done, and also provide code snippets that you can use in your applications. Auf der Seite mit den Codebeispielen finden Sie ausführliche Infothemen mit hilfreichen Angaben zu Anforderungen, Installation und Einrichtung.On the code sample page, you'll find detailed readme topics that help with requirements, installation, and setup. Außerdem enthält der Code Kommentare, die die wichtigsten Abschnitte besser verständlich machen.Comments within the code help you understand the critical sections.

Informationen zum grundlegenden Szenario für die einzelnen Beispieltypen finden Sie unter App-Typen für den Microsoft Identity Platform-Endpunkt.To understand the basic scenario for each sample type, see App types for the Microsoft identity platform endpoint.

Sie können auch Beiträge zu den Beispielen auf GitHub schreiben.You can also contribute to the samples on GitHub. Wie das geht, erfahren Sie unter Microsoft Azure Active Directory – Beispiele und Dokumentation.To learn how, see Microsoft Azure Active Directory samples and documentation.

Single-Page-WebanwendungenSingle-page applications

Diese Beispiele zeigen, wie Sie eine Single-Page-Webanwendung schreiben, die mit Microsoft Identity Platform geschützt ist.These samples show how to write a single-page application secured with Microsoft identity platform. Diese Beispiele verwenden eine der Arten von MSAL.js.These samples use one of the flavors of MSAL.js.

PlattformPlatform BESCHREIBUNGDescription LinkLink
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) SPA ruft Microsoft Graph aufSPA calls Microsoft Graph javascript-graphapi-v2javascript-graphapi-v2
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) SPA ruft Microsoft Graph mithilfe des Authentifizierungscodeflows mit PKCE aufSPA calls Microsoft Graph using Auth Code Flow w/ PKCE javascript-v2javascript-v2
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) SPA ruft B2C aufSPA calls B2C b2c-javascript-msal-singlepageappb2c-javascript-msal-singlepageapp
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) SPA ruft B2C mithilfe des Authentifizierungscodeflows mit PKCE aufSPA calls B2C using Auth Code Flow w/PKCE b2c-javascript-spab2c-javascript-spa
Diese Abbildung zeigt das Angular-Logo. Angular (MSAL-Angular)This image shows the Angular logo Angular (MSAL-Angular) SPA ruft Microsoft Graph aufSPA calls Microsoft Graph active-directory-javascript-singlepageapp-angularactive-directory-javascript-singlepageapp-angular
Diese Abbildung zeigt das Angular-Logo. Angular (MSAL-Angular)This image shows the Angular logo Angular (MSAL-Angular) SPA ruft benutzerdefinierte Web-API aufSPA calls custom Web API ms-identity-javascript-angular-spa-aspnetcore-webapims-identity-javascript-angular-spa-aspnetcore-webapi
Diese Abbildung zeigt das Angular-Logo. Angular (MSAL-Angular)This image shows the Angular logo Angular (MSAL-Angular) SPA ruft B2C aufSPA calls B2C active-directory-b2c-javascript-angular-spaactive-directory-b2c-javascript-angular-spa
Diese Abbildung zeigt das React-Logo. React (MSAL.js)This image shows the React logo React (MSAL.js) SPA ruft benutzerdefinierte Web-API auf, die wiederum Microsoft Graph aufruftSPA calls custom Web API which in turn calls Microsoft Graph ms-identity-javascript-react-spa-dotnetcore-webapi-oboms-identity-javascript-react-spa-dotnetcore-webapi-obo
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) SPA ruft benutzerdefinierte Web-API auf, die wiederum Microsoft Graph aufruftSPA calls custom web API which in turn calls Microsoft Graph ms-identity-javascript-tutorial-chapter4-oboms-identity-javascript-tutorial-chapter4-obo
Diese Abbildung zeigt das Angular-Logo. Angular (MSAL-Angular)This image shows the Angular logo Angular (MSAL-Angular) SPA ruft benutzerdefinierte Web-API mit App-Rollen und -Sicherheitsgruppen aufSPA calls custom Web API with App Roles and Security Groups ms-identity-javascript-angular-spa-dotnetcore-webapi-roles-groupsms-identity-javascript-angular-spa-dotnetcore-webapi-roles-groups
Diese Abbildung zeigt das Blazor-Logo. Blazor WebAssembly (MSAL-JS)This image shows the Blazor logo Blazor WebAssembly (MSAL-JS) Blazor WebAssembly-Tutorial zum Anmelden von Benutzern und Aufrufen von APIs mit Azure Active DirectoryBlazor WebAssembly Tutorial to sign-in users and call APIs with Azure Active Directory ms-identity-blazor-wasmms-identity-blazor-wasm

WebanwendungenWeb applications

Die folgenden Beispiele zeigen Webanwendungen, die Benutzer anmelden.The following samples illustrate web applications that sign in users. Einige Beispiele zeigen außerdem, wie die Anwendung Microsoft Graph oder Ihre eigene Web-API mit der Identität des Benutzers aufruft.Some samples also demonstrate the application calling Microsoft Graph, or your own web API with the user's identity.

PlattformPlatform Nur BenutzeranmeldungOnly signs in users Benutzeranmeldung und Aufruf von Microsoft GraphSigns in users and calls Microsoft Graph
Diese Abbildung zeigt das ASP.NET Core-Logo.

ASP.NET CoreASP.NET Core
Benutzertutorial für die ASP.NET Core-Web-App-AnmeldungASP.NET Core WebApp signs-in users tutorial Das gleiche Beispiel im Schritt ASP.NET Core-Web-App-Aufrufe an Microsoft GraphSame sample in the ASP.NET Core web app calls Microsoft Graph phase

Erweitertes Beispiel Zugreifen auf den Tokencache des angemeldeten Benutzers über Hintergrund-Apps, APIs und DiensteAdvanced sample Accessing the logged-in user's token cache from background apps, APIs and services
Diese Abbildung zeigt das ASP.NET Framework-Logo.

ASP.NET CoreASP.NET Core
Im Playbook für Entwickler zur Migration von Anwendungen von AD FS zu Azure AD erfahren Sie, wie Sie Ihre in Active Directory-Verbunddienste (AD FS) integrierten Anwendungen problemlos und sicher zu Azure Active Directory (Azure AD) migrieren können.AD FS to Azure AD application migration playbook for developers to learn how to safely and securely migrate your applications integrated with Active Directory Federation Services (AD FS) to Azure Active Directory (Azure AD)
Diese Abbildung zeigt das ASP.NET Framework-Logo.

ASP.NETASP.NET
Schnellstart für ASP.NETASP.NET Quickstart

dotnet-webapp-openidconnect-v2dotnet-webapp-openidconnect-v2
dotnet-admin-restricted-scopes-v2dotnet-admin-restricted-scopes-v2

msgraph-training-aspnetmvcappmsgraph-training-aspnetmvcapp
Diese Abbildung zeigt das Java-Logo. ms-identity-java-webappms-identity-java-webapp
Diese Abbildung zeigt das Java-Logo. ms-identity-b2c-java-servlet-webapp-authenticationms-identity-b2c-java-servlet-webapp-authentication
Diese Abbildung zeigt das Python-Logo. ms-identity-python-flask-webapp-authenticationms-identity-python-flask-webapp-authentication ms-identity-python-webappms-identity-python-webapp
Diese Abbildung zeigt das Python-Logo. Tutorial zum Anmelden von Benutzern durch eine Python Flask-Web-AppPython Flask web app signs-in users tutorial Tutorial zum Anmelden von Benutzern und Aufrufen der Graph-API durch eine Python Flask-Web-AppPython Flask web app signs-in users and calls Graph tutorial
Diese Abbildung zeigt das Python-Logo. Tutorial zum Anmelden von Benutzern mit B2C durch eine Python Flask-Web-AppPython Flask web app signs-in users with B2C
Diese Abbildung zeigt das Ruby-Logo. msgraph-training-rubyrailsappmsgraph-training-rubyrailsapp
Diese Abbildung zeigt das Blazor-Logo.

Blazor ServerBlazor Server
Tutorial zum Anmelden von Benutzern durch eine Blazor Server-AppBlazor Server app signs-in users tutorial Aufruf von Microsoft Graph durch die Blazor Server-AppBlazor Server app calls Microsoft Graph

Chapterwise-Tutorial: Blazor Server-App zum Anmelden von Benutzern und Aufrufen von APIs mit Azure Active DirectoryChapterwise Tutorial: Blazor Server app to sign-in users and call APIs with Azure Active Directory

Öffentliche Desktop- und mobile Client-AppsDesktop and mobile public client apps

In den folgenden Beispielen werden öffentliche Clientanwendungen (Desktop-/mobile Anwendungen) veranschaulicht, die im Namen eines Benutzers auf die Microsoft Graph-API oder Ihre eigene Web-API zugreifen.The following samples show public client applications (desktop or mobile applications) that access the Microsoft Graph API, or your own web API in the name of a user. Mit Ausnahme des Beispiels Desktop (Konsole) mit WAM verwenden alle diese Clientanwendungen die Microsoft-Authentifizierungsbibliothek (Microsoft Authentication Library, MSAL).Apart from the Desktop (Console) with WAM sample, all these client applications use the Microsoft Authentication Library (MSAL).

ClientanwendungClient application PlattformPlatform Flow/ZuweisungFlow/grant Aufrufen von Microsoft GraphCalls Microsoft Graph Aufrufen einer ASP.NET Core-Web-APICalls an ASP.NET Core web API
Desktop-Tutorial (.NET Core): Optionale Verwendung von:Desktop tutorial (.NET Core) - Optionally using:

– plattformübergreifendes Tokencache- the cross platform token cache

– benutzerdefinierte Web-Benutzeroberfläche- custom web UI
Diese Abbildung zeigt das .NET/C#-Logo. AutorisierungscodeAuthorization code ms-identity-dotnet-desktop-tutorialms-identity-dotnet-desktop-tutorial
Desktop (WPF)Desktop (WPF) Diese Abbildung zeigt das .NET-Desktop/C#-Logo AutorisierungscodeAuthorization code dotnet-desktop-msgraph-v2dotnet-desktop-msgraph-v2 dotnet-native-aspnetcore-v2dotnet-native-aspnetcore-v2
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das .NET/C#-Logo (Desktop) Integrierte Windows-AuthentifizierungIntegrated Windows Authentication dotnet-iwa-v2dotnet-iwa-v2
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das Java-Logo. Integrierte Windows-AuthentifizierungIntegrated Windows Authentication ms-identity-java-desktopms-identity-java-desktop
Desktop (Konsole)Desktop (Console) Dies ist das .NET/C#-Logo (Desktop) Benutzername/KennwortUsername/Password dotnetcore-up-v2dotnetcore-up-v2
Desktop (Konsole) mit WAMDesktop (Console) with WAM Dies ist das Logo für .NET/C# (Desktop) Interaktiv mit Web Account Manager (WAM)Interactive with Web Account Manager (WAM) dotnet-native-uwp-wamdotnet-native-uwp-wam
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das Java-Logo. Benutzername/KennwortUsername/Password ms-identity-java-desktopms-identity-java-desktop
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das Python-Logo. Benutzername/KennwortUsername/Password ms-identity-python-desktopms-identity-python-desktop
Mobil (Android, iOS, UWP)Mobile (Android, iOS, UWP) Diese Abbildung zeigt das .NET/C#-Logo (Xamarin). AutorisierungscodeAuthorization code xamarin-native-v2xamarin-native-v2
Mobil (iOS)Mobile (iOS) Diese Abbildung zeigt das iOS-/Objective-C- oder Swift-Logo. AutorisierungscodeAuthorization code ios-swift-objc-native-v2ios-swift-objc-native-v2

ios-native-nxoauth2-v2ios-native-nxoauth2-v2
Desktop (macOS)Desktop (macOS) macOSmacOS AutorisierungscodeAuthorization code macOS-swift-objc-native-v2macOS-swift-objc-native-v2
Mobil (Android-Java)Mobile (Android-Java) Diese Abbildung zeigt das Android-Logo. AutorisierungscodeAuthorization code android-Javaandroid-Java
Mobil (Android-Kotlin)Mobile (Android-Kotlin) Diese Abbildung zeigt das Android-Logo. AutorisierungscodeAuthorization code android-Kotlinandroid-Kotlin

DaemonanwendungenDaemon applications

Die folgenden Beispiele zeigen eine Anwendung, die auf die Microsoft Graph-API mit ihrer eigenen Identität (ohne Benutzer) zugreift.The following samples show an application that accesses the Microsoft Graph API with its own identity (with no user).

ClientanwendungClient application PlattformPlatform Ablauf/ErteilungFlow/Grant Aufrufen von Microsoft GraphCalls Microsoft Graph
KonsoleConsole Diese Abbildung zeigt das .NET Core-Logo.

ASP.NETASP.NET
ClientanmeldeinformationenClient Credentials dotnetcore-daemon-v2dotnetcore-daemon-v2
Web-AppWeb app Screenshot mit dem ASP.NET-Logo

ASP.NETASP.NET
ClientanmeldeinformationenClient Credentials dotnet-daemon-v2dotnet-daemon-v2
KonsoleConsole Diese Abbildung zeigt das Java-Logo. ClientanmeldeinformationenClient Credentials ms-identity-java-daemonms-identity-java-daemon
KonsoleConsole Diese Abbildung zeigt das Python-Logo. ClientanmeldeinformationenClient Credentials ms-identity-python-daemonms-identity-python-daemon

Monitorlose AnwendungenHeadless applications

In den folgenden Beispielen wird eine öffentliche Clientanwendung veranschaulicht, die auf einem Gerät ohne Webbrowser ausgeführt wird.The following sample shows a public client application running on a device without a web browser. Diese App kann ein Befehlszeilentool sein oder unter Linux oder Mac ausgeführt werden, oder es kann sich um eine IoT-Anwendung handeln.The app can be a command-line tool, an app running on Linux or Mac, or an IoT application. In den Beispielen wird eine App verwendet, die im Namen eines Benutzers, der sich interaktiv an einem anderen Gerät anmeldet (z. B. einem Mobiltelefon), auf die Microsoft Graph-API zugreift.The sample features an app accessing the Microsoft Graph API, in the name of a user who signs-in interactively on another device (such as a mobile phone). Diese Clientanwendung verwendet die Microsoft-Authentifizierungsbibliothek (Microsoft Authentication Library, MSAL).This client application uses the Microsoft Authentication Library (MSAL).

ClientanwendungClient application PlattformPlatform Ablauf/ErteilungFlow/Grant Aufrufen von Microsoft GraphCalls Microsoft Graph
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das .NET/C#-Logo (Desktop). GerätecodeflowDevice code flow dotnetcore-devicecodeflow-v2dotnetcore-devicecodeflow-v2
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das Java-Logo. GerätecodeflowDevice code flow ms-identity-java-devicecodeflowms-identity-java-devicecodeflow
Desktop (Konsole)Desktop (Console) Diese Abbildung zeigt das Python-Logo. GerätecodeflowDevice code flow ms-identity-python-devicecodeflowms-identity-python-devicecodeflow

SaaS-Anwendungen mit mehreren MandantenMulti-tenant SaaS applications

In den folgenden Beispielen wird gezeigt, wie Sie Ihre Anwendung so konfigurieren, dass Anmeldungen von einem beliebigen Azure AD-Mandanten (Azure Active Directory) akzeptiert werden.The following samples show how to configure your application to accept sign-ins from any Azure Active Directory (Azure AD) tenant. Wenn Sie Ihre Anwendung als mehrinstanzenfähig konfigurieren, bedeutet das, dass Sie eine SaaS-Anwendung (Software-as-a-Service) für viele Organisationen anbieten können. Die Benutzer können sich dann bei Ihrer Anwendung anmelden, nachdem sie der Verwendung ihres Kontos zugestimmt haben.Configuring your application to be multi-tenant means that you can offer a Software as a Service (SaaS) application to many organizations, allowing their users to be able to sign-in to your application after consenting to use their account.

PlattformPlatform BESCHREIBUNGDescription LinkLink
Diese Abbildung zeigt das JavaScript-Logo. JavaScript (MSAL.js)This image shows the JavaScript logo JavaScript (MSAL.js) Mehrinstanzenfähige SPA ruft Graph-API auf.Multi-tenant SPA calls Graph API ms-identity-javascript-angular-spa-aspnet-webapi-multitenantms-identity-javascript-angular-spa-aspnet-webapi-multitenant
Diese Abbildung zeigt das Angular-Logo. Angular (MSAL-Angular)This image shows the Angular logo Angular (MSAL-Angular) Mehrinstanzenfähige SPA ruft mehrinstanzenfähige benutzerdefinierte Web-API aufMulti-tenant SPA calls multi-tenant custom Web API ms-identity-javascript-angular-spa-aspnet-webapi-multitenantms-identity-javascript-angular-spa-aspnet-webapi-multitenant
Diese Abbildung zeigt das ASP.NET Core-Logo. .NET Core (MSAL.NET)This image shows the ASP.NET Core logo .NET Core (MSAL.NET) ASP.NET Core-MVC-Webanwendung ruft Graph-API auf.ASP.NET Core MVC web application calls Graph API active-directory-aspnetcore-webapp-openidconnect-v2active-directory-aspnetcore-webapp-openidconnect-v2
Diese Abbildung zeigt das ASP.NET Core-Logo. .NET Core (MSAL.NET)This image shows the ASP.NET Core logo .NET Core (MSAL.NET) ASP.NET Core-MVC-Webanwendung ruft ASP.NET Core-Web-API auf.ASP.NET Core MVC web application calls ASP.NET Core Web API active-directory-aspnetcore-webapp-openidconnect-v2active-directory-aspnetcore-webapp-openidconnect-v2

Web-APIsWeb APIs

Die folgenden Beispiele veranschaulichen, wie Sie eine Web-API mit dem Microsoft Identity-Plattform-Endpunkt schützen und wie Sie eine nachgeschaltete API von der Web-API aus aufrufen.The following samples show how to protect a web API with the Microsoft identity platform endpoint, and how to call a downstream API from the web API.

PlattformPlatform BeispielSample
Diese Abbildung zeigt das ASP.NET Core-Logo.

ASP.NET CoreASP.NET Core
ASP.NET Core-Web-API (Dienst) von dotnet-native-aspnetcore-v2ASP.NET Core web API (service) of dotnet-native-aspnetcore-v2
Diese Abbildung zeigt das ASP.NET-Logo.

ASP.NET MVCASP.NET MVC
Web-API (Dienst) von ms-identity-aspnet-webapi-onbehalfofWeb API (service) of ms-identity-aspnet-webapi-onbehalfof
Diese Abbildung zeigt das Java-Logo. Web-API (Dienst) von ms-identity-java-webapiWeb API (service) of ms-identity-java-webapi
Diese Abbildung zeigt das Node.js-Logo. Web-API (Dienst) von active-directory-javascript-nodejs-webapi-v2Web API (service) of active-directory-javascript-nodejs-webapi-v2
Diese Abbildung zeigt das Node.js-Logo. B2C-Web-API (Dienst) von active-directory-b2c-javascript-nodejs-webapiB2C Web API (service) of active-directory-b2c-javascript-nodejs-webapi

Azure Functions als Web-APIsAzure Functions as web APIs

Die folgenden Beispiele veranschaulichen, wie Sie mit „HttpTrigger“ eine Azure-Funktion schützen, mit dem Microsoft Identity-Plattform-Endpunkt eine Web-API verfügbar machen und über die Web-API eine nachgeschaltete API aufrufen.The following samples show how to protect an Azure Function using HttpTrigger and exposing a web API with the Microsoft identity platform endpoint, and how to call a downstream API from the web API.

PlattformPlatform BeispielSample
Diese Abbildung zeigt das ASP.NET Core-Logo.

ASP.NET CoreASP.NET Core
ASP.NET Core-Web-API (Dienst)-Azure-Funktion von dotnet-native-aspnetcore-v2ASP.NET Core web API (service) Azure Function of dotnet-native-aspnetcore-v2
Diese Abbildung zeigt das Python-Logo.

PythonPython
Web-API (Dienst) von PythonWeb API (service) of Python
Diese Abbildung zeigt das Node.js-Logo.

Node.jsNode.js
Web-API (Dienst) von Node.js und Passport-Azure-ADWeb API (service) of Node.js and passport-azure-ad
Diese Abbildung zeigt das Node.js-Logo.

Node.jsNode.js
Web-API (Dienst) von Node.js und Passport-Azure-AD mithilfe von OnBehalfOfWeb API (service) of Node.js and passport-azure-ad using on behalf of

Weitere Microsoft Graph-BeispieleOther Microsoft Graph samples

Beispiele und Tutorials, die verschiedene Verwendungsmuster für die Microsoft Graph-API (einschließlich Authentifizierung mit Azure AD) veranschaulichen, finden Sie unter Beispiele und Tutorials der Microsoft Graph-Community.To learn about samples and tutorials that demonstrate different usage patterns for the Microsoft Graph API, including authentication with Azure AD, see Microsoft Graph Community samples & tutorials.

Weitere InformationenSee also

Microsoft Graph-API – Konzepte und ReferenzMicrosoft Graph API conceptual and reference