Use $codex-security:vulnerability-writeup para criar um relatório independente para cada vulnerabilidade distinta. Você pode partir dos resultados de uma varredura do Codex Security ou usar diretamente os achados, as notas de divulgação, as provas de conceito (PoCs) e o código-fonte fornecidos. A varredura do Codex Security é opcional.
Prepare as evidências
Forneça os seguintes materiais para o fluxo de trabalho:
- Achados, notas de divulgação ou documentos de avaliação para análise.
- A árvore de código-fonte a ser analisada e a revisão ou versão afetada.
- PoCs, logs, rastros de execução, capturas de tela ou saídas de diagnóstico já disponíveis.
- Commits ou diffs de correção, quando disponíveis.
Antes de escrever o relatório, o Codex verifica cada afirmação com base no código-fonte afetado. Se o código-fonte ou a revisão afetada estiver indisponível, decida se deseja prosseguir com um relatório que indique quais afirmações ficaram sem verificação.
Execute o fluxo de trabalho
Envie um prompt como este:
Use $codex-security:vulnerability-writeup para criar um relatório independente para cada vulnerabilidade distinta descrita em [input paths]. Verifique cada afirmação no código-fonte usando o caminho e a revisão indicados em [source path and revision]. Preserve ou aprimore as PoCs fornecidas e salve os relatórios em [output directory]. Para reproduzir as falhas, use um ambiente de teste local.O Codex cataloga o material fornecido, agrupa os relatórios que descrevem a mesma causa raiz e o mesmo caminho vulnerável e cria um diretório de relatório para cada vulnerabilidade distinta. Cada diretório contém um relatório em Markdown e, quando há arquivos de apoio à PoC, um diretório poc/.
Revise cada relatório
Antes de distribuir um relatório, confirme se ele:
- Descreve como a falha se manifesta a partir do ponto de entrada controlado pelo atacante, qual invariante de segurança é violado e qual é o impacto.
- Distingue o comportamento verificado das hipóteses e das limitações ainda não resolvidas.
- Inclui trechos do código-fonte e identifica os caminhos dos arquivos, as funções e a revisão afetada.
- Inclui o código-fonte da PoC, instruções de compilação ou execução, exemplos representativos da saída e limitações de segurança quando é viável usar uma PoC.
- Usa caminhos portáveis e não depende de armazenamento interno nem de caminhos absolutos locais.
Use os relatórios de uma varredura
Os relatórios detalhados de vulnerabilidades são opcionais nas varreduras padrão, nas varreduras aprofundadas e nas varreduras de alterações. Quando você solicita esses relatórios, o Codex grava cada um em findings/<slug>/<slug>.md, armazena os arquivos de apoio em findings/<slug>/poc/ e inclui um link para o relatório em report.md.
Ao compartilhar ou arquivar uma varredura, mantenha todo o conteúdo do diretório da varredura junto. Para identificar melhorias que abordem padrões recorrentes nos relatórios, consulte Proponha medidas para reforçar a segurança.