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:
- Na página principal do repositório, clique em Settings.
- Na secção Security and quality da barra lateral, clique em Advanced Security.
- 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
- Na página principal do repositório, abra o separador Security and quality.
- Na barra lateral, em Reporting, clique em Advisories e depois em New draft security advisory.
- Introduza um título. Em CVE identifier, introduza um ID CVE existente ou opte por pedir um ao GitHub mais tarde.
- Escreva a descrição: a vulnerabilidade, o seu impacto, patches, soluções alternativas e referências.
- 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.
- Defina a gravidade, ou selecione Assess severity using CVSS e preencha a calculadora.
- Adicione a CWE em Weaknesses e quem reportou em Credits.
- 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
- Abra o rascunho a partir de Security and quality e depois Advisories.
- 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.
- Lance as versões corrigidas e certifique-se de que o aviso as indica como versões corrigidas.
- 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:
- 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.
- 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.
- Lançamento: as versões corrigidas são disponibilizadas.
- 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.
- 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.jsone 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
Policyaponta para a sua política de divulgação, e a norma CSAF define um campoCSAFque 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