mcpField
P
php-open-redirect-audit

php-open-redirect-audit

github.com/0xsheSecurity40971 installsUpdated 31w ago
Repository

About php-open-redirect-audit

A security-audit skill for identifying open redirects in PHP projects. Intended for code auditors, it traces user-controlled destinations and validation logic, and requires evidence from php-route-tracer.

Key features

  1. 01Finds redirect output points such as header and redirect
  2. 02Traces destination sources and validation logic
  3. 03Checks scheme, encoding, and whitespace bypasses
  4. 04Requires route evidence, data flow, PoC, and remediation

Use cases

  1. 01Check whether next or return_to parameters control redirect targets
  2. 02Assess whether external URLs or encoded forms bypass validation
  3. 03Review post-login redirects for phishing risk

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/0xshe/php-code-audit-skill --skill php-open-redirect-audit

After installing, type/php-open-redirect-auditin Claude Code to confirm it loaded.

Details

From the project README

PHP 开放重定向审计（php-open-redirect-audit）

分析 PHP 项目源码中，所有“跳转/重定向”行为是否可能被用户控制目的地址，导致钓鱼或 OAuth 等流程被劫持。

分级与编号

  • 详见：shared/SEVERITY_RATING.md
  • 漏洞编号：{C/H/M/L}-REDIR-{序号}

必检 Sink（强制）

识别以下跳转输出点：

  • header("Location: {value}")
  • <meta http-equiv="refresh" content="{value}">
  • redirect() / to() / return redirect({value})
  • 自定义跳转函数（内部最终调用 Location 输出）

可控性追踪（必做）

必须追踪以下两类变量：

  1. 目的地来源：通常来自 $_GET['next']/$_POST['url']/Referer/return_to
  2. 目的地校验：是否只允许相对路径、是否 allowlist、是否拒绝 scheme（http://///）、是否校验域名

绕过条件（必做）

必须识别并输出潜在绕过：

  • scheme 绕过：//evil.com、http:%2f%2fevil.com
  • 编码绕过：双重编码、URL 编码的冒号/斜杠
  • 尾部/空白字符绕过（旧实现常见）

报告输出

{output_path}/vuln_audit/redir_{timestamp}.md

条目模板（强制）

每条漏洞必须包含：

  • 位置证据：跳转函数位置 + 路由
  • 数据流链：用户输入 -> 校验 -> header/redirect
  • 可利用前置条件：通常需登录（若在登录后跳转）与攻击者能否控制参数
  • 验证 PoC（必须真实路由；把目的地参数替换为真实字段名）
  • 修复建议：只允许相对路径 + 服务器端 allowlist + 对编码/scheme 做归一化后校验

证据引用（强制：来自 php-route-tracer）

每条开放重定向疑似漏洞必须逐项引用 trace 输出中 ## 9) Sink Evidence Type Checklist 的 REDIR 行对应证据要点（允许状态为待验证，但证据引用必须存在）：

  1. EVID_REDIR_OUTPUT_POINT：跳转输出点位置证据（header/redirect 的最终输出位置）
  2. EVID_REDIR_DEST_SOURCE_MAPPING：目的地来源变量映射证据（从路由参数到目的地变量）
  3. EVID_REDIR_DEST_VALIDATION_NORMALIZATION：目的地校验/归一化/allowlist/refuse scheme 的分支证据（含编码绕过处理分支）

tracer 证据缺失处理（强制）

  • 若无法定位上述 1~3 任一关键证据要点：该漏洞状态只能标记为 ⚠️待验证，不得直接给出 ✅已确认可利用。

Comments

Markdown supported