通过

Microsoft 标识平台代码示例

  • 项目

这些代码示例由 Microsoft 生成和维护，用于演示我们的身份验证库与 Microsoft 标识平台的使用。 常用的身份验证和授权方案在多种应用程序类型、开发语言和框架中实现。

  • 让用户登录到 Web 应用程序，并提供对受保护的 Web API 的授权访问。
  • 通过要求提供用于执行 API 操作的访问令牌来保护 Web API。

每个代码示例都包含 README.md 文件，该文件描述如何生成项目（如果适用）和如何运行示例应用程序。 代码中的注释有助于了解如何在应用程序中使用这些库，通过标识平台执行身份验证和授权。

注意

此页面目前正在维护，你可能会遇到一些无效的链接。 我们正在存档旧代码示例，并更新为新代码示例。 请稍后查看更新的示例。

示例和指南

使用选项卡按应用程序类型或首选语言/框架对示例进行排序。

单页应用程序

这些示例展示了如何编写由 Microsoft 标识平台保护的单页应用程序。 这些示例使用下列种类的 MSAL.js 之一。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
React 用户登录 MSAL React 采用 PKCE 的授权代码 快速入门 教程
Angular 用户登录 MSAL Angular 采用 PKCE 的授权代码 快速入门 教程
JavaScript • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 调用 Node.js Web API
• 调用 Node.js Web API (B2C)
• 部署到 Azure 存储和应用服务		 MSAL.js 采用 PKCE 的授权代码 快速入门
Blazor WebAssembly • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 部署到 Azure 应用服务		 MSAL.js 采用 PKCE 的授权代码 快速入门

Web 应用程序

以下示例演示了将用户登录的 Web 应用。 一些示例还演示了使用用户标识调用 Microsoft Graph 或你自己的 Web API 的应用程序。

语言/平台 GitHub 上的代码示例 身份验证库 身份验证流 快速入门 教程
ASP.NET • Microsoft Graph 训练示例
• 将用户登录并以管理员限制的范围调用 Microsoft Graph		 • MSAL.NET
• Microsoft.Identity.Web
• 高级令牌缓存场景		 • OpenID Connect
• 授权代码
• On-Behalf-Of (OBO)		 快速入门
ASP.NET Core • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 自定义令牌缓存
• 使用条件访问身份验证上下文执行升级身份验证
• 调用 Graph（多租户）
• 调用 Azure REST API
• 保护 Web API
• 保护 Web API (B2C)
• 保护多租户 Web API
• 使用应用角色进行访问控制
• 使用安全组进行访问控制
• 部署到 Azure 存储和应用服务
• Active Directory 联合身份验证服务迁移到 Microsoft Entra		 Microsoft.Identity.Web • OpenID Connect
• 授权代码
• 代理流 (OBO)		 快速入门 教程
Blazor • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 调用 Web API
• 调用 Web API (B2C)		 MSAL.NET 混合流
Java Spring • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 使用应用角色进行访问控制
• 使用组进行访问控制
• 保护 Web API
• 部署到 Azure 应用服务		 MSAL Java 授权代码 教程
Java Servlet • 将用户登录
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 使用应用角色进行访问控制
• 使用安全组进行访问控制
• 部署到 Azure 应用服务		 MSAL Java 授权代码 快速入门
Node.js Express • 将用户登录
• 使用 MSAL Node 和 Microsoft 标识平台构建的 Express Web 应用程序
• 将用户登录 (B2C)
• 调用 Microsoft Graph
• 通过 BFF 代理调用 Microsoft Graph
• 使用应用角色进行访问控制
• 使用安全组进行访问控制
• 部署到 Azure 应用服务		 MSAL Node • 授权代码
• 用于前端的后端 (BFF) 代理		 快速入门 教程
Python Flask • 将用户登录
• 以 Microsoft Entra ID 或 B2C 用户身份登录，并根据需要调用下游 API (Microsoft Graph) 的模板
• 部署到 Azure 应用服务		 MSAL Python 授权代码 快速入门 教程
Python Django 用户登录 MSAL Python 授权代码
Ruby 使用户登录并调用 Microsoft Graph OmniAuth OAuth2 授权代码

Web API

以下示例展示了如何使用 Microsoft 标识平台保护 Web API，以及如何从 Web API 调用下游 API。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
ASP.NET 调用 Microsoft Graph MSAL.NET On-Behalf-Of (OBO) 快速入门
ASP.NET Core 使用 Microsoft 标识平台进行访问控制（受保护的路由） MSAL.NET On-Behalf-Of (OBO) 快速入门 教程
Java 使用 Microsoft 标识平台保护 Java Spring Boot Web API MSAL Java On-Behalf-Of (OBO)
Node.js • 保护 Node.js Web API
• 使用 Azure AD B2C 保护 Node.js Web API		 MSAL Node 授权持有者

桌面

以下示例展示了以用户身份访问 Microsoft Graph API 或你自己的 Web API 的公共客户端桌面应用程序。 除了“使用 Web 身份验证管理器 (WAM) 的桌面（控制台）”示例，所有这些客户端应用程序均使用 Microsoft 身份验证库 (MSAL)。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
.NET Core • 调用 Microsoft Graph
• 使用令牌缓存调用 Microsoft Graph
• 使用自定义 Web UI HTML 调用 Microsoft Graph
• 使用自定义 Web 浏览器调用 Microsoft Graph
• 使用设备代码流将用户登录
• 通过使用用户名/密码登录用户来调用 Microsoft Graph
• 在 WinUI 桌面应用程序中使用 MSAL.NET 对用户进行身份验证		 MSAL.NET • 采用 PKCE 的授权代码
• 设备代码
• 资源所有者密码凭据
Java 调用 Microsoft Graph MSAL Java Windows 集成身份验证
Node.js 用户登录 MSAL Node 采用 PKCE 的授权代码 快速入门 教程
Python 用户登录 MSAL Python 资源所有者密码凭据
通用 Windows 平台 (UWP) 调用 Microsoft Graph MSAL.NET Web 帐户管理器 快速入门 教程
Windows Presentation Foundation (WPF) • 将用户登录并调用 Microsoft Graph
• Windows Presentation Foundation (WPF) 用户登录、受保护的 Web API 访问 (Microsoft Graph)
• 使用户登录并调用 ASP.NET Core Web API
• 将用户登录并调用 Microsoft Graph		 MSAL.NET 采用 PKCE 的授权代码 快速入门 教程

移动型

以下示例显示了访问 Microsoft Graph API 的公共客户端移动应用程序。 这些客户端应用程序均使用 Microsoft 身份验证库 (MSAL)。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
.NET Core • 使用 MAUI 调用 Microsoft Graph
•通过中转站使用 MAUI 调用 Microsoft Graph
• 使用 MAUI 调用 Active Directory B2C 租户		 MSAL.NET 采用 PKCE 的授权代码
iOS 调用 Microsoft Graph 本机 MSAL iOS 采用 PKCE 的授权代码 快速入门 教程
Java 使用户登录并调用 Microsoft Graph MSAL Android 采用 PKCE 的授权代码 快速入门 教程
Kotlin 使用户登录并调用 Microsoft Graph MSAL Android 采用 PKCE 的授权代码
Xamarin • 将用户登录并调用 Microsoft Graph
• 使用代理将用户登录并调用 Microsoft Graph		 MSAL.NET 采用 PKCE 的授权代码

服务/守护程序

下面的示例展示了一个应用程序，它使用自己的标识（没有用户）访问 Microsoft Graph API。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
.NET • 访问受保护 Web API 的 .NET 控制台应用
• 具有 Microsoft 标识平台终结点的多租户		 MSAL.NET 客户端凭据授予 快速入门 教程
.NET Core • 调用 Microsoft Graph
• 调用 Web API
• 使用托管标识和 Azure 密钥保管库		 MSAL.NET 客户端凭据授予
Java • 使用机密调用 Microsoft Graph
• 使用证书调用 Microsoft Graph		 MSAL Java 客户端凭据授予 快速入门
Node.js 使用机密调用 Microsoft Graph MSAL Node 客户端凭据授予 快速入门 教程
Python • 使用机密调用 Microsoft Graph
• 使用证书调用 Microsoft Graph		 MSAL Python 客户端凭据授予 快速入门

无浏览器（无外设）

以下示例展示了在没有 Web 浏览器的设备上运行的公共客户端应用程序。 该应用可以是命令行工具，可以是在 Linux 或 Mac 上运行的应用，还可以是 IoT 应用程序。 此示例提供了一个应用，以用户身份访问 Microsoft Graph API，该用户以交互方式在另一台设备上登录（例如移动电话）。 此客户端应用程序使用 Microsoft 身份验证库 (MSAL)。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
.NET Core 从纯文本设备调用受保护的 API MSAL.NET 设备代码
Java 使登录用户并从纯文本设备调用受保护的 API MSAL Java 设备代码
Python 调用 Microsoft Graph MSAL Python 设备代码

Azure Functions 作为 Web API

以下示例演示如何使用 HttpTrigger 保护 Azure Function 并通过 Microsoft 标识平台公开 Web API，以及如何从 Web API 调用下游 API。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
Python 受 Microsoft Entra ID 保护的 Python Azure 函数 Web API MSAL Python 授权代码

Microsoft Teams 应用程序

下面的示例演示了使用户登录的 Microsoft Teams Tab 应用程序。 此外，它还演示了如何使用 Microsoft 身份验证库 (MSAL)，利用用户的标识调用 Microsoft Graph API。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
Node.js Teams Tab 应用：单一登录 (SSO) 并调用 Microsoft Graph MSAL Node On-Behalf-Of (OBO)

多租户 SaaS

以下示例演示了如何配置应用程序，使其接受来自 Microsoft Entra 租户的登录。 将应用程序配置为多租户是指，你可向多个组织提供软件即服务 (SaaS) 应用程序，使它们的用户能够在同意后登录到你的应用程序。

语言 /
平台		 代码示例
（在 GitHub 上）		 Auth
库		 身份验证流 快速入门 教程
ASP.NET Core • ASP.NET Core MVC Web 应用程序调用 Microsoft Graph API
• ASP.NET Core MVC Web 应用程序调用 ASP.NET Core Web API		 MSAL.NET • OpenID Connect
• 授权代码

相关内容

若要深入了解更多示例代码，请参阅：