针对 FreeSWITCH 入站 SIP MESSAGE 问题 CVE-2026-116779 的只读本地源码与内置配置审计。该工具评估本地 FreeSWITCH 源码检出;它不发送 SIP 消息、不利用服务,也不扫描网络。
mod_sofia<= 1.11.2)CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:HMESSAGE 的 To-user 选择器可选择 api 聊天协议。mod_dptools 注册该协议以调用 switch_api_execute(),从而允许以 FreeSWITCH 进程身份执行 API 命令。厂商表示,任何接受入站 MESSAGE 的 SIP 配置文件默认均受影响。enable-chat=false 会阻止聊天处理,但会禁用所有入站 MESSAGE 聊天投递。仅靠身份验证并非完整修复。官方补丁新增了按配置文件生效的 enable-chat-api-proto 开关,默认禁用;修复后的构建在未显式启用时,对选定的 api 协议返回 403。
检测器仅读取所提供检出目录下的以下源文件:
src/mod/endpoints/mod_sofia/sofia_presence.csrc/mod/endpoints/mod_sofia/sofia.csrc/mod/endpoints/mod_sofia/mod_sofia.h仅当发现入站协议选择标记和 api 聊天分发标记,且未发现上游开关标记时,才报告 VULNERABLE。当入站 api 分支包含上游 PFLAG_ENABLE_CHAT_API_PROTO 检查时,报告 NOT_VULNERABLE。若两个特征均无法得出结论,则报告 INCONCLUSIVE。内置 XML 配置中显式的 enable-chat-api-proto=true 条目会被列出以供审查;它们并不否定源码已包含补丁这一事实。
这种基于特征的检查刻意保持狭窄范围。它不会根据端口状态、横幅或版本字符串推断源码补丁状态。它无法识别未保留上游标记的、经过修改的下游回移补丁。它评估的是所提供的源码树,而非已编译或正在运行的部署。结果为 NOT_VULNERABLE 并不意味着系统在其他方面是安全的。
Python 3.11 或更高版本。运行时使用标准库;pytest、ruff 和 mypy 为开发工具。
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
python -m pip install -e .
--target 必须是本地 FreeSWITCH 源代码检出目录,而不是远程主机或仅包含配置的目录。
python -m cve_detector --target "C:\src\freeswitch"
python -m cve_detector --target /src/freeswitch --format json --output report.json
选项:--target(必填)、--format text|json(默认 text)、--output FILE、--verbose、--quiet、--version 和 --help。该工具为离线且只读。--timeout、重试、身份验证和主动检查均不适用,因此不提供。
JSON 包含 cve、target、status、evidence_summary、verification_method、confidence、observations、limitations、timestamp(UTC ISO 8601)和 references。
| 退出码 | 状态 |
|---|---|
| 0 | NOT_VULNERABLE |
| 1 | VULNERABLE |
| 2 | INCONCLUSIVE |
| 3 | ERROR |
以下示例输出仅作说明,并非来自实际的 FreeSWITCH 系统:
{
"cve": "CVE-2026-116779",
"target": "C:/src/freeswitch",
"status": "INCONCLUSIVE",
"evidence_summary": "The source files were found, but their implementation does not match a reliable vulnerable or fixed signature.",
"verification_method": "Read-only inspection of FreeSWITCH mod_sofia source and bundled XML profiles",
"confidence": "Low; source evidence is incomplete or modified.",
"observations": [],
"limitations": [],
"timestamp": "2026-11-15T00:00:00+00:00",
"references": []
}
四种分类的示例状态行:
CVE-2026-116779: VULNERABLE # unguarded selector plus bundled mod_dptools source
CVE-2026-116779: NOT_VULNERABLE # upstream per-profile gate found
CVE-2026-116779: INCONCLUSIVE # signature incomplete or target layout unsupported
CVE-2026-116779: ERROR # invalid target or local file access failed
这些是可能输出的示例,并非测试运行结果。
python -m pip install pytest ruff mypy
python -m pytest
ruff check .
ruff format --check .
mypy src
测试使用临时本地夹具,不会接触实时目标。CI 在 Python 3.11 和 3.12 上运行这些检查。依赖审计通过 pip-audit 运行。
进程退出码可用于控制工作流。将退出码 2 视为请求人工审查;不要将其等同于干净的结果。仅扫描你的组织有权检查的源代码树。
api 协议的 SIP 消息将是一种不安全的验证机制。仅在你获授权评估的源代码树上使用。该工具不执行目标代码,也不发起网络请求。
对于任何新的检测签名,请包含确定性测试和权威参考资料。不要添加漏洞利用载荷或在目标上执行命令的检查。
MIT;参见 LICENSE。