mcpField
B
browser-auth-flow

browser-auth-flow

github.com/ruvnet安全80.0k689 次安装今天更新
代码仓库

关于 browser-auth-flow

browser-auth-flow 是用于探测网站身份验证流程的安全技能,可记录登录轨迹并生成结构化结果供人工审查。它检查多类风险,并隔离探测中捕获的敏感数据。

主要功能

  1. 01记录登录流程轨迹
  2. 02检查 CSRF 与重定向
  3. 03检查 Cookie 与 OAuth
  4. 04按严重度整理发现并给出结论
  5. 05隔离敏感数据

适用场景

  1. 01部署前审查新的身份验证流程
  2. 02调查令牌泄露或重定向问题
  3. 03建立回归检查基线

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill browser-auth-flow

安装后在 Claude Code 中输入/browser-auth-flow确认已加载。

详细介绍

浏览器身份验证流程

对网站身份验证进行对抗性探测。驱动登录流程一次并记录轨迹,然后针对捕获的产物和实时页面运行一组可配置的探测。输出为 RVF 容器内结构化的 findings.md。

适用场景

  • 新身份验证流程的部署前审计。
  • 调查疑似令牌泄露或重定向问题。
  • 为持续回归检查建立基线。

步骤

  1. 通过 browser-record 打开一个录制会话。

  2. 按照 browser-login 驱动身份验证流程(如果本次运行是重新身份验证探测,凭据来自 --credentials <handle>,该参数引用 browser-cookies)。

  3. 运行探测:

    • csrf:检查轨迹中的登录 POST;验证其中存在同源令牌字段且该字段非空。
    • redirect:在每次导航后检查 browser_get-url,留意带有身份验证状态的跨源重定向(状态可能位于 URL 或片段中)。标记所有跨越源边界的含令牌 URL。
    • cookie:通过 browser_eval 遍历 document.cookie。对于每个 Cookie,检查 Secure、HttpOnly、SameSite、过期时间和值的熵。标记缺少标志或令牌过短的情况。将每个 Cookie 传入 aidefence_scan,以标记嵌入 Cookie 值中的 PII。
    • oauth:如果流程涉及第三方提供方,捕获授权请求,验证 state 和 nonce 存在且具有高熵,并验证 redirect_uri 与已注册的回调域名匹配。
  4. 隔离探测过程中捕获的任何令牌、凭据或 PII——它们只保留在 RVF 容器的 findings 中,不得以未脱敏形式返回给模型(如果要读回 findings,则适用 browser-extract 中的 aidefence_is_safe 门控)。

  5. 编写 findings.md,每个探测对应一个章节,每项发现都标注严重性,并给出 verdict(pass / warn / fail)。

  6. 在 browser-sessions 中为会话编制索引,并设置 tag: auth-probe,以便未来审计与之比较。

注意事项

  • 此技能用于探测,不用于利用。不要使用捕获的令牌串联后续请求。
  • 凭据必须来自保管库句柄或交互式输入。切勿将其硬编码到字段映射中。
  • 某些探测需要加载多个页面。身份验证探测的轨迹步骤数通常为 15–40;请据此预留预算。
  • 输出采用结构化格式,供人工审查。未先向用户展示发现内容前,不要根据发现自动采取行动。

评论

支持 Markdown