Após a chegada de um relatório de vulnerabilidade: confirmar, avaliar, corrigir em privado e divulgar

Objetivo

Transformar um relatório privado em uma versão corrigida e em um aviso público, sem que os detalhes vazem antes de os usuários poderem atualizar e sem que quem reportou perca a paciência e publique primeiro.

Pré-requisitos

Um canal de reporte já publicado (security.txt ou um arquivo SECURITY, com link); um lugar privado para desenvolver a correção (um fork privado temporário ou um rascunho privado de aviso); a lista das pessoas que podem publicar uma versão; e, idealmente, o contato de uma CVE Numbering Authority (CNA) identificado com antecedência, como recomenda o guia da OpenSSF. O guia da OpenSSF afirma que, em um projeto pequeno, de um a cinco mantenedores, os próprios mantenedores podem ser a equipe de gestão de vulnerabilidades.

Passos

1. Confirme o recebimento antes de avaliar qualquer coisa. O guia da OpenSSF diz para fazer isso rapidamente, em um a dois dias; as orientações do GitHub dizem o mesmo e acrescentam que essa resposta define o tom do restante da conversa.
2. Avalie com base nos passos e nas versões informados por quem reportou. A classificação do guia: comportamento esperado, bug comum, pedido de funcionalidade ou vulnerabilidade, sendo vulnerabilidade o que compromete a confidencialidade, a integridade ou a disponibilidade. Informe a quem reportou o resultado e o motivo; uma sugestão de hardening não é uma vulnerabilidade e pode ir para uma issue normal.
3. Combine um período de embargo. O guia observa que quem reporta costuma indicar um prazo, que 90 dias é o prazo padrão mais longo admitido pelos grupos que ele lista, e que a comunicação contínua é o que mantém essas pessoas dispostas a estendê-lo.
4. Desenvolva e teste a correção em privado; identifique todas as versões afetadas e quais linhas com suporte receberão a correção. Mantenha o patch mínimo para facilitar a atualização; não inclua mudanças de API.
5. Reserve um identificador CVE por meio da CNA e redija a descrição. Pergunte a quem reportou se e como deseja receber crédito; o guia considera inadequado omitir o crédito, a menos que a pessoa o recuse.
6. Escolha um dia de lançamento em que as pessoas possam atualizar durante o expediente; o guia sugere de segunda a quarta-feira e evitar feriados amplamente observados.
7. Lance a versão e depois publique o aviso: versões afetadas, versões corrigidas, solução alternativa, se houver, e crédito. As orientações do GitHub enfatizam marcar a versão explicitamente como correção de segurança, para que os consumidores downstream a percebam.
8. Registre a linha do tempo (reporte, confirmação, correção, divulgação) para a próxima revisão do processo.

Resultado esperado

Quem reporta recebe respostas datadas em cada etapa; os usuários tomam conhecimento do problema pelo aviso do próprio projeto e por uma versão corrigida, ao mesmo tempo.

Limites e base de verificação

Os passos e os prazos vêm dos guias citados; nenhum incidente é descrito e nenhum tempo foi medido. Projetos com distribuidores podem precisar de uma lista de embargo, que o guia da OpenSSF trata como opcional e custosa.

Publicar o aviso junto com a versão

Depois que a correção é enviada a uma branch pública, o diff revela a vulnerabilidade a qualquer pessoa que leia os commits e, no caso de uma biblioteca, é o aviso publicado que dispara os alertas dos scanners de dependências nos projetos downstream. Redija o aviso por completo durante a fase privada da correção: versões afetadas, versões corrigidas, solução alternativa e crédito, conforme combinado com quem reportou. Depois publique a versão e o aviso como uma única etapa, com no máximo alguns minutos de diferença, de preferência a partir de um único script que cria a tag, envia o pacote e publica o aviso. A única restrição de ordem é que o aviso não pode citar uma versão corrigida antes de ela poder ser instalada.