作者：Valeriy Novytskyy 和 Rick Anderson

此示例演示如何使用户能够使用在上一页中创建的 ASP.NET Core 6.0 项目，通过其工作、学校或个人 Microsoft 帐户登录。

如果没有 Microsoft 帐户，请选择“创建一个”。 登录后，你将被重定向到“应用注册”页面：

URI 段 /signin-microsoft 设为 Microsoft 身份验证提供程序的默认回叫。 可以通过类的MicrosoftAccountOptions继承RemoteAuthenticationOptions.CallbackPath属性配置 Microsoft 身份验证中间件时更改默认回调 URI。

存储敏感设置，例如 Microsoft 应用程序 (客户端) ID，该 ID 位于使用机密管理器的“证书&机密”页上创建的应用注册和客户端密码的“概述”页上。 对于此示例，请执行以下步骤：

按照启用机密存储中的说明初始化项目，以存储机密。

使用机密密钥 Authentication:Microsoft:ClientId 和 Authentication:Microsoft:ClientSecret 将敏感设置存储到本地机密存储：

所有平台上的环境变量分层键都不支持 : 分隔符。 __（双下划线）：

将身份验证服务添加到 Program：

重 AddAuthentication(IServiceCollection, String) 载设置 DefaultScheme 属性。 重 AddAuthentication(IServiceCollection, Action) 载允许配置身份验证选项，这些选项可用于为不同的目的设置默认身份验证方案。 后续调用以 AddAuthentication 替代以前配置 AuthenticationOptions 的属性。

AuthenticationBuilder 每个身份验证方案只能调用注册身份验证处理程序的扩展方法一次。 存在允许配置方案属性、方案名称和显示名称的重载。

有关 Microsoft 帐户身份验证支持的配置选项的详细信息，请参阅 MicrosoftAccountOptions API 参考。 这可用于请求有关用户的各种信息。

现在，你已使用 Microsoft 凭据登录。

当应用需要多个提供程序时，将提供程序扩展方法链接在后面 AddAuthentication：

如果应用部署在代理服务器或负载均衡器后面，则可能会将某些原始请求信息转发到请求标头中的应用。 此信息通常包括安全请求方案 (https)、主机和客户端 IP 地址。 应用不会自动读取这些请求标头以发现和使用原始请求信息。

方案用于通过外部提供程序影响身份验证流的链接生成。 丢失安全方案 (https) 会导致应用生成不正确且不安全的重定向 URL。

使用转发标头中间件以使应用可以使用原始请求信息来进行请求处理。

有关详细信息，请参阅配置 ASP.NET Core 以使用代理服务器和负载均衡器。

如果 Microsoft 帐户提供程序将你重定向到登录错误页面，请注意 URI 中直接跟在 #（井号标签）之后的错误标题和说明查询字符串参数。

尽管错误消息似乎表明 Microsoft 身份验证存在问题，但最常见的原因是应用程序 URI 与为 Web 平台指定的任何“重定向 URI”均不匹配。

如果未Identity通过调用services.AddIdentityConfigureServices来配置，尝试进行身份验证将导致 ArgumentException：必须提供“SignInScheme”选项。 本示例中使用的项目模板可确保完成此操作。

如果未通过应用初始迁移创建站点数据库，则会显示“处理请求时数据库操作失败”错误。 点击“应用迁移”，创建数据库并刷新以绕过错误继续操作。

此示例演示如何使用户能够使用在上一页中创建的 ASP.NET Core 3.0 项目，通过其工作、学校或个人 Microsoft 帐户登录。

如果没有 Microsoft 帐户，请选择“创建一个”。 登录后，你将被重定向到“应用注册”页面：

URI 段 /signin-microsoft 设为 Microsoft 身份验证提供程序的默认回叫。 可以通过类的MicrosoftAccountOptions继承RemoteAuthenticationOptions.CallbackPath属性配置 Microsoft 身份验证中间件时更改默认回调 URI。

存储敏感设置，例如 Microsoft 应用程序 (客户端) ID，该 ID 位于使用机密管理器的“证书&机密”页上创建的应用注册和客户端密码的“概述”页上。 对于此示例，请执行以下步骤：

按照启用机密存储中的说明初始化项目，以存储机密。

使用机密密钥 Authentication:Microsoft:ClientId 和 Authentication:Microsoft:ClientSecret 将敏感设置存储到本地机密存储：

所有平台上的环境变量分层键都不支持 : 分隔符。 __（双下划线）：

将 Microsoft 帐户服务添加到 Startup.ConfigureServices：

重 AddAuthentication(IServiceCollection, String) 载设置 DefaultScheme 属性。 重 AddAuthentication(IServiceCollection, Action) 载允许配置身份验证选项，这些选项可用于为不同的目的设置默认身份验证方案。 后续调用以 AddAuthentication 替代以前配置 AuthenticationOptions 的属性。

AuthenticationBuilder 每个身份验证方案只能调用注册身份验证处理程序的扩展方法一次。 存在允许配置方案属性、方案名称和显示名称的重载。

有关 Microsoft 帐户身份验证支持的配置选项的详细信息，请参阅 MicrosoftAccountOptions API 参考。 这可用于请求有关用户的各种信息。

运行应用并选择“登录”。 随即将显示一个使用 Microsoft 登录的选项。 选择“Microsoft”时，你会重定向到 Microsoft 进行身份验证。 使用你的 Microsoft 帐户登录后，系统将提示你允许该应用访问你的信息：

点击“是”，你将重定向到可在其中设置电子邮件的网站。

现在，你已使用 Microsoft 凭据登录。

当应用需要多个提供程序时，将提供程序扩展方法链接在后面 AddAuthentication：

如果应用部署在代理服务器或负载均衡器后面，则可能会将某些原始请求信息转发到请求标头中的应用。 此信息通常包括安全请求方案 (https)、主机和客户端 IP 地址。 应用不会自动读取这些请求标头以发现和使用原始请求信息。

方案用于通过外部提供程序影响身份验证流的链接生成。 丢失安全方案 (https) 会导致应用生成不正确且不安全的重定向 URL。

使用转发标头中间件以使应用可以使用原始请求信息来进行请求处理。

有关详细信息，请参阅配置 ASP.NET Core 以使用代理服务器和负载均衡器。

如果 Microsoft 帐户提供程序将你重定向到登录错误页面，请注意 URI 中直接跟在 #（井号标签）之后的错误标题和说明查询字符串参数。

尽管错误消息似乎表明 Microsoft 身份验证存在问题，但最常见的原因是应用程序 URI 与为 Web 平台指定的任何“重定向 URI”均不匹配。

如果未Identity通过调用services.AddIdentityConfigureServices来配置，尝试进行身份验证将导致 ArgumentException：必须提供“SignInScheme”选项。 本示例中使用的项目模板可确保完成此操作。

如果未通过应用初始迁移创建站点数据库，则会显示“处理请求时数据库操作失败”错误。 点击“应用迁移”，创建数据库并刷新以绕过错误继续操作。