如何使用React JS和AWS实现Microsoft Outlook身份验证
React JS 实现Microsoft Outlook身份验证分步操作指南
前置准备
- 已注册有效的Azure AD账号(Outlook身份验证依托微软Azure AD服务实现,免费层配额即可满足普通开发需求)
- 本地已搭建好React项目开发环境,包含
node.js、npm/yarn包管理工具 - 若需要同步认证信息到AWS服务,需提前开通AWS账号并配置对应权限,纯前端认证可忽略该要求
步骤1:配置Azure AD应用注册
- 登录Azure Portal,进入Azure Active Directory服务
- 选择左侧菜单「应用注册」,点击「新注册」
- 填写应用名称,选择支持的账户类型为「任何组织目录中的账户和个人Microsoft账户」(覆盖所有Outlook用户)
- 重定向URI填写你的React应用地址,本地开发填
http://localhost:3000,生产环境填对应部署域名 - 注册完成后记录下应用程序(客户端) ID、目录(租户) ID两个参数备用
- 进入「证书和密码」页面,后端集成场景需新建客户端密码并记录值,纯前端SPA场景可跳过该配置
- 进入「API权限」页面,添加
Microsoft Graph的委托权限,勾选openid、email、profile(如果需要读取邮箱内容可额外勾选Mail.Read),点击授予管理员同意
步骤2:React项目集成微软身份验证库
- 安装官方MSAL React依赖包,执行命令:
npm install @azure/msal-react @azure/msal-browser - 在项目src目录下新建
msalConfig.js配置文件,填入之前记录的参数:
export const msalConfig = { auth: { clientId: "你之前记录的客户端ID", authority: "https://login.microsoftonline.com/common", // 支持所有类型Outlook用户登录 redirectUri: window.location.origin, }, cache: { cacheLocation: "sessionStorage", storeAuthStateInCookie: false, } }; export const loginRequest = { scopes: ["openid", "profile", "email"] };
- 打开项目入口文件
index.js,用MSALProvider包裹根组件:
import { MsalProvider } from "@azure/msal-react"; import { PublicClientApplication } from "@azure/msal-browser"; import { msalConfig } from "./msalConfig"; const msalInstance = new PublicClientApplication(msalConfig); ReactDOM.render( <MsalProvider instance={msalInstance}> <App /> </MsalProvider>, document.getElementById("root") );
注意:测试时请确保Azure AD配置的重定向URI和当前React应用访问地址完全一致,包括http/https协议、端口号,否则会出现登录失败报错
步骤3:实现登录登出逻辑与用户信息获取
- 在需要显示登录入口的组件中引入相关钩子,示例代码如下:
import { useMsal, useAccount } from "@azure/msal-react"; import { loginRequest } from "./msalConfig"; function OutlookLogin() { const { instance, accounts } = useMsal(); const account = useAccount(accounts[0] || {}); // 弹窗登录 const handleLogin = () => { instance.loginPopup(loginRequest).catch(e => console.log("登录异常:", e)); }; // 登出逻辑 const handleLogout = () => { instance.logoutPopup().catch(e => console.log("登出异常:", e)); }; return ( <div> {!account ? ( <button onClick={handleLogin}>使用Outlook账号登录</button> ) : ( <div> <p>欢迎,{account.name}</p> <p>登录邮箱:{account.username}</p> <button onClick={handleLogout}>退出登录</button> </div> )} </div> ); } export default OutlookLogin;
步骤4:对接AWS服务(可选)
如果需要把Outlook身份验证和AWS服务打通,可以按如下操作:
- 登录AWS控制台,进入Cognito用户池服务
- 新建用户池,在身份提供商选项中选择「OpenID Connect」,填入Azure AD的相关元数据、客户端ID等参数
- 配置属性映射,将Azure AD返回的用户邮箱、名称等字段映射到Cognito用户属性中
- 在React代码中登录成功后,将获取到的MSAL token提交到AWS Cognito进行交换,获取AWS临时凭证,即可调用其他AWS服务
内容的提问来源于stack exchange,提问作者ARMEL FOPA
相关产品推荐
相关产品推荐

