【Azure 应用服务】NodeJS Express + MSAL 应用实现AAD集成登录并部署在App Service Linux环境中的实现步骤

问题描述

实现部署NodeJS Express应用在App Service Linux环境中，并且使用Microsoft Authentication Library(MSAL)来实现登录Azure AD用户，获取Token及用户信息的实现。

终极实现效果展示：

nodejs msal.gif

本实现中，最重要的两个步骤为：

1）根据文档“ Tutorial: Sign in users and acquire a token for Microsoft Graph in a Node.js & Express web app” 实现本地运行成功

2）根据文档" 在 Azure 中创建 Node.js Web 应用 " 把应用部署在App Service Linux环境中，然后在Configuration中添加Application Setting(REDIRECT_URI 和 POST_LOGOUT_REDIRECT_URI)

实验步骤

第一步：创建本地NodeJS Express + MSAL 项目

在第一个文档中，主要的步骤有（文档链接：https://docs.microsoft.com/en-us/azure/active-directory/develop/tutorial-v2-nodejs-webapp-msal）

如果想自己写代码，则必看。如果不用写代码，可以在文中下载源代码。但也必看1，4两部分内容。

Register the application in the Azure portal
Create an Express web app project
Install the authentication library packages
Add app registration details
Add code for user login
Test the app

根据文档，主要注意修改的地方有两处：

一：.env环境变量文件中的相应值需要根据在Azure AD中注册的内容修改。可以参考以下内容(本文实现在中国区Azure，所以相关endpoint都为中国区Azure终结点）

CLOUD_INSTANCE=https://login.partner.microsoftonline.cn/ # cloud instance string should end with a trailing slash
TENANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx #Enter_the_Tenant_Info_Here
CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # Enter_the_Application_Id_Here
CLIENT_SECRET=x-x.xxxxxxxxxxxx # Enter_the_Client_Secret_Here
REDIRECT_URI=http://localhost:3000/auth/redirect
POST_LOGOUT_REDIRECT_URI=http://localhost:3000
GRAPH_API_ENDPOINT=https://microsoftgraph.chinacloudapi.cn/ # graph api endpoint string should end with a trailing slash
EXPRESS_SESSION_SECRET=Enter_the_Express_Session_Secret_Here

CLOUD_INSTANCE：根据使用的Azure环境决定，如果是中国区Azure，则是https://login.partner.microsoftonline.cn/ ，如果是全球Azure，则是 https://login.microsoftonline.com/ ，更多请见：https://docs.microsoft.com/en-us/azure/active-directory/develop/authentication-national-cloud
TENANT_ID：应为在Azure AD中所注册应用的Tenant ID
CLIENT_ID：应为在Azure AD中所注册应用的Application ID
CLIENT_SECRET：将此值替换为先前创建的客户端机密。若要生成新密钥，请在 Azure 门户的应用注册设置中使用“证书和机密”
REDIRECT_URI：访问应用时，指定回调页面URL
POST_LOGOUT_REDIRECT_URI：点击Logout后，回调到主页的设置
GRAPH_API_ENDPOINT： Microsoft Graph API 的终结点，中国区Azure为：https://microsoftgraph.chinacloudapi.cn/ ，全球Azure为：https://graph.microsoft.com/
EXPRESS_SESSION_SECRET：这是用于登录Express Seesion 的机密，选择一个随机的字符串就可以，本实验中可以不用修改

image.png

（以上页面由 https://portal.azure.cn/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps 页面中选择进入）