快速入门:使用嵌入式原生身份验证登录

适用于:带有白色对勾标记的绿色圆圈,表示以下内容适用于外部租户。 外部租户(详细了解)

身份验证方法: 嵌入式本机身份验证。

在本快速入门中,你将使用适用于 JavaScript 5.29.1 的 Microsoft 身份验证库 (MSAL) 为 Embedded 本机身份验证配置 React Next.js 示例。 电子邮件和密码流程使用了经过租户验证、并在边缘启用了跨域资源共享(CORS)的自定义域名。

Important

本机身份验证 API V2 以预览版提供。 Native Authentication API V1 仍然正式发布。 有关适用于预览功能的法律条款,请参阅Microsoft Azure预览版的补充使用条款。

Prerequisites

  • 为 Embedded 本机身份验证配置的外部租户和公共客户端应用程序。 完成 配置应用程序。
  • 租户验证的自定义域、应用程序 ID 和目录租户 GUID。
  • 为示例的浏览器源 http://localhost:3000 配置的自定义域边缘 CORS。 将 共享代理协定 应用于源、预检、SDK 标头以及成功和错误响应。
  • 包含电子邮件和密码的客户帐户。 如果租户策略需要多重身份验证(MFA),请为此示例流程准备已启用的电子邮件或短信验证方式。
  • Node.js 20.9.0 或更高版本、npm、Git 和代码编辑器。
  • 端口 3000 可用于应用程序。

获取示例

该示例具有适用于 V1 和 V2 的统一启动器。 使用以下固定修订和 SDK 版本遵循本快速入门:

  1. 克隆存储库,签出示例修订,并打开其 React Next.js 应用程序:

    git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples
    cd ms-identity-ciam-native-javascript-samples
    git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808
    cd typescript/native-auth/react-nextjs-sample
    
  2. 使用示例依赖项安装确切的 SDK 版本:

    npm install --save-exact "@azure/msal-browser@5.29.1"
    

配置应用程序

在此边缘路由中,对服务授权机构和 SDK API 传输基址均使用 https://<tenant-verified-custom-domain>/<tenant-GUID>。 保留该 authority 的不透明绝对 HAL 链接不变。 不要将客户端密钥添加到浏览器配置中。

  1. 打开 src/config/auth-config.ts。
  2. 用应用程序 ID 替换 Enter_the_Application_Id_Here。
  3. 将完整的 auth.authority 值替换为 https://<tenant-verified-custom-domain>/<tenant-GUID>,并代入您已验证的主机名和租户 GUID。
  4. 添加 auth.knownAuthorities 为包含已验证主机名的数组,而不使用方案或路径。
  5. 将所需的 customAuth.authApiProxyUrl 字符串设置为同一个完整 https://<tenant-verified-custom-domain>/<tenant-GUID> 授权方。 在两个 SDK URL 设置中包含租户 GUID。
  6. 保存此配置文件。 V2 示例使用 SDK 的默认作用域,而不使用自定义声明。 MFA 要求来自租户策略,而不是从选择 V2。

运行示例

从示例目录运行应用程序。 此自定义域边缘配置不使用示例的本地 CORS 代理:

  1. 启动应用程序:

    npm run dev
    
  2. 在浏览器中打开 http://localhost:3000 并选择 V2。 测试时让应用程序进程保持运行。

以测试客户身份登录

使用示例的统一启动器仅测试为当前事务启用的方法。

  1. 输入测试客户的电子邮件地址,然后选择 “登录”。
  2. 如果服务提供多个第一因素方法,请选择密码方法。 在请求时输入密码,然后选择 “登录”。
  3. 如果服务请求 MFA,请选择电子邮件或短信方式并输入其验证码。
  4. 确认示例报告已完成登录。 不要在屏幕截图、日志或支持输出中泄露令牌。

电子邮件一次性密码登录使用为该方法配置的客户帐户和用户流。 本快速入门介绍电子邮件和密码登录流程。

清理会话

在不删除共享租户配置的情况下结束本地测试。

从该示例中注销不会终止其他应用程序或浏览器会话。

  1. 退出该示例应用的登录状态,并清除与帐户相关的应用界面。
  2. 在终端中停止该应用程序进程。