Mais 138% CVE comunicadas por dia em 2026 do que no ano passado.Novidade: Fixboxes sempre ativas. Dependências vulneráveis, corrigidas e verificadas.

PSIRT

Aviso de segurança: como redigir um, com modelo e exemplo prático

Um aviso de segurança é o documento com base no qual os seus clientes agem quando uma vulnerabilidade afeta o seu produto. Um bom aviso responde, sem um pedido de suporte, se são afetados, com que gravidade e o que fazer. Este guia aborda os campos, um exemplo completo, os formatos legíveis por máquina, os GitHub Security Advisories e quando publicar.

Atualizado a

O que é um aviso de segurança?

Um aviso de segurança (security advisory) é uma notificação do fornecedor de um produto que descreve uma vulnerabilidade nele: que produtos e versões são afetados, qual a sua gravidade, o que um atacante poderia fazer e como os utilizadores a corrigem ou mitigam. É escrito para as pessoas que operam o produto e, cada vez mais, também para as suas ferramentas.

Os avisos de segurança são a face pública da divulgação coordenada de vulnerabilidades: quem descobre reporta em privado, o fornecedor corrige e o aviso é a forma como todos os outros ficam a saber. Na maioria das empresas de software e de dispositivos é a PSIRT que os redige, como parte de um programa mais amplo de segurança de produto.

Aviso de segurança vs boletim de segurança, registo CVE, VEX e notas de versão

Estes documentos sobrepõem-se e as equipas confundem-nos muitas vezes:

Documento Quem o publica O que abrange Leitor principal
Aviso de segurança O fornecedor do produto, ou um coordenador Uma vulnerabilidade, ou algumas relacionadas, nos seus produtos: versões afetadas, gravidade, correção Os operadores e as equipas de segurança dos clientes
Boletim de segurança O fornecedor, muitas vezes com uma periodicidade fixa Uma compilação de muitas correções numa versão ou num período. Os boletins de segurança do Android, por exemplo, saem na primeira segunda-feira de cada mês. Equipas que aplicam patches por ciclos
Registo CVE Uma CVE Numbering Authority (CNA) O identificador global e uma descrição mínima de uma vulnerabilidade: produto afetado, tipo de problema, descrição e pelo menos uma referência pública Bases de dados de vulnerabilidades e scanners
Declaração VEX O fornecedor Um estado legível por máquina por produto e vulnerabilidade: afetado, não afetado, corrigido, em investigação Os scanners dos clientes
Notas de versão O fornecedor Tudo o que mudou numa versão, incluindo correções de segurança entre outras alterações Qualquer pessoa que atualize

O padrão habitual: um aviso por vulnerabilidade, com um ID CVE que o liga ao registo CVE, com ligação a partir das notas de versão de cada versão corrigida e a partir do boletim, se publicar um. "Boletim de segurança" e "aviso de segurança" são por vezes usados como sinónimos; o que importa é que cada vulnerabilidade tenha uma página estável que os clientes possam citar.

O que um aviso de segurança deve incluir

Os campos abaixo são o que os clientes procuram, e correspondem um a um aos formatos legíveis por máquina descritos mais adiante neste guia. As regras para CNA do programa CVE definem o mínimo para o registo CVE: pelo menos um produto e versão afetados, o tipo ou a causa da vulnerabilidade (de preferência como CWE), uma descrição em texto e uma referência pública. Um aviso útil vai mais longe.

Campo O que diz Erro comum
ID do aviso O seu próprio identificador estável, como EXC-2026-007, mais o ID CVE Usar apenas o ID CVE, que pode ainda não ter no dia em que precisa de publicar
Título Produto, tipo de vulnerabilidade e impacto numa linha "Atualização de segurança para o Produto X", que não diz nada
Produtos e versões afetados Todos os produtos e versões afetados, como intervalos por ramo de versões "Versões anteriores à 4.2.2", que inclui erradamente ramos que nunca tiveram o bug
Não afetados Produtos e versões que verificou e concluiu não serem afetados Omiti-lo, de modo que todos os clientes com uma versão mais antiga abrem um pedido de suporte
Versões corrigidas A primeira versão corrigida em cada ramo suportado Indicar apenas a versão mais recente
Gravidade Uma classificação e o vetor CVSS completo, com a versão do CVSS Uma pontuação isolada sem vetor, que ninguém consegue verificar nem ajustar ao seu ambiente
Fraqueza O ID e o nome da CWE Omiti-la; as bases de dados e as regras CVE contam com ela
Descrição O que é a falha e onde está, com pormenor suficiente para avaliar a exposição, sem um exploit funcional Tão vaga que os clientes não conseguem saber se a sua configuração está exposta
Impacto O que um atacante ganha e do que precisa primeiro (acesso, função, posição na rede) Repetir as métricas CVSS por palavras em vez de explicar as consequências
Soluções alternativas e mitigações O que fazer se não puder atualizar hoje e como verificar se foi explorado "Sem soluções alternativas" quando uma alteração de configuração bloquearia o ataque
Créditos Quem a encontrou e reportou, com o seu consentimento Dar crédito a alguém que pediu para permanecer anónimo
Cronologia Reportada, confirmada, corrigida, publicada Omiti-la, o que faz parecer que atrasos longos estão a ser escondidos
Referências Registo CVE, notas de versão, commit da correção, versões legíveis por máquina Ligações para tickets internos que os clientes não conseguem abrir
Histórico de revisões Todas as alterações após a primeira publicação, com data e versão Editar as versões afetadas sem o dizer

O campo mais difícil é o das versões afetadas. O código vulnerável foi introduzido num momento e corrigido noutro, e cada ramo suportado tem a sua própria correção. Se a vulnerabilidade entrou através de um componente de terceiros, a pergunta passa a ser quais das suas versões distribuíram a versão vulnerável desse componente, diretamente ou como dependência transitiva. Consulte como avaliar uma nova CVE em todos os seus builds.

Um exemplo prático

Eis um aviso completo para um produto fictício: Example Gateway, um gateway de API auto-alojado da Example Corp, com dois ramos suportados, 3.9 e 4.x. O endpoint vulnerável foi adicionado na 3.9.0, pelo que a 3.8 e anteriores não são afetadas. Todos os nomes, IDs e datas são inventados; a pontuação CVSS 4.0 é calculada a partir do vetor apresentado.

Example Corp Security Advisory EXC-2026-007
Path traversal in Example Gateway export API allows reading server files

Advisory ID:    EXC-2026-007
CVE ID:         CVE-2026-XXXXX
Published:      2026-09-01
Last updated:   2026-09-15 (version 1.1)
Severity:       High, CVSS 4.0 base score 7.1
CVSS vector:    CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N
Weakness:       CWE-22, Improper Limitation of a Pathname to a
                Restricted Directory ('Path Traversal')

Affected products
  Example Gateway 4.x    4.0.0 up to and including 4.2.1
  Example Gateway 3.9    3.9.0 up to and including 3.9.6

Fixed versions
  Example Gateway 4.2.2
  Example Gateway 3.9.7

Not affected
  Example Gateway 3.8 and earlier (the export API was added in 3.9.0)
  Example Gateway Cloud (patched on 2026-08-28; no action needed)

Description
  The export endpoint of the admin API (/api/v1/export) does not
  normalize the file name parameter. A request containing "../"
  sequences can read any file the gateway process can read.

Impact
  An authenticated user with any role, including the read-only
  "viewer" role, can read files on the gateway host. These include
  gateway.yaml, which holds the database password and the signing key
  for admin sessions. With that key an attacker can forge an admin
  session. Unauthenticated users cannot exploit this vulnerability.

Workarounds
  If you cannot upgrade right away:
  1. Remove the viewer role from accounts that do not need it.
  2. Block requests to /api/v1/export at your reverse proxy.
  After upgrading, rotate the database password and the session
  signing key if untrusted users held any admin API role.

Detection
  Requests to /api/v1/export with "..", "%2e%2e" or "%2f" in the
  file parameter appear in the gateway access log.

Credits
  Example Corp thanks A. Researcher of Example Security Lab for
  reporting this vulnerability through coordinated disclosure.

Timeline
  2026-08-04  Reported to [email protected]
  2026-08-05  Report acknowledged
  2026-08-08  Vulnerability confirmed, CVE ID requested
  2026-08-28  Example Gateway Cloud patched
  2026-09-01  4.2.2 and 3.9.7 released, advisory published
  2026-09-15  Advisory updated (version 1.1)

References
  CVE record:            https://www.cve.org/CVERecord?id=CVE-2026-XXXXX
  Release notes 4.2.2:   https://example.com/gateway/releases/4.2.2
  Release notes 3.9.7:   https://example.com/gateway/releases/3.9.7
  CSAF version:          https://example.com/security/csaf/2026/exc-2026-007.json

Revision history
  1.0  2026-09-01  Initial publication
  1.1  2026-09-15  Added 3.8 and earlier as not affected; added the
                   reverse proxy workaround

Três coisas fazem este aviso funcionar:

  • Intervalos por ramo. "4.0.0 a 4.2.1" e "3.9.0 a 3.9.6" são exatos. "Antes da 4.2.2" teria dito a todos os clientes da 3.8 que eram afetados.
  • O impacto indica a pré-condição. Um cliente sem contas viewer sabe que a sua exposição real é baixa; um com centenas de prestadores de serviços na função viewer sabe que não é.
  • A solução alternativa inclui o seguimento. A atualização fecha a falha, mas não anula um segredo divulgado, por isso o aviso diz o que rodar.

Um modelo de aviso de segurança que pode copiar

Substitua as partes entre parênteses retos. Elimine uma secção apenas se realmente não se aplicar, e diga-o em vez de a deixar em branco onde os clientes a esperam (por exemplo "No workarounds are available").

[Company] Security Advisory [ADVISORY-ID]
[Vulnerability type] in [product] [component] allows [impact]

Advisory ID:    [ADVISORY-ID]
CVE ID:         [CVE-YYYY-NNNNN, or "requested"]
Published:      [YYYY-MM-DD]
Last updated:   [YYYY-MM-DD] (version [1.0])
Severity:       [Critical/High/Medium/Low], CVSS [4.0] base score [N.N]
CVSS vector:    [CVSS:4.0/AV:_/AC:_/AT:_/PR:_/UI:_/VC:_/VI:_/VA:_/SC:_/SI:_/SA:_]
Weakness:       [CWE-NNN, CWE name]

Affected products
  [Product] [branch]    [first affected] up to and including [last affected]
  [Product] [branch]    [first affected] up to and including [last affected]

Fixed versions
  [Product] [fixed version]
  [Product] [fixed version]

Not affected
  [Products and versions checked and not affected, and why]

Description
  [What the flaw is and where it is. Enough detail to judge exposure;
  no exploit code.]

Impact
  [What an attacker can do, and what they need first: network access,
  an account, a role, user interaction, a non-default setting.]

Workarounds
  [Steps to reduce risk until users can upgrade, or "No workarounds
  are available." Also anything to do after upgrading, such as
  rotating secrets.]

Detection
  [How users can tell whether they were attacked, if known.]

Credits
  [Name and affiliation of the reporter, with their consent.]

Timeline
  [YYYY-MM-DD]  Reported
  [YYYY-MM-DD]  Confirmed
  [YYYY-MM-DD]  Fixed versions released, advisory published

References
  CVE record:          [URL]
  Release notes:       [URL]
  Machine-readable:    [CSAF, OSV or VEX URL]
  Disclosure policy:   [URL]

Revision history
  1.0  [YYYY-MM-DD]  Initial publication

Avisos legíveis por pessoas vs legíveis por máquina

Uma página web basta para as pessoas. Não basta para um cliente com milhares de dispositivos ou centenas de serviços, cujas ferramentas precisam de comparar o seu aviso com o que têm em execução. Três famílias de formatos fazem isso, e respondem a necessidades diferentes:

Formato O que é Use-o quando
Página web (e PDF) O aviso tal como as pessoas o leem Sempre. Todos os outros formatos remetem para ela.
CSAF 2.0 A norma OASIS para avisos em JSON, com uma árvore de produtos, listas de estado dos produtos, remediações, um histórico de revisões e regras de distribuição Vende produtos como firmware, appliances ou software empresarial a clientes que automatizam a receção de avisos, muitas vezes compradores industriais e empresariais
OSV O formato Open Source Vulnerability: entradas JSON para pacotes num ecossistema identificado, com intervalos de versões. A GitHub Advisory Database publica os seus avisos neste formato. Distribui pacotes open source através de npm, PyPI, Maven, módulos Go e ecossistemas semelhantes
VEX (CSAF VEX, CycloneDX VEX, OpenVEX) Declarações de que um produto é ou não afetado por uma vulnerabilidade conhecida, e porquê Os clientes analisam a sua SBOM e perguntam por CVE em componentes que não afetam o seu produto

Em CSAF 2.0, o exemplo prático torna-se um documento csaf_security_advisory: o ID do aviso vai para document/tracking/id, o histórico de revisões para document/tracking/revision_history, as versões afetadas e corrigidas para as listas product_status de cada vulnerabilidade, a CWE para o seu objeto cwe e as soluções alternativas para remediations. Um senão: as pontuações do CSAF 2.0 aceitam apenas CVSS v2 e v3.x. O suporte para CVSS v4.0 chega com o CSAF 2.1, que ainda é um rascunho, pelo que um aviso CSAF 2.0 ou inclui um vetor CVSS 3.1 ou apresenta o vetor 4.0 numa nota.

O mesmo aviso como entrada OSV, para equipas que também distribuem o gateway como pacote npm (excerto):

{
  "id": "EXC-2026-007",
  "aliases": ["CVE-2026-XXXXX"],
  "summary": "Path traversal in export API allows reading server files",
  "published": "2026-09-01T09:00:00Z",
  "modified": "2026-09-15T09:00:00Z",
  "severity": [
    {
      "type": "CVSS_V4",
      "score": "CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N"
    }
  ],
  "affected": [
    {
      "package": { "ecosystem": "npm", "name": "@example/gateway" },
      "ranges": [
        {
          "type": "SEMVER",
          "events": [
            { "introduced": "3.9.0" },
            { "fixed": "3.9.7" },
            { "introduced": "4.0.0" },
            { "fixed": "4.2.2" }
          ]
        }
      ]
    }
  ],
  "credits": [{ "name": "A. Researcher", "type": "FINDER" }]
}

Repare que o intervalo inclui dois pares introduced-fixed. O esquema OSV considera uma versão afetada se ela cair em qualquer intervalo ou constar da lista explícita versions, e recomenda fixed em vez de last_affected, porque um limite last-affected pode fazer falhar correspondências.

Regra de decisão: publique sempre a página web e uma CVE. Acrescente OSV, normalmente publicando através do GitHub, se distribuir pacotes open source. Acrescente CSAF se vender produtos a organizações que pedem avisos legíveis por máquina ou que trabalham ao abrigo do Cyber Resilience Act da UE, cujo artigo 14.º, n.º 8, pede um formato estruturado e legível por máquina, quando adequado, ao informar os utilizadores sobre vulnerabilidades ativamente exploradas. Acrescente VEX quando os clientes começarem a enviar-lhe resultados de scanners sobre os seus componentes. Gere todos os formatos a partir de um único registo, para que nunca se contradigam.

GitHub Security Advisories

Se o seu projeto for um repositório público no GitHub, os repository security advisories do GitHub dão-lhe todo o fluxo num só sítio: um rascunho privado para discutir a vulnerabilidade, um fork privado temporário para a corrigir, um pedido de CVE e a publicação. Quatro peças encaixam entre si:

  • Repository security advisories: rascunhos e avisos publicados que pertencem ao seu repositório.
  • Private vulnerability reporting: um botão "Report a vulnerability" na página Advisories do repositório, para que os investigadores lhe possam reportar em privado em vez de abrirem um issue público.
  • IDs CVE do GitHub: o GitHub é uma CNA e pode atribuir um ID CVE ao seu aviso, a menos que o seu projeto esteja abrangido por outra CNA.
  • A GitHub Advisory Database: para os ecossistemas suportados, o GitHub publica aí o seu aviso, em formato OSV, e pode usá-lo para enviar alertas do Dependabot aos repositórios que dependem do seu pacote.

Ativar o private vulnerability reporting

Os proprietários e administradores de um repositório público podem ativá-lo:

  1. Na página principal do repositório, clique em Settings.
  2. Na secção Security and quality da barra lateral, clique em Advanced Security.
  3. Clique em Enable junto a Private vulnerability reporting.

Depois, crie uma ligação para ele a partir do seu SECURITY.md e da sua política de divulgação.

Criar um rascunho de aviso

  1. Na página principal do repositório, abra o separador Security and quality.
  2. Na barra lateral, em Reporting, clique em Advisories e depois em New draft security advisory.
  3. Introduza um título. Em CVE identifier, introduza um ID CVE existente ou opte por pedir um ao GitHub mais tarde.
  4. Escreva a descrição: a vulnerabilidade, o seu impacto, patches, soluções alternativas e referências.
  5. Em Affected products, defina o ecossistema, o nome do pacote, as versões afetadas e as versões corrigidas. Adicione um produto para cada pacote.
  6. Defina a gravidade, ou selecione Assess severity using CVSS e preencha a calculadora.
  7. Adicione a CWE em Weaknesses e quem reportou em Credits.
  8. Clique em Create draft security advisory.

O rascunho permanece privado. A partir dele pode adicionar colaboradores, iniciar um fork privado temporário para preparar a correção e discutir os pormenores com quem reportou.

Pedir uma CVE e publicar

  1. Abra o rascunho a partir de Security and quality e depois Advisories.
  2. No fundo do formulário, clique em Request CVE. Pedir uma CVE não torna o aviso público, e o GitHub diz que normalmente analisa os pedidos em 72 horas, por isso peça cedo.
  3. Lance as versões corrigidas e certifique-se de que o aviso as indica como versões corrigidas.
  4. Clique em Publish advisory. O fork privado temporário é eliminado, o GitHub publica os detalhes da CVE e, para os ecossistemas suportados, o aviso chega à GitHub Advisory Database. Os alertas do Dependabot podem demorar até 72 horas.

Se publicar sem uma versão corrigida, o GitHub avisa que o Dependabot alertará os utilizadores sem sugerir uma versão segura. A base de dados de avisos do GitHub suporta tanto CVSS 3.1 como 4.0. Os passos seguem a documentação do GitHub de novembro de 2026; as etiquetas da interface do GitHub mudam de vez em quando.

Os avisos do GitHub adequam-se a pacotes open source nos ecossistemas que o GitHub suporta. Para firmware, appliances ou produtos de código fechado, publique no seu próprio site, em CSAF onde os clientes o esperam, e obtenha a CVE da sua própria CNA ou de uma cujo âmbito o abranja.

Quando publicar: timing e embargo

O embargo, o período entre o relatório privado e a publicação, e a sua duração pertencem à sua política de divulgação. A função do aviso é chegar no momento certo dentro dele. Um dia de publicação típico decorre assim:

  1. Antes do dia: as correções estão prontas em todos os ramos suportados, o ID CVE está reservado, e o aviso e todas as versões legíveis por máquina estão escritos e revistos.
  2. Aviso antecipado, se o der: grandes clientes, fornecedores a jusante que integram o seu produto e coordenadores recebem o aviso sob embargo alguns dias antes, para estarem prontos a responder aos seus próprios clientes.
  3. Lançamento: as versões corrigidas são disponibilizadas.
  4. Publicação: a página do aviso, o registo CVE, os documentos CSAF ou OSV e a entrada no feed ficam online em simultâneo, idealmente na mesma hora que o lançamento.
  5. Notificação: mailing list e avisos diretos aos clientes afetados.

A ordem importa. Publicar primeiro a correção sem o aviso permite aos atacantes comparar as versões enquanto os defensores não sabem que devem atualizar. Publicar o aviso sem uma correção só é correto quando a vulnerabilidade já é pública ou está a ser explorada: nesse caso, publique o que sabe com mitigações e atualize-o quando a correção sair.

Ao abrigo do Cyber Resilience Act, uma vulnerabilidade ativamente explorada desencadeia também um dever separado de comunicação às autoridades: um alerta precoce no prazo de 24 horas através da Single Reporting Platform, depois uma notificação e um relatório final. Isso não é o seu aviso de segurança, e não é público. O anexo I do CRA também pede aos fabricantes que divulguem publicamente informações sobre vulnerabilidades corrigidas assim que esteja disponível uma atualização de segurança, que é o que um aviso faz. Consulte o que o CRA exige.

Publicação: onde ficam os avisos

  • Uma página estável por aviso, num URL que nunca muda, como /security/advisories/exc-2026-007, mais uma página de índice que lista todos os avisos com os seus produtos, gravidade e datas.
  • Um feed. Um feed RSS ou Atom do índice permite às pessoas subscreverem sem uma mailing list.
  • Metadados de fornecedor CSAF, se publicar CSAF: um ficheiro provider-metadata.json e um diretório ou feed ROLIE dos documentos, para que as ferramentas encontrem todos os avisos sem fazer scraping. Consulte CSAF para as funções e os requisitos.
  • Uma referência no security.txt. O campo Policy aponta para a sua política de divulgação, e a norma CSAF define um campo CSAF que indica às ferramentas os seus metadados de fornecedor:
Contact: mailto:[email protected]
Expires: 2027-09-30T23:00:00.000Z
Policy: https://example.com/security/disclosure-policy
CSAF: https://example.com/.well-known/csaf/provider-metadata.json

Nunca elimine um aviso publicado. Se se revelar errado, publique uma revisão que diga o que mudou; se a vulnerabilidade não era real, marque o aviso como retirado e explique porquê.

Notificar os clientes

Publicar não é o mesmo que ser lido. Os clientes que não subscrevem o seu feed não verão o aviso até o scanner deles assinalar a CVE, ou até alguém lhes perguntar por ela. Para avisos de gravidade alta e crítica:

  • Envie um e-mail aos clientes que utilizam versões afetadas, não a toda a sua lista, com a ligação para o aviso e a única ação que precisam de tomar.
  • Informe as suas equipas de suporte e de vendas antes da publicação, com o aviso e umas breves FAQ, para que as respostas delas coincidam com ele.
  • Informe os fornecedores a jusante que integram o seu produto, para que os avisos deles possam seguir-se rapidamente.
  • Faça o seguimento dos clientes que se mantêm em versões afetadas.

Enviar e-mail apenas aos clientes afetados exige saber que versões do produto cada um utiliza. Para uma vulnerabilidade num componente de terceiros que atingiu muitos fornecedores ao mesmo tempo, consulte como responder aos clientes após um ataque à cadeia de fornecimento, que inclui modelos.

Deve tornar-se uma CNA?

Uma CVE Numbering Authority (CNA) atribui IDs CVE e publica registos CVE para vulnerabilidades num âmbito acordado, normalmente os seus próprios produtos. Tornar-se uma permite-lhe controlar quando o registo CVE aparece, atribuir IDs sem partilhar detalhes sob embargo com outra CNA e redigir o registo pela sua própria mão.

Segundo o programa CVE, não há taxa nem contrato. Uma CNA tem de ter uma política pública de divulgação de vulnerabilidades, uma fonte pública para novas divulgações de vulnerabilidades (a sua página de avisos) e aceitar os termos de utilização do programa. A integração passa por um formulário de registo, uma sessão introdutória e exemplos práticos. Na UE, a ENISA atua como Root para as organizações no seu âmbito, incluindo fornecedores de tecnologia e projetos open source.

  • Adequa-se a um fornecedor que publica CVE regularmente para os seus próprios produtos, já tem uma PSIRT e uma página de avisos, e quer controlar o timing.
  • Não precisa de ser o seu primeiro passo se publica um punhado de CVE por ano, ou se os seus produtos são pacotes open source no GitHub, onde o GitHub pode atribuir os IDs como parte do aviso.

Para obter IDs CVE sem ser uma CNA, consulte divulgação coordenada de vulnerabilidades.

Onde se encaixa o CRACI: as versões afetadas

A maior parte de um aviso é redação. O campo que precisa de evidências é o das versões afetadas e, para vulnerabilidades em componentes de terceiros, é também o mais difícil de acertar: quais das suas versões distribuíram a versão vulnerável, incluindo como dependência transitiva, e desde quando.

O CRACI executa os seus builds do GitHub Actions nos seus próprios runners e regista os pacotes que cada job efetivamente obteve, incluindo dependências transitivas e pacotes restaurados a partir de caches de CI. Cada pacote mostra os seus avisos de segurança (IDs CVE, GHSA e outros) com a gravidade. O histórico de builds mostra todos os builds anteriores e a respetiva SBOM, e que builds continham uma dependência vulnerável, para que saiba o período em que esteve afetado, dentro do seu período de retenção (180 dias por predefinição, personalizado no Enterprise). As equipas de segurança fazem a triagem dos resultados e enviam-nos às equipas responsáveis pela correção, e o CRACI notifica as pessoas relevantes de uma vulnerabilidade e da sua gravidade. Consulte acompanhamento de vulnerabilidades.

Quando uma vulnerabilidade ativamente explorada desencadeia o dever de comunicação do CRA, o CRACI prepara o conteúdo das notificações (alerta precoce, notificação e relatório final); uma pessoa da sua empresa submete-as através da Single Reporting Platform.

Quando o CRACI não é a resposta

  • Redigir e publicar o aviso. O CRACI não redige nem publica avisos de segurança, em CSAF ou em qualquer outro formato. Use o seu próprio site, os GitHub Security Advisories ou uma ferramenta de CSAF para isso.
  • Receber relatórios. O CRACI não recebe relatórios de vulnerabilidades de investigadores ou clientes, nem os acompanha como casos. Use a sua caixa de correio de divulgação, o private vulnerability reporting do GitHub ou um sistema de acompanhamento de casos.
  • Vulnerabilidades no seu próprio código. O CRACI compara os avisos com os pacotes que os seus builds obtiveram. Uma falha como o path traversal do exemplo, no seu próprio código, precisa de revisão de código para descobrir quando foi introduzida.
  • Builds fora do GitHub Actions. O CRACI suporta hoje o GitHub Actions; o GitLab CI e o Jenkins estão no roadmap.
  • Versões mais antigas do que o seu período de retenção. O histórico de builds abrange os builds que o CRACI registou e guardou.

Avisos de segurança: perguntas frequentes

O que é um aviso de segurança?

Um aviso de segurança é uma notificação do fornecedor de um produto que descreve uma vulnerabilidade no produto: que produtos e versões são afetados, qual a sua gravidade, o que um atacante poderia fazer e como a corrigir ou mitigar. Normalmente inclui um ID CVE e é publicado quando há uma correção disponível.

Qual é a diferença entre um aviso de segurança e um boletim de segurança?

Um aviso cobre normalmente uma vulnerabilidade, ou algumas relacionadas, em pormenor. Um boletim reúne muitas correções de uma versão ou de um período, muitas vezes com uma periodicidade fixa; o Android, por exemplo, publica os seus boletins de segurança mensalmente. Alguns fornecedores usam as duas palavras indistintamente.

O que deve incluir um aviso de segurança?

Um ID do aviso e um ID CVE, um título, os produtos e versões afetados como intervalos por ramo, os produtos verificados e não afetados, as versões corrigidas, a gravidade com o vetor CVSS completo, a CWE, uma descrição, o impacto e as suas pré-condições, soluções alternativas, créditos, uma cronologia, referências e um histórico de revisões.

Como crio um GitHub security advisory?

Num repositório público, abra o separador Security and quality, clique em Advisories em Reporting e depois em New draft security advisory. Preencha o título, a descrição, os produtos afetados, a gravidade, a CWE e os créditos, e guarde o rascunho. Quando a correção for lançada, peça uma CVE se precisar de uma e clique em Publish advisory.

O GitHub pode atribuir um ID CVE ao meu aviso?

Sim, se o seu projeto não estiver abrangido por outra CNA. O GitHub é uma CVE Numbering Authority. Peça a CVE a partir do rascunho do aviso; o pedido não torna o aviso público, e o GitHub diz que normalmente analisa os pedidos em 72 horas. O GitHub publica os detalhes da CVE quando o aviso se torna público.

Os avisos de segurança devem ser legíveis por máquina?

Cada vez mais, sim. Publique uma página web para as pessoas e acrescente uma versão legível por máquina para os clientes que automatizam: CSAF para produtos vendidos a empresas e à indústria, OSV para pacotes open source, e VEX para dizer que vulnerabilidades conhecidas não afetam o seu produto. Gere-os a partir do mesmo registo.

Quando deve ser publicado um aviso de segurança?

Ao mesmo tempo que as versões corrigidas, depois de qualquer aviso antecipado sob embargo a clientes-chave e fornecedores a jusante. Publique mais cedo, com mitigações, apenas se a vulnerabilidade já for pública ou estiver a ser explorada, e atualize o aviso quando a correção sair.

Preciso de ser uma CNA para publicar um aviso de segurança?

Não. Qualquer pessoa pode publicar um aviso. Ser uma CVE Numbering Authority significa apenas que pode atribuir IDs CVE por si. Sem isso, uma CNA cujo âmbito abranja o seu produto, o GitHub para projetos open source no GitHub, ou uma CNA of Last Resort pode atribuir o ID.

Saiba que versões indicar como afetadas

Um aviso só é tão rigoroso quanto as suas versões afetadas. Marque uma demo para ver quais dos seus builds do GitHub Actions continham um pacote vulnerável.

Marcar demo