You need to enable JavaScript to run this app. 基于Azure AD的Express REST API认证授权实现方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

基于Azure AD的Express REST API认证授权实现方案咨询

核心可行性结论

完全不需要依赖Auth0这类第三方身份中转平台就能实现目标。Azure AD本身就是完整的OAuth2/OIDC协议身份提供方,只需要基于Azure官方提供的原生SDK开发即可,这类第三方身份平台只是可选优化项,不是搭建体系的必需环节。

对认证流程位置的认知纠正

你之前认为认证流程主要在前端实现的判断存在明显偏差:

  • 前端侧只负责和用户交互、获取合法令牌的动作,不承担任何安全校验职责
  • 令牌合法性校验、接口授权判断这类核心安全逻辑,必须部署在你的Express API服务内部,作为所有受保护接口的强制前置中间件
  • 服务端场景的调用(ASP.NET、RPA)根本没有前端参与的流程,完全是服务和Azure AD、服务和Express API之间的令牌交互
整体架构设计思路

整体架构完全围绕Azure AD作为唯一身份源搭建,不需要额外的身份层:

  1. 提前在Azure AD租户内注册两类应用对象:
    • 第一类是你的Express REST API本身:定义自己的应用ID、暴露的权限范围(Scope),作为令牌的唯一合法接收方
    • 第二类是所有调用方:包括你的React/Angular前端应用、ASP.NET后端服务、RPA程序,分别给每个调用方配置对应的调用权限
  2. 针对两类不同的调用来源,适配对应的OAuth2流程:
    • 面向前端SPA的场景:走授权码流+PKCE模式,整个流程由前端SDK驱动,最终拿到代表终端用户身份的访问令牌
    • 面向无用户参与的后端服务场景:走客户端凭据流模式,由后端服务用提前配置好的证书/客户端密钥,直接向Azure AD申请代表服务自身身份的访问令牌
  3. Express API作为统一的受保护资源,对所有收到的请求做统一校验:不管令牌是来自前端用户还是后端服务,都走同一套校验逻辑,识别出调用方是哪个用户、哪个应用,再匹配对应的授权规则允许或拒绝访问。
各模块的逻辑部署位置
  • Express API侧(核心安全层,所有逻辑必须无遗漏部署在这里)
    • 令牌校验逻辑:基于Azure官方维护的passport-azure-ad中间件,自动完成令牌签名校验、签发方合法性校验、受众匹配校验,不需要自己从零写解析逻辑
    • 身份提取逻辑:校验通过后,从令牌载荷中提取调用者的唯一标识(用户UPN、用户所属组、应用客户端ID),注入到请求上下文供业务层使用
    • 授权判断逻辑:基于提取到的身份信息,判断当前调用者是否有权限访问目标接口,比如规则可以是“属于某AD组的内部员工可以访问查询接口”、“RPA应用的客户端ID可以访问定时任务触发接口”
  • 前端SPA(React/Angular)侧的逻辑定位
    • 用官方@azure/msal-browser SDK实现跳转登录、静默刷新令牌的交互逻辑,不要自己实现OAuth流程
    • 拿到令牌后只负责在调用API时把令牌放到请求的Authorization头里,不要把权限判断作为安全边界——前端的权限控制仅用于优化页面体验,所有判断必须在服务端二次校验
  • 后端调用方(ASP.NET/RPA)侧的逻辑定位
    • 用对应语言的Azure AD SDK,基于提前存放在安全配置里的客户端证书/密钥,向Azure AD的令牌端点申请应用身份的访问令牌
    • 同样在调用Express API时把令牌放到请求头里,不需要任何用户交互流程
核心实现示例
  • Express API侧的中间件配置示例(无第三方身份依赖,使用官方SDK):
const express = require('express');
const passport = require('passport');
const OIDCStrategy = require('passport-azure-ad').OIDCStrategy;

const app = express();

// 配置Azure AD令牌校验规则
passport.use(new OIDCStrategy({
    // 配置租户的OIDC元数据地址
    identityMetadata: `https://login.microsoftonline.com/你的租户ID/v2.0/.well-known/openid-configuration`,
    // 配置当前Express API在Azure AD注册的应用ID
    clientID: `你的Express API应用ID`,
    audience: `你的Express API应用ID`,
    validateIssuer: true,
    loggingLevel: 'warn'
}, (tokenIssuer, subject, userProfile, accessToken, refreshToken, done) => {
    // 校验通过后将用户/应用身份绑定到请求对象
    return done(null, userProfile);
}));

// 给所有受保护接口挂载强制校验中间件
app.use('/api/secure/*',
    passport.authenticate('oauth-bearer', { session: false }),
    (req, res, next) => {
        // 从这里开始可以拿到已校验的合法调用身份
        const caller = req.user;
        // 示例授权判断:比如只有某AD组的用户能访问
        if (!caller._json.groups.includes('允许访问的组ID')) {
            return res.status(403).send('无权限');
        }
        next();
    }
);
  • 前端SPA调用的核心逻辑示例:
// 用MSAL SDK静默获取对应权限范围的访问令牌
const tokenRequest = {
    scopes: [ `api://你的Express API应用ID/默认访问范围` ]
};
const tokenResponse = await msalInstance.acquireTokenSilent(tokenRequest);

// 调用API时附带令牌
fetch('/api/secure/data', {
    headers: {
        Authorization: `Bearer ${tokenResponse.accessToken}`
    }
});
  • 后端服务调用的核心逻辑:不管是ASP.NET还是RPA程序,只需要用对应SDK拿到客户端凭据流的访问令牌,按照同样的格式把令牌放到请求头即可,全程无用户交互。
落地注意事项
  • 不要手写JWT令牌的签名校验逻辑,全部用官方维护的SDK完成校验,避免出现签名绕过的安全漏洞
  • 不要把客户端密钥、服务端应用的敏感配置放到前端代码里,所有需要密钥的令牌交换流程必须在服务端完成
  • 在Azure AD应用注册环节,明确区分用户权限范围和应用权限范围,让API可以清晰识别当前调用是来自终端用户,还是来自后端服务

内容的提问来源于stack exchange,提问作者Krishnan Sriram

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 16:15:05