# 每实例自动续期(0.6.2) 普通客户端通过刷新凭证或已有登录会话获取新访问令牌,通常无需每次输入密码或 MFA。本工具现在为网页 API 服务提供同样的两阶段恢复思路,实际能否静默完成仍以微软和公司登录策略为准。[微软令牌获取说明](https://learn.microsoft.com/en-us/entra/identity-platform/scenario-spa-acquire-token) ## 使用 0.6.2 修复过期 MSAL 缓存被误判为恢复完成的问题:匹配刷新材料时还必须有同账号、同资源、权限匹配且剩余有效期超过 30 秒的访问令牌。缓存里的过期条目不能提前触发验证并关闭浏览器;页面跳转时缓存执行环境暂时消失,也不会立即终止恢复,而是在本次限时内继续尝试。静默恢复的截止时间按实际 90 秒显示。 控制台区分「正在自动续期」「续期等待重试」「后台运行中」;已完成或取消的静默登录不会持续显示为进行中。等待重试显示下次尝试时间。明确需要交互时显示重新登录,停止的实例不会继续显示续期进行中。 1. 升级后选择实例,完成一次「从工具登录 → 完成登录并关闭窗口」。旧版本曾清理临时浏览器资料,单靠旧业务 HAR 无法生成缺失的刷新凭证。 2. 页面已捕获消息即可尝试完成登录;需要日历时确认日历接口也已捕获。其他实例分别建立自己的登录状态。 3. 后台采集默认自动续期。控制台显示「自动续期」、当前最早到期时间和最近续期成功时间;发生网络错误显示下次重试,需要人工继续验证时才显示交互提示。 4. 停止某实例会中止它的续期请求及恢复浏览器;其他实例继续运行。再次启动会重新检查该实例保存的会话。 ## 流程 每轮采集前检查已捕获访问令牌的时间,在到期前 5 分钟尝试更新;接口提前返回认证错误时也会尝试更新。优先通过 Node 进程提交 refresh_token。登录时同时读取本实例官方页面的 MSAL 缓存,匹配用户、租户、客户端、环境与 home account,解决页面全部命中缓存、没有发起 token 请求的情况。仅处理已保存接口证明授权的资源;使用实际捕获的请求,或微软文档规定的租户 token 端点与这些资源的 `.default`,不会自动同意新增权限。[微软刷新协议](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow#refresh-the-access-token)、[已授权资源的 .default](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc#the-default-scope) 已适配当前 Teams 资源标识带/不带根路径末尾斜杠的情况;MSAL 缓存可能把展开权限与 `.default` 放在一起,这种缓存目标不能原样用作刷新 scope,工具会按已证明授权的资源请求 `.default`,避免 AADSTS70011。后续只打开聊天的登录会保留先前日历模板,并分别验证,避免覆盖整个会话时丢失日历采集。 刷新返回的新令牌必须匹配原租户、用户、客户端与资源,并包含原请求已有的权限。先持久化刷新令牌轮换结果,再替换该实例 HAR 中对应凭证,重建实时、历史及在线状态采集器。SQLite 中已提交的消息、历史页和增量游标继续使用,不重置为全量补采。在线维持关闭时,不会为了闲置的状态凭证启动恢复。 如果没有可用刷新凭证、刷新授权到期或服务要求恢复登录,则短时启动此实例独立的无窗口浏览器,加载 Teams,必要时打开日历入口,让官方页面使用保留的登录状态恢复。读取已验证身份的 MSAL 缓存与新请求凭证,完成后关闭浏览器;不会清除登录 Cookie 或刷新令牌,也不会自动点击密码、MFA 或同意授权提示。浏览器常规恢复限时 90 秒;出现可见交互提示时才标记需要人工验证,单纯重定向到登录域名不视为 MFA 要求,页面加载/网络暂时失败采用退避重试。 直接刷新不启动浏览器;会话恢复路径会短时启动浏览器进程,因此这一路线不是“任何时候都绝无浏览器进程”。公司策略、浏览器登录状态和网页接口变化仍可能使静默恢复失败。 ## 隔离与存储 - 默认实例:`data/network-renewal.json` 和 `data/network-profile/login-<随机 ID>/`。 - 其他实例:各自 `data/instances/<实例 ID>/` 下的同名文件和目录。 - Windows 凭证库使用 DPAPI CurrentUser 加密;只有当前 Windows 用户可解密。浏览器资料由独立 Edge/Chrome profile 保存,沿用浏览器自身的凭证保护。非 Windows 凭证文件使用当前用户文件权限(0600),不宣称具有 DPAPI 加密。 - 续期材料不进入业务 HAR、SQLite 记录、版本、日志、WebHook 或 MCP。业务 HAR 仍保留采集所需访问凭证。MCP `list_instances` 仅投影续期状态及时间。 - 临时错误遵循 Retry-After 并采用退避,操作可取消,同一实例续期合并为单次请求;不同实例的凭证库和浏览器资料隔离。 - 删除账号的“本地记录”沿用原范围,停止该实例但保留登录材料、实例绑定和原始抓包;它不是退出 Microsoft 登录操作。 当前只在 `npm start` 启动的本地服务调度续期;独立 `capture:sync` / `capture:history` 命令维持原来的静态 HAR 行为。加密或无法确认身份的访问令牌不会被直接刷新替换,需要浏览器恢复或后续适配。网页登录刷新凭证自身也可能有较短寿命,不能承诺永久免交互。[微软刷新令牌说明](https://learn.microsoft.com/en-us/entra/identity-platform/refresh-tokens)