快速入门:使用 MSAL Node 从 Node.js web 应用程序登录用户并调用 Microsoft Graph API

在本快速入门中,你将下载并运行一个代码示例,该示例演示 Node.js Web 应用如何使用授权代码流来让用户登录。 此代码示例还演示如何获取访问令牌来调用 Microsoft Graph API。

有关说明,请参阅示例工作原理

本快速入门通过身份验证代码流使用适用于 Node.js 的 Microsoft 身份验证库 (MSAL Node)。

先决条件

注册并下载快速入门应用程序

步骤 1:注册应用程序

提示

本文中的步骤可能因开始使用的门户而略有不同。

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心
  2. 如果你有权访问多个租户,请使用顶部菜单中的“设置”图标 ,通过“目录 + 订阅”菜单切换到你希望在其中注册应用程序的租户。
  3. 浏览至“标识”>“应用程序”>“应用注册”,选择“新建注册”。
  4. 输入应用程序的名称。 应用的用户可能会看到此名称,你稍后可对其进行更改。
  5. 在“支持的帐户类型”下,选择“仅此组织目录中的帐户” 。
  6. 将“重定向 URI”类型设置为 Web 并将值设置为 http://localhost:3000/auth/redirect
  7. 选择“注册” 。
  8. 在应用的“概述”页上,记下“应用程序(客户端) ID”值,供稍后使用 。
  9. 在“管理”下,选择“证书和机密”>“客户端密码”>“新建客户端密码”。 将说明留空并保留默认过期时间,然后选择添加
  10. 记下客户端密码的值供稍后使用

步骤 2:下载项目

若要使用 Node.js 在 Web 服务器中运行项目,请下载核心项目文件

步骤 3:配置 Node 应用

提取项目,打开 ms-identity-node-main 文件夹,然后打开 App 文件夹下的 .env 文件。 将上面的值如下所示进行替换:

变量 说明 示例
Enter_the_Cloud_Instance_Id_Here 在其中注册应用程序的 Azure 云实例 https://login.partner.microsoftonline.cn/(包括尾随正斜杠)
Enter_the_Tenant_Info_here 租户 ID 或主域 contoso.microsoft.comaaaabbbb-0000-cccc-1111-dddd2222eeee
Enter_the_Application_Id_Here 你已注册的应用程序的客户端 ID 00001111-aaaa-2222-bbbb-3333cccc4444
Enter_the_Client_Secret_Here 你已注册的应用程序的客户端机密 A1b-C2d_E3f.H4i,J5k?L6m!N7o-P8q_R9s.T0u
Enter_the_Graph_Endpoint_Here 你的应用将调用的 Microsoft Graph API 云实例 https://microsoftgraph.chinacloudapi.cn/(包括尾随正斜杠)
Enter_the_Express_Session_Secret_Here 用于对 Express 会话 cookie 进行签名的随机字符串 A1b-C2d_E3f.H4...

你的文件应与以下内容类似:

CLOUD_INSTANCE=https://login.partner.microsoftonline.cn/
TENANT_ID=aaaabbbb-0000-cccc-1111-dddd2222eeee
CLIENT_ID=00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET=A1b-C2d_E3f.H4...

REDIRECT_URI=http://localhost:3000/auth/redirect
POST_LOGOUT_REDIRECT_URI=http://localhost:3000

GRAPH_API_ENDPOINT=https://microsoftgraph.chinacloudapi.cn/

EXPRESS_SESSION_SECRET=6DP6v09eLiW7f1E65B8k

步骤 4:运行项目

使用 Node.js 运行项目。

  1. 若要启动服务器,请从项目目录中运行以下命令:

    cd App
    npm install
    npm start
    
  2. 转到 http://localhost:3000/

  3. 选择“登录”以启动登录过程。

    首次登录时,系统会提示你允许应用程序将你登录并访问你的个人资料。 成功登录后,你将被重定向回应用程序主页。

详细信息

示例工作原理

该示例在 localhost 端口 3000 上托管 Web 服务器。 当 Web 浏览器访问此地址时,应用将呈现主页。 用户选择“登录”后,应用将通过 MSAL 节点库生成的 URL 将浏览器重定向到 Microsoft Entra 登录屏幕。 用户同意后,浏览器会将用户与 ID 和访问令牌一起重定向回应用程序主页。

MSAL Node

MSAL Node 库会让用户登录,并请求用于访问受 Microsoft 标识平台保护的 API 的令牌。 可通过 Node.js 包管理器 (npm) 下载最新版本:

npm install @azure/msal-node

后续步骤

在以下多部分教程系列中,通过构建一个让用户登录的 ASP.NET Core Web 应用来了解详细信息: