适用于:
外部租户(详细了解)
身份验证方法: 嵌入式本机身份验证。
在本快速入门中,你将使用适用于 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 版本遵循本快速入门:
克隆存储库,签出示例修订,并打开其 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使用示例依赖项安装确切的 SDK 版本:
npm install --save-exact "@azure/msal-browser@5.29.1"
配置应用程序
在此边缘路由中,对服务授权机构和 SDK API 传输基址均使用 https://<tenant-verified-custom-domain>/<tenant-GUID>。 保留该 authority 的不透明绝对 HAL 链接不变。 不要将客户端密钥添加到浏览器配置中。
- 打开
src/config/auth-config.ts。 - 用应用程序 ID 替换
Enter_the_Application_Id_Here。 - 将完整的
auth.authority值替换为https://<tenant-verified-custom-domain>/<tenant-GUID>,并代入您已验证的主机名和租户 GUID。 - 添加
auth.knownAuthorities为包含已验证主机名的数组,而不使用方案或路径。 - 将所需的
customAuth.authApiProxyUrl字符串设置为同一个完整https://<tenant-verified-custom-domain>/<tenant-GUID>授权方。 在两个 SDK URL 设置中包含租户 GUID。 - 保存此配置文件。 V2 示例使用 SDK 的默认作用域,而不使用自定义声明。 MFA 要求来自租户策略,而不是从选择 V2。
运行示例
从示例目录运行应用程序。 此自定义域边缘配置不使用示例的本地 CORS 代理:
启动应用程序:
npm run dev在浏览器中打开
http://localhost:3000并选择 V2。 测试时让应用程序进程保持运行。
以测试客户身份登录
使用示例的统一启动器仅测试为当前事务启用的方法。
- 输入测试客户的电子邮件地址,然后选择 “登录”。
- 如果服务提供多个第一因素方法,请选择密码方法。 在请求时输入密码,然后选择 “登录”。
- 如果服务请求 MFA,请选择电子邮件或短信方式并输入其验证码。
- 确认示例报告已完成登录。 不要在屏幕截图、日志或支持输出中泄露令牌。
电子邮件一次性密码登录使用为该方法配置的客户帐户和用户流。 本快速入门介绍电子邮件和密码登录流程。
清理会话
在不删除共享租户配置的情况下结束本地测试。
从该示例中注销不会终止其他应用程序或浏览器会话。
- 退出该示例应用的登录状态,并清除与帐户相关的应用界面。
- 在终端中停止该应用程序进程。