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)。

移动型

以下示例显示了访问 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。

无浏览器(无外设)

以下示例展示了在没有 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
• 授权代码

若要深入了解更多示例代码,请参阅: