Importar descobertas de segurança de terceiros

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_line e end_line: as primeiras e últimas linhas do código vulnerável. Uma descoberta pode abranger várias linhas. Para uma única linha, é possível definir line em vez de start_line e end_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 o cm fix vai pesquisar o código vulnerável no arquivo.
  • title, message, analysis e vuln_type: uma descrição da descoberta. Cada descoberta precisa de pelo menos um desses campos.
  • severity: CRITICAL, HIGH, MEDIUM ou LOW. 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:

  1. Execute cm report para ver a lista de descobertas registradas e os valores <finding-id> gerados.
  2. Execute a verificação em uma descoberta importada para gerar um exploit de prova de conceito:
    cm verify FINDING_ID
  3. Gere e valide um patch de segurança para a descoberta:
    cm fix FINDING_ID