大网数据广告活动
Azure 网站与应用

身份验证和授权

· 52CE 我爱测

了解 Azure 应用服务和 Azure Functions 中内置的身份验证和授权支持,并了解它如何保护应用,防止未经授权的访问。

Azure 应用服务提供内置的身份验证和授权支持。只需在 Web 应用、RESTful API、移动后端和 Azure Functions 中编写少量的代码或根本无需编写代码,就能让用户登录和访问数据。 本文介绍应用服务如何帮助简化应用的身份验证和授权。

安全身份验证和授权需要深入了解安全性,包括联合身份验证、加密、 JSON web 令牌 (JWT) 管理、 授予类型,等等。 应用服务提供这些实用工具,让你将更多的时间和精力花费在为客户提供业务价值上。

Important: 你并非必须使用此功能进行身份验证和授权。 可以在所选的 Web 框架中使用捆绑的安全功能,也可以编写自己的实用程序。 但请记住,Chrome 80 针对 Cookie 对其实现 SameSite 的方式进行了中断性变更(发布日期在 2020 年 3 月左右);自定义远程身份验证或依赖于跨站点 Cookie 发布的其他方案可能会在客户端 Chrome 浏览器更新时中断。 解决方法很复杂,因为需要针对不同的浏览器支持不同的 SameSite 行为。

应用服务托管的 ASP.NET Core 2.1 及更高版本已针对此中断性变更进行了修补,并且会相应地处理 Chrome 80 和更低版本的浏览器。 此外,我们还在整个 2020 年 1 月在应用服务实例上部署了 ASP.NET Framework 4.7.2 的同一修补程序。 有关详细信息,请参阅 Azure 应用服务 SameSite Cookie 更新。

Note: “身份验证/授权”功能有时也称为“简单身份验证/授权”。

Note: 启用此功能会导致对应用程序的所有非安全 HTTP 请求自动重定向到 HTTPS,而不管强制实施 HTTPS 所需的应用服务配置设置如何。 如果需要,可以通过身份验证/授权设置配置文件中的 requireHttps 设置禁用此功能,但需注意确保不通过非安全 HTTP 连接传输安全令牌。

有关特定于本机移动应用的信息,请参阅使用 Azure 应用服务对移动应用进行用户身份验证和授权。

工作原理

在 Windows 上

身份验证和授权模块在应用程序代码所在的同一沙盒中运行。 启用后,每个传入的 HTTP 请求将通过此模块,然后由应用程序代码处理。

一个体系结构图,显示请求被站点沙盒中的进程拦截,该进程与标识提供者进行交互,然后再允许流量发往已部署的站点

此模块为应用处理多项操作:

  • 使用指定的提供程序对用户进行身份验证
  • 验证、存储和刷新令牌
  • 管理经过身份验证的会话
  • 将标识信息插入请求标头

此模块独立于应用程序代码运行,使用应用设置进行配置。 不需要任何 SDK、特定语言,或者对应用程序代码进行更改。

在容器上

身份验证和授权模块在独立于应用程序代码的单独容器中运行。 使用所谓的 代表模式,它与传入流量交互,以执行与 Windows 相同的功能。 由于它不在进程内运行,因此不能与特定的语言框架直接集成;但是,应用需要的相关信息通过使用请求标头(如下所述)进行传递。

用户/应用程序声明

对于所有语言框架,应用服务都通过将传入令牌(无论是来自经过身份验证的最终用户还是来自客户端应用程序)中的声明注入请求标头,使其可供代码使用。 对于 ASP.NET 4.6 应用,应用服务会在 ClaimsPrincipal.Current 中填充经过身份验证的用户声明,使你能够遵循标准的 .NET 代码模式(包括 [Authorize] 属性)。 同样,对于 PHP 应用,应用服务会填充 _SERVER['REMOTE_USER'] 变量。 对于 Java 应用,可从 Tomcat servlet 访问声明。

对于 Azure Functions,没有为 .NET 代码填充 ClaimsPrincipal.Current,但你仍然可以在请求标头中找到用户声明,也可通过请求上下文甚至通过绑定参数来获取 ClaimsPrincipal 对象。 有关详细信息,请参阅使用客户端标识。

有关详细信息,请参阅访问用户声明。

Note: 目前,ASP.NET Core 不支持为当前用户填充身份验证/授权功能。 但是,确实存在一些第三方开源中间件组件,可以帮助填补这一空白。

令牌存储

应用服务提供内置的令牌存储,这是与 Web 应用、API 或本机移动应用的用户相关联的令牌存储库。 对任何提供程序启用身份验证时,此令牌存储可立即供应用使用。 如果应用程序代码需要代表用户访问这些提供程序中的数据,例如:

  • 发布到经过身份验证的用户的 Facebook 时间线
  • 使用 Microsoft Graph API 读取用户的公司数据

通常,必须编写代码才能在应用程序中收集、存储和刷新这些令牌。 使用令牌存储,只需在需要令牌时才检索令牌;当令牌失效时,可以告知应用服务刷新令牌。

将为经身份验证的会话缓存 ID 令牌、访问令牌和刷新令牌,它们只能由关联的用户访问。

如果不需要在应用中使用令牌,可以在应用的“身份验证/授权”页中禁用令牌存储。

日志记录和跟踪

如果启用应用程序日志记录,将在日志文件中直接看到身份验证和授权跟踪。 如果出现意外的身份验证错误,查看现有的应用程序日志即可方便找到所有详细信息。 如果启用失败请求跟踪,可以确切地查看身份验证和授权模块在失败请求中发挥的作用。 在跟踪日志中,找到对名为 EasyAuthModule_32/64 的模块的引用。

标识提供者

应用服务使用 联合标识,其中第三方标识提供者为你管理用户标识和身份验证流。 默认提供五个标识提供者:

提供程序 登录终结点
Azure Active Directory /.auth/login/aad
Microsoft 帐户 /.auth/login/microsoftaccount
Facebook /.auth/login/facebook
Google /.auth/login/google
Twitter /.auth/login/twitter
任何 OpenID Connect 提供程序(预览版) /.auth/login/<providerName>

对其中一个提供程序启用身份验证和授权时,其登录终结点可用于用户身份验证,以及验证来自提供程序的身份验证令牌。 可以轻松为用户提供其中任意数量的登录选项。

存在旧版可扩展性路径,用于与其他标识提供者或自定义身份验证/授权解决方案集成,但是不建议使用, 而应考虑使用 OpenID Connect 支持。

身份验证流

身份验证流对于所有提供程序是相同的,但根据是否要使用提供程序的 SDK 登录而有所差别:

  • 不使用提供程序 SDK:应用程序向应用服务委托联合登录。 浏览器应用通常采用此方案,这可以防止向用户显示提供程序的登录页。 服务器代码管理登录过程,因此,此流也称为“服务器导向流”或“服务器流”。 此方案适用于浏览器应用。 它也适用于使用移动应用客户端 SDK 登录用户的本机应用,因为 SDK 会打开 Web 视图,使用应用服务身份验证将用户登录。
  • 使用提供程序 SDK:应用程序手动将用户登录到提供程序,然后将身份验证令牌提交给应用服务进行验证。 无浏览器应用通常采用此方案,这可以防止向用户显示提供程序的登录页。 应用程序代码管理登录过程,因此,此流也称为“客户端导向流”或“客户端流”。 此方案适用于 REST API、Azure Functions 和 JavaScript 浏览器客户端,以及在登录过程中需要更高灵活性的浏览器应用。 它还适用于使用提供程序 SDK 登录用户的本机移动应用。

Note: 对于应用服务中受信任浏览器应用对应用服务或 Azure Functions 中另一 REST API 的调用,可以使用服务器导向流对其进行身份验证。 有关详细信息,请参阅在应用服务中自定义身份验证和授权。

下表说明了身份验证流的步骤。

步骤 不使用提供程序 SDK 使用提供程序 SDK
1.将用户登录 将客户端重定向到 /.auth/login/<provider>。 客户端代码直接使用提供程序的 SDK 将用户登录,并接收身份验证令牌。 有关详细信息,请参阅提供程序文档。
2.身份验证后 提供程序将客户端重定向到 /.auth/login/<provider>/callback。 客户端代码将来自提供程序的令牌发布到/.auth/login/<provider> 进行验证。
3.建立经过身份验证的会话 应用服务将经过身份验证的 Cookie 添加到响应中。 应用服务将自身的身份验证令牌返回给客户端代码。
4.提供经过身份验证的内容 客户端在后续请求中包含身份验证 Cookie(由浏览器自动处理)。 客户端代码在 X-ZUMO-AUTH 标头中提供身份验证令牌(由移动应用客户端 SDK 自动处理)。

对于客户端浏览器,应用服务可自动将所有未经身份验证的用户定向到 /.auth/login/<provider>。 还可以向用户提供一个或多个 /.auth/login/<provider> 链接,让他们使用所选的提供程序登录到你的应用。

授权行为

在 Azure 门户中,当传入请求未经过身份验证时,可以使用多种行为配置应用服务授权。

一个屏幕截图,显示“请求未通过身份验证时要采取的操作”下拉列表

以下标题介绍了选项。

允许匿名请求(无操作)

此选项将对未经身份验证的流量的授权交给应用程序代码处理。 对于经过身份验证的请求,应用服务还会在 HTTP 标头中一起传递身份验证信息。

使用此选项可以更灵活地处理匿名请求。 例如,可以向用户提供多个登录提供程序。 但是,必须编写代码。

仅允许经过身份验证的请求

选项是“使用 <provider> 登录”。 应用服务将所有匿名请求重定向到所选提供程序的 /.auth/login/<provider>。 如果匿名请求来自本机移动应用,则返回的响应为 HTTP 401 Unauthorized。

使用此选项不需要在应用中编写任何身份验证代码。 可以通过检查用户的声明来处理精细授权,例如角色特定的授权(请参阅访问用户声明)。

Caution: 以这种方式限制访问适用于对应用的所有调用,对于想要主页公开可用的应用程序来说,这可能是不可取的,就像在许多单页应用程序中一样。

Note: 默认情况下,Azure AD 租户中的任何用户都可以从 Azure AD 请求应用程序的令牌。 若要仅允许一组定义的用户访问应用,可以在 Azure AD 中配置应用程序。

更多资源

特定于提供程序的操作方法指南:

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 07/08/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。