React基于react-aad-msal实现令牌过期/闲置自动登出的配置方法
react-aad-msal 非自动静默刷新的适配实现方案
当前应用的自动静默刷新逻辑,是MSAL封装库默认在访问令牌失效时,使用本地缓存的刷新令牌走无感知接口换token流程实现的。要达成“令牌过期、用户闲置时强制引导交互认证,而非静默刷新”的安全需求,可通过以下三步改造实现:
1. 拦截默认的静默刷新链路
- 改造原有
getAccessToken的调用前置逻辑,在调用静默获取接口前,先读取本地缓存的身份令牌过期时间戳,和当前时间做对比。 - 一旦检测到令牌已经过期,跳过
getAccessToken的静默获取分支,直接触发AuthProvider提供的loginRedirect或loginPopup方法,引导用户走可见的交互认证流程。 - 给
getAccessToken的catch分支增加错误码拦截:只要捕获到interaction_required、login_required、invalid_token这类需要用户交互的错误,直接跳转登录页,不做静默重试。
2. 实现全局用户闲置检测
- 封装全局闲置监听逻辑,绑定浏览器的
mousemove、keydown、click、scroll等用户主动交互事件,每次触发事件就重置闲置计时。 - 根据业务安全要求设置闲置时长阈值(比如30分钟无操作),当计时触发时,先调用
AuthProvider.clearCache()清空本地缓存的所有身份信息,再触发强制交互登录,避免剩余缓存的刷新令牌被用来做静默刷新。
3. 改造后的参考实现代码
// 配置闲置超时阈值,可根据业务安全要求调整 const IDLE_TIMEOUT = 30 * 60 * 1000; let idleTimerInstance = null; // 重置闲置计时的方法 const resetIdleCountdown = () => { if (idleTimerInstance) clearTimeout(idleTimerInstance); idleTimerInstance = setTimeout(() => { // 触发闲置时,清空本地所有缓存的身份凭证 AuthProvider.clearCache(); // 强制跳转交互登录 AuthProvider.loginRedirect({ scopes: [config.appScope] }); }, IDLE_TIMEOUT); }; // 初始化全局闲置监听 const setupIdleMonitor = () => { ['mousemove', 'keydown', 'click', 'scroll'].forEach(eventType => { window.addEventListener(eventType, resetIdleCountdown); }); resetIdleCountdown(); }; // 改造后的令牌获取方法 const getAccessToken = () => { const currentTime = Math.floor(Date.now() / 1000); const cachedAccount = AuthProvider.getCachedAccountInfo(); // 前置校验:缓存令牌已过期,直接触发交互登录,不做静默刷新 if (!cachedAccount?.idTokenClaims?.exp || cachedAccount.idTokenClaims.exp < currentTime) { return AuthProvider.loginRedirect({ scopes: [config.appScope] }); } // 未过期场景下正常获取令牌,增加错误兜底 return AuthProvider.getAccessToken({ scopes: [config.appScope], forceRefresh: true }).catch(err => { // 遇到需要交互认证的错误,直接跳转登录 if (['interaction_required', 'login_required', 'invalid_token'].includes(err.errorCode)) { return AuthProvider.loginRedirect({ scopes: [config.appScope] }); } throw err; }); };
落地注意事项
- 初始化AuthProvider时,关闭库自带的自动刷新配置项,避免未通过业务拦截逻辑的后台静默刷新流程。
- 闲置时长阈值不要设置得短于访问令牌本身的有效期,避免出现正常操作场景下被误判为闲置的问题。
- 强制清空本地缓存的步骤不能省略,否则MSAL会检测到剩余的有效刷新令牌,自动在后台完成无感知换token,无法达到强制交互认证的安全要求。
内容的提问来源于stack exchange,提问作者PNDev
相关产品推荐
相关产品推荐

