Se você já usa ferramentas de análise estática ou verificação de vulnerabilidades de terceiros, pode importar as descobertas diretamente para o CodeMender e prosseguir imediatamente para a verificação e a aplicação de patches.
Relatórios de segurança de importação
O CodeMender analisa relatórios de segurança externos e registra as descobertas no banco de dados local.
Importar um arquivo JSON de descobertas
Para importar descobertas de um arquivo JSON, use a flag --file (ou -f). O arquivo JSON contém uma matriz de descobertas, como esta:
[
{
"file_path": "src/auth/session_manager.py",
"start_line": 42,
"end_line": 47,
"snippet": "cursor.execute(\"SELECT * FROM users WHERE id = \" + user_id)",
"title": "SQL Injection",
"message": "Raw user input concatenated in SQL query",
"severity": "HIGH",
"vuln_type": "CWE-89"
}
]
Cada descoberta tem os seguintes campos:
file_path(obrigatório): o caminho para o arquivo afetado.start_lineeend_line: as primeiras e últimas linhas do código vulnerável. Uma descoberta pode abranger várias linhas. Para uma única linha, é possível definirlineem vez destart_lineeend_line.snippet: o código vulnerável. Se uma descoberta não tiver um intervalo de linhas nem um snippet, ela vai abranger todo o arquivo, e ocm fixvai pesquisar o código vulnerável no arquivo.title,message,analysisevuln_type: uma descrição da descoberta. Cada descoberta precisa de pelo menos um desses campos.severity:CRITICAL,HIGH,MEDIUMouLOW. O padrão éMEDIUM.
Também é possível importar um relatório SARIF 2.1.0 ou um arquivo CSV. Um arquivo CSV precisa de uma
linha de cabeçalho que inclua file_path e pelo menos um dos outros campos, como
um arquivo exportado com cm report --format csv. Para saber quais formatos
sua versão da CLI aceita, execute cm report import --help.
Execute o comando de importação:
cm report import --file ./findings.json
Modo de importação interativo
Se você não tiver um arquivo JSON, execute o comando de importação sem a flag --file para inserir um assistente interativo no terminal:
cm report import
Siga as instruções para inserir o caminho, o número da linha, a gravidade e a descrição de cada descoberta. Digite q em qualquer comando para concluir e salvar.
Processar descobertas importadas
Depois de importar as descobertas externas:
- Execute
cm reportpara ver a lista de descobertas registradas e os valores<finding-id>gerados. - Execute a verificação em uma descoberta importada para gerar um exploit de prova de conceito:
cm verify FINDING_ID
- Gere e valide um patch de segurança para a descoberta:
cm fix FINDING_ID