
Auditoria de código-fonte somente leitura que inspeciona um checkout local do FreeSWITCH em busca de assinaturas de injeção de comando no comando api-proto do chat do mod_sofia referentes ao CVE-2026-116779 e reporta VULNERABLE, NOT_VULNERABLE ou INCONCLUSIVE.
Auditoria local somente leitura de código-fonte e perfis empacotados para a questão de MESSAGE SIP de entrada do FreeSWITCH CVE-2026-116779. A ferramenta avalia um checkout local do código-fonte do FreeSWITCH; ela não envia mensagens SIP, não explora um serviço nem varre uma rede.
mod_sofia<= 1.11.2)CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:HMESSAGE SIP de entrada pode escolher o protocolo de chat api. O mod_dptools registra esse protocolo para chamar switch_api_execute(), permitindo a execução de comandos de API como o processo do FreeSWITCH.O fornecedor afirma que qualquer perfil SIP que aceite MESSAGE de entrada é afetado por padrão. enable-chat=false bloqueia o tratamento de chat, mas desabilita toda a entrega de chat por MESSAGE de entrada. A autenticação por si só não é uma correção completa. O patch oficial adiciona o gate por perfil enable-chat-api-proto, desabilitado por padrão; builds corrigidos retornam 403 para um proto api selecionado, a menos que explicitamente habilitado.
O detector lê apenas estes arquivos de código-fonte no checkout fornecido:
src/mod/endpoints/mod_sofia/sofia_presence.csrc/mod/endpoints/mod_sofia/sofia.csrc/mod/endpoints/mod_sofia/mod_sofia.hEle reporta VULNERABLE apenas quando encontra o marcador de seleção de proto de entrada e o marcador de despacho de chat api sem o marcador do gate upstream. Ele reporta NOT_VULNERABLE quando o branch api de entrada contém a verificação upstream PFLAG_ENABLE_CHAT_API_PROTO. Se nenhuma das assinaturas for conclusiva, ele reporta INCONCLUSIVE. Entradas explícitas enable-chat-api-proto=true em perfis XML empacotados são exibidas para revisão; elas não negam o fato de que o código-fonte inclui o patch.
Esta verificação baseada em assinaturas é deliberadamente restrita. Ela não infere o status do patch do código-fonte a partir do estado da porta, banners ou strings de versão. Ela não consegue identificar backports downstream alterados que não mantêm os marcadores upstream. Ela avalia a árvore de código-fonte fornecida, não uma implantação compilada ou em execução. Um resultado NOT_VULNERABLE não significa que o sistema esteja de outra forma seguro.
Python 3.11 ou mais recente. O runtime usa a biblioteca padrão; pytest, ruff e mypy são ferramentas de desenvolvimento.
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
python -m pip install -e .
--target deve ser um diretório local de checkout do código-fonte do FreeSWITCH, não um host remoto ou um diretório apenas de configuração.
python -m cve_detector --target "C:\src\freeswitch"
python -m cve_detector --target /src/freeswitch --format json --output report.json
Opções: --target (obrigatório), --format text|json (padrão text), --output FILE, --verbose, --quiet, --version e --help. A ferramenta é offline e somente leitura. --timeout, novas tentativas, autenticação e verificações ativas não se aplicam e não são fornecidos.
O JSON contém cve, target, status, evidence_summary, verification_method, confidence, observations, limitations, timestamp (UTC ISO 8601) e references.
| Código de saída | Status |
|---|---|
| 0 | NOT_VULNERABLE |
| 1 | VULNERABLE |
| 2 | INCONCLUSIVE |
| 3 | ERROR |
O exemplo de saída abaixo é ilustrativo, não proveniente de um sistema FreeSWITCH real:
{
"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": []
}
Linhas de status ilustrativas para as quatro classificações:
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
Estes são exemplos de saídas possíveis, não resultados de execuções de teste.
python -m pip install pytest ruff mypy
python -m pytest
ruff check .
ruff format --check .
mypy src
Os testes usam fixtures locais temporários e não contactam alvos em produção. O CI executa estas verificações em Python 3.11 e 3.12. A auditoria de dependências é executada com pip-audit.
Os códigos de saída do processo podem condicionar um workflow. Trate o código de saída 2 como um pedido de revisão manual; não o equipare a um resultado limpo. Apenas analise árvores de código-fonte que a sua organização está autorizada a inspecionar.
api seria um mecanismo de verificação inseguro.Utilize apenas em árvores de código-fonte que está autorizado a avaliar. A ferramenta não executa código do alvo e não efetua pedidos de rede.
Inclua testes determinísticos e referências autoritativas para qualquer nova assinatura de deteção. Não adicione payloads de exploração nem verificações que executem comandos num alvo.
MIT; consulte LICENSE.