Microsoft 标识平台应用类型和身份验证流

Microsoft 标识平台支持对于各种新式应用程序体系结构的身份验证。 所有这些体系结构基于行业标准协议 OAuth 2.0 和 OpenID Connect。 使用 Microsoft 标识平台的身份验证库,应用程序可以对标识进行身份验证并获得令牌,以便访问受保护的 API。

本文介绍身份验证流及其应用方案。

应用程序类别

安全令牌可以从几种类型的应用程序中获取,包括:

  • Web 应用
  • 移动应用
  • 桌面应用
  • Web API

还可以通过设备上运行的应用获取令牌,这些设备没有浏览器或在物联网 (IoT) 上运行。

以下部分介绍应用程序的类别。

受保护的资源与客户端应用程序

身份验证方案涉及两个活动:

  • 获取受保护的 Web API 的安全令牌:我们建议使用 Microsoft 开发和支持的 Microsoft 身份验证库 (MSAL)
  • 保护 Web API 或 Web 应用:保护这些资源的一大难题是验证安全令牌。 Microsoft 在某些平台上提供中间件库

涉及或不涉及用户

大多数身份验证方案代表已登录的用户获取令牌。

Scenarios with users

但是,也有守护程序应用。 在这些方案中,应用程序以自身身份获取令牌,而不涉及到用户。

Scenarios with daemon apps

单页、公共客户端和机密客户端应用程序

可通过多种类型的应用程序获取安全令牌。 这些应用程序往往划分为以下三种类别。 每种应用程序配合不同的库和对象使用。

  • 单页应用程序:简称为 SPA。它们是一些 Web 应用,其中的令牌是通过浏览器中运行的 JavaScript 或 TypeScript 应用获取的。 许多新式应用的前端都有一个单页应用程序(主要用 JavaScript 编写)。 该应用程序通常使用 Angular、React 或 Vue 等框架。 MSAL 是唯一支持单页应用程序的 Microsoft 身份验证库。

  • 公共客户端应用程序:此类别中的应用(例如以下类型)始终以用户身份登录:

    • 以登录的用户身份调用 Web API 的桌面应用
    • 移动应用
    • 在没有浏览器的设备上运行的应用,例如,在 IoT 上运行的应用
  • 机密客户端应用程序:此类别中的应用包括:

    • 调用 Web API 的 Web 应用
    • 调用 Web API 的 Web API
    • 守护程序应用(即使实施为 Linux 守护程序或 Windows 服务等控制台服务)

登录受众

可用的身份验证流因登录受众而异。

有关详细信息,请参阅支持的帐户类型

应用程序类型

Microsoft 标识平台支持对于以下应用体系结构的身份验证:

  • 单页应用
  • Web 应用
  • Web API
  • 移动应用
  • 本机应用
  • 守护程序应用
  • 服务器端应用

应用程序使用不同的身份验证流将用户登录和获取令牌,以调用受保护的 API。

单页应用程序

许多新式 Web 应用都是作为客户端单页应用程序构建的。 这些应用程序使用 JavaScript 或框架(例如 Angular、Vue 和 React)。 这些应用程序在 Web 浏览器中运行。

单页应用程序在身份验证特征方面与传统的服务器端 Web 应用不同。 单页应用程序可以使用 Microsoft 标识平台将用户登录,并获取用于访问后端服务或 Web API 的令牌。 Microsoft 标识平台为 JavaScript 应用程序提供两种授权类型:

MSAL.js (2.x) MSAL.js (1.x)
A single-page application auth A single-page application implicit

以用户身份登录的 Web 应用

A web app that signs in a user

为了帮助保护以用户身份登录的 Web 应用:

  • 如果在 .NET 中进行开发,请使用包含 ASP.NET OpenID Connect 中间件的 ASP.NET 或 ASP.NET Core。 保护资源涉及到验证安全令牌,为此,可以使用适用于 .NET 的 IdentityModel 扩展,但不能使用 MSAL 库。

  • 如果在 Node.js 中进行开发,将使用 MSAL Node

有关详细信息,请参阅可将用户登录的 Web 应用

以用户身份登录并以用户身份调用 Web API 的 Web 应用

A web app calling web APIs

若要以用户身份通过 Web 应用调用 Web API,请使用授权代码流,并在令牌缓存中存储获取的令牌。 必要时,MSAL 可刷新令牌,而控制器可从缓存中以无提示方式获取令牌。

有关详细信息,请参阅调用 Web API 的 Web 应用

以登录用户身份调用 Web API 的桌面应用

要使桌面应用能够以登录用户身份调用 Web API,请使用 MSAL 的交互式令牌获取方法。 使用这些交互方法可以控制登录 UI 体验。 MSAL 使用 Web 浏览器进行这种交互。

A desktop app calling a web API

对于已加入 Windows 域或者由 Microsoft Entra ID 管理的计算机上的 Windows 托管应用程序,存在另一种可能的情况。 这些应用程序可以使用 Windows 集成身份验证以无提示方式获取令牌。

在无浏览器的设备上运行的应用程序仍可代表用户调用 API。 若要进行身份验证,用户必须登录到有 Web 浏览器的另一台设备。 此方案要求使用设备代码流

Device code flow

可以在公共客户端应用程序中使用用户名/密码流,不过我们并不建议使用。 在某些方案(例如 DevOps)中仍需要此流。

使用用户名/密码流会使应用程序受限。 例如,应用程序无法以需要使用 Microsoft Entra ID 中的多重身份验证或条件访问的用户身份登录。 应用程序也无法受益于单一登录。 使用用户名/密码流进行身份验证的方式违反新式身份验证的原则,仅仅是出于遗留原因而提供的。

在桌面应用中,如果希望令牌缓存持久,请自定义令牌缓存序列化。 通过实施双重令牌缓存序列化,可以使用后向兼容和前向兼容的令牌缓存。

有关详细信息,请参阅调用 Web API 的桌面应用

以交互式用户身份调用 Web API 的移动应用

类似于桌面应用,移动应用调用 MSAL 的交互式令牌获取方法来获取用于调用 Web API 的令牌。

A mobile app calling a web API

MSAL iOS 和 MSAL Android 默认使用系统 Web 浏览器。 但是,你可以指示它们改用嵌入式 Web 视图。 根据以下移动平台,存在一些特殊情况:通用 Windows 平台 (UWP)、iOS 或 Android。

某些方案(例如,涉及到与设备 ID 或设备注册相关的条件访问的方案)要求在设备上安装一个中介。 中介的示例包括 Android 上的 Microsoft 公司门户,以及 Android 和 iOS 上的 Microsoft Authenticator。 MSAL 现在可与中介交互。 有关中转站的详细信息,请参阅利用 Android 和 iOS 上的中转站

有关详细信息,请参阅调用 Web API 的移动应用

注意

对于使用 MSAL.iOS、MSAL.Android 或 Xamarin 上的 MSAL.NET 的移动应用,可以应用应用保护策略。 例如,策略可以阻止用户复制受保护的文本。 移动应用由 Intune 托管,由 Intune 识别为托管应用。 有关详细信息,请参阅 Microsoft Intune App SDK 概述

Intune 应用 SDK 独立于 MSAL 库,可自行与 Microsoft Entra ID 交互。

受保护的 Web API

可以使用 Microsoft 标识平台终结点来保护 Web 服务,例如应用的 RESTful API。 通过访问令牌调用受保护的 Web API。 该令牌帮助保护 API 的数据并对传入请求进行身份验证。 Web API 调用方会在 HTTP 请求的授权标头中追加一个访问令牌。

如果要保护 ASP.NET 或 ASP.NET Core web API,请验证访问令牌。 可以使用 ASP.NET JWT 中间件进行这种验证。 验证是由适用于.NET 的 IdentityModel 扩展库而不是 MSAL.NET 完成的。

有关详细信息,请参阅受保护的 Web API

以用户身份调用另一个 Web API 的 Web API

要使受保护的 Web API 能以用户身份调用另一个 Web API,应用需要获取下游 Web API 的令牌。 此类调用有时称为服务到服务调用。 调用其他 Web API 的 Web API 需要提供自定义缓存序列化。

A web API calling another web API

有关详细信息,请参阅调用 Web API 的 Web API

在守护程序名称中调用 Web API 的守护程序应用

包含长时运行进程或无需用户交互即可运行的应用还需要通过某种方式访问安全的 Web API。 此类应用可以使用应用的标识进行身份验证和获取令牌。 应用将使用客户端机密或证书来证明其身份。

可以编写此类使用 MSAL 中的客户端凭据获取方法获取调用应用令牌的守护程序应用。 这些方法要求将客户端机密添加到 Microsoft Entra ID 中的应用注册。 然后,该应用将与被调用守护程序共享机密。 此类机密的示例包括应用程序密码、证书断言和客户端断言。

A daemon app called by other apps and APIs

有关详细信息,请参阅调用 Web API 的守护程序应用程序

方案和受支持的身份验证流

使用身份验证流实现请求令牌的应用程序方案。 应用程序方案和身份验证流之间不存在一对一的映射。

涉及到获取令牌的方案还会映射到 OAuth 2.0 身份验证流。 有关详细信息,请参阅 Microsoft 标识平台上的 OAuth 2.0 和 OpenID Connect 协议

方案 详细方案演练 OAuth 2.0 流和授权 目标受众
Single-Page App with Auth code 单页应用 采用 PKCE 的授权代码 工作或学校帐户和 Azure Active Directory B2C (Azure AD B2C)
Single-Page App with Implicit 单页应用 隐式 工作或学校帐户和 Azure Active Directory B2C (Azure AD B2C)
Web app that signs in users 用于登录用户的 Web 应用 授权代码 工作或学校帐户和 Azure AD B2C
Web app that calls web APIs 用于调用 Web API 的 Web 应用 授权代码 工作或学校帐户和 Azure AD B2C
Desktop app that calls web APIs 用于调用 Web API 的 桌面应用 使用授权代码和 PKCE 的交互式方法 工作或学校帐户和 Azure AD B2C
Windows 集成身份验证 工作或学校帐户
资源所有者密码 工作或学校帐户和 Azure AD B2C
Browserless application 设备代码 工作或学校帐户,但不是 Azure AD B2C
Mobile app that calls web APIs 用于调用 Web API 的移动应用 使用授权代码和 PKCE 的交互式方法 工作或学校帐户和 Azure AD B2C
资源所有者密码 工作或学校帐户和 Azure AD B2C
Daemon app that calls web APIs 调用 Web API 的守护程序应用 客户端凭据 不涉及用户的仅限应用的权限,仅用于 Microsoft Entra 组织
Web API that calls web APIs 用于调用 Web API 的 Web API 代理 工作或学校帐户

方案和受支持的平台和语言

Microsoft 身份验证库支持多种平台:

  • .NET
  • .NET Framework
  • Java
  • JavaScript
  • macOS
  • 本机 Android
  • 本机 iOS
  • Node.js
  • Python
  • Windows 10/UWP
  • Xamarin.iOS
  • Xamarin.Android

你还可以使用多种语言来构建你的应用程序。

在下表的“Windows”列中,每当提到 .NET 时,表示 .NET Framework 也可用。 省略后者是为了避免表格内容混杂。

方案 Windows Linux Mac iOS Android
单页应用
Single-Page App Auth
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js MSAL.js MSAL.js
MSAL.js
单页应用
Single-Page App Implicit
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js
MSAL.js MSAL.js MSAL.js
MSAL.js
用于登录用户的 Web 应用
Web app that signs-in users
ASP.NET Core
ASP.NET Core MSAL Node
MSAL Node
ASP.NET Core
ASP.NET Core MSAL Node
MSAL Node
ASP.NET Core
ASP.NET Core MSAL Node
MSAL Node
用于调用 Web API 的 Web 应用

Web app that calls web APIs
ASP.NET Core
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
Flask + MSAL Python MSAL Node
MSAL Node
ASP.NET Core
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
Flask + MSAL Python MSAL Node
MSAL Node
ASP.NET Core
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
Flask + MSAL Python MSAL Node
MSAL Node
用于调用 Web API 的 桌面应用

Desktop app that calls web APIsDevice code flow
.NETMSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NETMSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NETMSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python
MSAL Node
MSAL Node
iOS / Objective C or swift MSAL.objc
用于调用 Web API 的移动应用
Mobile app that calls web APIs
UWP MSAL.NET Xamarin MSAL.NET iOS / Objective C or swift MSAL.objc Android MSAL.Android
守护程序应用
Daemon app
.NETMSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NET MSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NETMSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
用于调用 Web API 的 Web API

Web API that calls web APIs
ASP.NET Core
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NET
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node
.NET
ASP.NET Core + MSAL.NET MSAL Java
MSAL Java
MSAL Python
MSAL Python MSAL Node
MSAL Node

有关详细信息,请参阅 Microsoft 标识平台身份验证库

后续步骤

有关身份验证的详细信息,请参阅: