PSIRT
Avis de sécurité : comment le rédiger, avec un modèle et un exemple complet
Un avis de sécurité est le document sur lequel vos clients s'appuient pour agir quand une vulnérabilité touche votre produit. Un bon avis leur dit, sans ticket au support, s'ils sont concernés, à quel point et quoi faire. Ce guide couvre les champs, un exemple complet, les formats lisibles par machine, les GitHub Security Advisories et le moment de publier.
Mis à jour le
Qu'est-ce qu'un avis de sécurité ?
Un avis de sécurité (security advisory) est une notice du fournisseur d'un produit qui décrit une vulnérabilité de ce produit : quels produits et versions sont touchés, quelle est sa gravité, ce qu'un attaquant pourrait faire, et comment les utilisateurs la corrigent ou l'atténuent. Il s'adresse aux personnes qui exploitent le produit, et de plus en plus aussi à leurs outils.
Les avis de sécurité sont le versant public de la divulgation coordonnée des vulnérabilités : un découvreur signale en privé, le fournisseur corrige, et l'avis est la manière dont tous les autres en prennent connaissance. Dans la plupart des éditeurs de logiciels et des fabricants d'appareils, c'est le PSIRT qui les rédige, dans le cadre d'un programme plus large de sécurité produit.
Avis de sécurité, bulletin de sécurité, fiche CVE, VEX et notes de version
Ces documents se recoupent, et les équipes les confondent souvent :
| Document | Qui le publie | Ce qu'il couvre | Lecteur principal |
|---|---|---|---|
| Avis de sécurité | Le fournisseur du produit, ou un coordinateur | Une vulnérabilité, ou quelques vulnérabilités liées, dans vos produits : versions touchées, gravité, correctif | Les exploitants et les équipes de sécurité des clients |
| Bulletin de sécurité | Le fournisseur, souvent selon un calendrier fixe | Un récapitulatif de nombreux correctifs pour une release ou une période. Les bulletins de sécurité d'Android, par exemple, paraissent le premier lundi de chaque mois. | Les équipes qui appliquent les correctifs par cycles |
| Fiche CVE | Une CVE Numbering Authority (CNA) | L'identifiant mondial et une description minimale d'une vulnérabilité : produit touché, type de problème, description et au moins une référence publique | Les bases de vulnérabilités et les scanners |
| Déclaration VEX | Le fournisseur | Un statut lisible par machine par produit et par vulnérabilité : touché, non touché, corrigé, en cours d'analyse | Les scanners des clients |
| Notes de version | Le fournisseur | Tout ce qui a changé dans une release, les correctifs de sécurité parmi les autres changements | Quiconque met à jour |
Le schéma habituel : un avis par vulnérabilité, avec un ID CVE qui le relie à la fiche CVE, référencé dans les notes de version de chaque version corrigée et dans le bulletin si vous en publiez un. « Bulletin de sécurité » et « avis de sécurité » sont parfois employés comme synonymes ; l'important est que chaque vulnérabilité ait une page stable que les clients peuvent citer.
Ce qu'un avis de sécurité doit contenir
Les champs ci-dessous sont ceux que les clients recherchent, et ils correspondent un à un aux formats lisibles par machine présentés plus loin dans ce guide. Les règles CNA du programme CVE fixent le minimum pour la fiche CVE : au moins un produit et une version touchés, le type ou la cause de la vulnérabilité (de préférence sous forme de CWE), une description rédigée et une référence publique. Un avis utile va plus loin.
| Champ | Ce qu'il indique | Erreur fréquente |
|---|---|---|
| ID de l'avis | Votre propre identifiant stable, comme EXC-2026-007, plus l'ID CVE |
N'utiliser que l'ID CVE, que vous n'aurez peut-être pas encore le jour où vous devez publier |
| Titre | Produit, type de vulnérabilité et impact en une ligne | « Mise à jour de sécurité pour le produit X », qui ne dit rien |
| Produits et versions touchés | Chaque produit et version touchés, sous forme de plages par branche de release | « Versions antérieures à 4.2.2 », qui inclut à tort des branches qui n'ont jamais eu le bug |
| Non touchés | Les produits et versions vérifiés et jugés non touchés | L'omettre, si bien que chaque client sur une version plus ancienne ouvre un ticket |
| Versions corrigées | La première version corrigée sur chaque branche prise en charge | Ne citer que la dernière release |
| Gravité | Un niveau et le vecteur CVSS complet, avec la version de CVSS | Un score seul sans vecteur, que personne ne peut vérifier ni adapter à son environnement |
| Faiblesse | L'ID et le nom de la CWE | L'omettre ; les bases de données et les règles CVE l'attendent |
| Description | Ce qu'est la faille et où elle se trouve, avec assez de détails pour juger de l'exposition, sans exploit fonctionnel | Si vague que les clients ne savent pas si leur configuration est exposée |
| Impact | Ce que gagne un attaquant, et ce dont il a besoin au préalable (accès, rôle, position sur le réseau) | Répéter les métriques CVSS en toutes lettres au lieu d'expliquer les conséquences |
| Contournements et atténuations | Que faire si vous ne pouvez pas mettre à jour aujourd'hui, et comment vérifier si vous avez été exploité | « Aucun contournement » alors qu'un changement de configuration bloquerait l'attaque |
| Remerciements | Qui l'a trouvée et signalée, avec son consentement | Citer quelqu'un qui a demandé à rester anonyme |
| Chronologie | Signalée, confirmée, corrigée, publiée | L'omettre, ce qui donne l'impression que de longs délais sont cachés |
| Références | Fiche CVE, notes de version, commit du correctif, versions lisibles par machine | Des liens vers des tickets internes que les clients ne peuvent pas ouvrir |
| Historique des révisions | Chaque modification après la première publication, avec une date et une version | Modifier en silence les versions touchées |
Le champ le plus difficile est celui des versions touchées. Le code vulnérable a été introduit à un moment et corrigé à un autre, et chaque branche prise en charge a son propre correctif. Si la vulnérabilité est arrivée par un composant tiers, la question devient : lesquelles de vos releases ont livré la version vulnérable de ce composant, directement ou comme dépendance transitive ? Voir comment évaluer une nouvelle CVE sur l'ensemble de vos builds.
Un exemple complet
Voici un avis complet pour un produit fictif : Example Gateway, une passerelle d'API auto-hébergée d'Example Corp, avec deux branches prises en charge, 3.9 et 4.x. L'endpoint vulnérable a été ajouté en 3.9.0, donc 3.8 et les versions antérieures ne sont pas touchées. Tous les noms, ID et dates sont inventés ; le score CVSS 4.0 est calculé à partir du vecteur indiqué.
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
Trois éléments font la qualité de cet avis :
- Des plages par branche. « 4.0.0 à 4.2.1 » et « 3.9.0 à 3.9.6 » sont exacts. « Avant 4.2.2 » aurait dit à chaque client en 3.8 qu'il était touché.
- L'impact nomme la condition préalable. Un client sans compte viewer sait que son exposition réelle est faible ; un client avec des centaines de prestataires dans le rôle viewer sait qu'elle ne l'est pas.
- Le contournement inclut la suite. La mise à jour ferme la brèche mais n'annule pas la fuite d'un secret, donc l'avis dit quoi renouveler.
Un modèle d'avis de sécurité à copier
Remplacez les parties entre crochets. Ne supprimez une section que si elle ne s'applique vraiment pas, et dites-le plutôt que de la laisser vide là où les clients l'attendent (par exemple « 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
Avis lisibles par l'humain et avis lisibles par machine
Une page web suffit aux personnes. Elle ne suffit pas à un client qui a des milliers d'appareils ou des centaines de services, et dont les outils doivent rapprocher votre avis de ce qu'il exploite. Trois familles de formats le permettent, et elles répondent à des besoins différents :
| Format | Ce que c'est | À utiliser quand |
|---|---|---|
| Page web (et PDF) | L'avis tel que les personnes le lisent | Toujours. Tous les autres formats renvoient vers elle. |
| CSAF 2.0 | La norme OASIS pour les avis en JSON, avec un arbre de produits, des listes de statut par produit, des remédiations, un historique des révisions et des règles de distribution | Vous vendez des produits comme du firmware, des appliances ou des logiciels d'entreprise à des clients qui automatisent la réception des avis, souvent des acheteurs industriels et des grandes entreprises |
| OSV | Le format Open Source Vulnerability : des entrées JSON pour les paquets d'un écosystème nommé, avec des plages de versions. La GitHub Advisory Database publie ses avis dans ce format. | Vous livrez des paquets open source via npm, PyPI, Maven, les modules Go et des écosystèmes similaires |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Des déclarations indiquant qu'un produit est ou n'est pas touché par une vulnérabilité connue, et pourquoi | Les clients analysent votre SBOM et vous interrogent sur des CVE de composants qui ne touchent pas votre produit |
En CSAF 2.0, l'exemple complet devient un document csaf_security_advisory : l'ID de l'avis va dans
document/tracking/id, l'historique des révisions dans document/tracking/revision_history, les
versions touchées et corrigées dans les listes product_status de chaque vulnérabilité, la CWE dans son objet
cwe et les contournements dans remediations. Un piège : les scores de CSAF 2.0 n'acceptent que CVSS
v2 et v3.x. La prise en charge de CVSS v4.0 arrive avec CSAF 2.1, qui est encore un projet, donc un avis CSAF 2.0 porte
soit un vecteur CVSS 3.1, soit le vecteur 4.0 dans une note.
Le même avis sous forme d'entrée OSV, pour les équipes qui livrent aussi la passerelle comme paquet npm (extrait) :
{
"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" }]
}
Notez que la plage contient deux paires introduced-fixed. Le
schéma OSV considère une version comme touchée si elle
tombe dans une plage quelconque ou figure dans la liste explicite versions, et recommande fixed plutôt que
last_affected, car une borne last-affected peut faire manquer des correspondances.
Règle de décision : publiez toujours la page web et une CVE. Ajoutez OSV, généralement en publiant via GitHub, si vous livrez des paquets open source. Ajoutez CSAF si vous vendez des produits à des organisations qui demandent des avis lisibles par machine ou si vous relevez du Cyber Resilience Act de l'UE, dont l'article 14, paragraphe 8, demande un format structuré et lisible par machine, le cas échéant, pour informer les utilisateurs des vulnérabilités activement exploitées. Ajoutez VEX dès que les clients commencent à vous envoyer des résultats de scanner sur vos composants. Générez tous les formats à partir d'un seul enregistrement pour qu'ils ne se contredisent jamais.
GitHub Security Advisories
Si votre projet est un dépôt public sur GitHub, les repository security advisories de GitHub réunissent tout le flux au même endroit : un brouillon privé pour discuter de la vulnérabilité, un fork privé temporaire pour la corriger, une demande de CVE et la publication. Quatre éléments s'articulent :
- Repository security advisories : les brouillons et avis publiés qui appartiennent à votre dépôt.
- Signalement privé de vulnérabilités : un bouton « Report a vulnerability » sur la page Advisories du dépôt, pour que les chercheurs vous signalent une faille en privé au lieu d'ouvrir une issue publique.
- ID CVE attribués par GitHub : GitHub est une CNA et peut attribuer un ID CVE à votre avis, sauf si votre projet relève d'une autre CNA.
- La GitHub Advisory Database : pour les écosystèmes pris en charge, GitHub y publie votre avis, au format OSV, et peut s'en servir pour envoyer des alertes Dependabot aux dépôts qui dépendent de votre paquet.
Activer le signalement privé de vulnérabilités
Les propriétaires et administrateurs d'un dépôt public peuvent l'activer :
- Sur la page principale du dépôt, cliquez sur Settings.
- Dans la section Security and quality de la barre latérale, cliquez sur Advanced Security.
- Cliquez sur Enable à côté de Private vulnerability reporting.
Ajoutez ensuite un lien vers ce canal dans votre SECURITY.md et votre politique de divulgation.
Créer un brouillon d'avis
- Sur la page principale du dépôt, ouvrez l'onglet Security and quality.
- Dans la barre latérale, sous Reporting, cliquez sur Advisories, puis sur New draft security advisory.
- Saisissez un titre. Sous CVE identifier, saisissez un ID CVE existant ou choisissez d'en demander un à GitHub plus tard.
- Rédigez la description : la vulnérabilité, son impact, les correctifs, les contournements et les références.
- Sous Affected products, indiquez l'écosystème, le nom du paquet, les versions touchées et les versions corrigées. Ajoutez un produit pour chaque paquet.
- Définissez la gravité, ou sélectionnez Assess severity using CVSS et remplissez le calculateur.
- Ajoutez la CWE sous Weaknesses et la personne qui l'a signalée sous Credits.
- Cliquez sur Create draft security advisory.
Le brouillon reste privé. À partir de lui, vous pouvez ajouter des collaborateurs, créer un fork privé temporaire pour préparer le correctif et discuter des détails avec la personne qui a signalé la faille.
Demander une CVE et publier
- Ouvrez le brouillon depuis Security and quality, puis Advisories.
- En bas du formulaire, cliquez sur Request CVE. Demander une CVE ne rend pas l'avis public, et GitHub indique examiner généralement les demandes sous 72 heures : faites-la tôt.
- Publiez les versions corrigées, et vérifiez que l'avis les indique comme versions corrigées.
- Cliquez sur Publish advisory. Le fork privé temporaire est supprimé, GitHub publie les détails de la CVE, et pour les écosystèmes pris en charge l'avis rejoint la GitHub Advisory Database. Les alertes Dependabot peuvent prendre jusqu'à 72 heures.
Si vous publiez sans version corrigée, GitHub prévient que Dependabot alertera les utilisateurs sans leur proposer de version sûre. La base d'avis de GitHub prend en charge CVSS 3.1 et 4.0. Les étapes suivent GitHub Docs en novembre 2026 ; les libellés de l'interface GitHub changent de temps à autre.
Les avis GitHub conviennent aux paquets open source des écosystèmes que GitHub prend en charge. Pour le firmware, les appliances ou les produits propriétaires, publiez sur votre propre site, en CSAF là où les clients l'attendent, et obtenez la CVE auprès de votre propre CNA ou d'une CNA dont le périmètre vous couvre.
Quand publier : timing et embargo
L'embargo, la période entre le signalement privé et la publication, et sa durée relèvent de votre politique de divulgation. Le rôle de l'avis est d'arriver au bon moment dans ce cadre. Une journée de publication type se déroule ainsi :
- Avant le jour J : les correctifs sont prêts sur chaque branche prise en charge, l'ID CVE est réservé, et l'avis ainsi que chaque version lisible par machine sont rédigés et relus.
- Préavis, si vous en donnez un : les grands clients, les éditeurs en aval qui intègrent votre produit et les coordinateurs reçoivent l'avis sous embargo quelques jours avant, pour être prêts à répondre à leurs propres clients.
- Release : les versions corrigées sortent.
- Publication : la page de l'avis, la fiche CVE, les documents CSAF ou OSV et l'entrée du flux sont mis en ligne ensemble, idéalement dans l'heure qui suit la release.
- Notification : liste de diffusion et messages directs aux clients concernés.
L'ordre compte. Publier le correctif d'abord sans l'avis permet aux attaquants de comparer les releases alors que les défenseurs ne savent pas qu'ils doivent mettre à jour. Publier l'avis sans correctif n'est justifié que si la vulnérabilité est déjà publique ou exploitée : publiez alors ce que vous savez avec des atténuations, et mettez l'avis à jour quand le correctif sort.
Sous le Cyber Resilience Act, une vulnérabilité activement exploitée déclenche aussi une obligation distincte de notification aux autorités : une alerte précoce sous 24 heures via la Single Reporting Platform, puis une notification et un rapport final. Ce n'est pas votre avis de sécurité, et ce n'est pas public. L'annexe I du CRA demande aussi aux fabricants de divulguer publiquement les informations sur les vulnérabilités corrigées une fois qu'une mise à jour de sécurité est disponible, ce que fait un avis de sécurité. Voir ce qu'exige le CRA.
Publication : où vivent les avis
-
Une page stable par avis, à une URL qui ne change jamais, comme
/security/advisories/exc-2026-007, plus une page d'index qui liste chaque avis avec ses produits, sa gravité et ses dates. - Un flux. Un flux RSS ou Atom de l'index permet de s'abonner sans liste de diffusion.
-
Les métadonnées de fournisseur CSAF, si vous publiez en CSAF : un fichier
provider-metadata.jsonet un répertoire ou un flux ROLIE des documents, pour que les outils trouvent chaque avis sans scraping. Voir CSAF pour les rôles et les exigences. -
Un pointeur dans security.txt. Le champ
Policyrenvoie vers votre politique de divulgation, et la norme CSAF définit un champCSAFqui oriente les outils vers vos métadonnées de fournisseur :
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
Ne supprimez jamais un avis publié. S'il s'avère erroné, publiez une révision qui indique ce qui a changé ; si la vulnérabilité n'était pas réelle, marquez l'avis comme retiré et expliquez pourquoi.
Prévenir les clients
Publier ne veut pas dire être lu. Les clients qui ne sont pas abonnés à votre flux ne verront pas l'avis tant que leur scanner ne signale pas la CVE, ou que quelqu'un ne les interroge pas à ce sujet. Pour les avis de gravité élevée et critique :
- Écrivez aux clients qui exploitent des versions touchées, pas à toute votre liste, avec le lien vers l'avis et la seule action qu'ils doivent effectuer.
- Briefez vos équipes support et commerciales avant la publication, avec l'avis et une courte FAQ, pour que leurs réponses concordent.
- Prévenez les éditeurs en aval qui intègrent votre produit, pour que leurs propres avis suivent rapidement.
- Relancez les clients qui restent sur des versions touchées.
N'écrire qu'aux clients concernés suppose de savoir quelles versions du produit chacun exploite. Pour une vulnérabilité dans un composant tiers qui a touché de nombreux éditeurs à la fois, voir comment répondre aux clients après une attaque de la chaîne d'approvisionnement, avec des modèles.
Faut-il devenir CNA ?
Une CVE Numbering Authority (CNA) attribue des ID CVE et publie des fiches CVE pour les vulnérabilités d'un périmètre convenu, généralement ses propres produits. En devenir une vous permet de décider du moment où la fiche CVE apparaît, d'attribuer des ID sans partager de détails sous embargo avec une autre CNA, et de rédiger la fiche vous-même.
Selon le programme CVE, il n'y a ni frais ni contrat. Une CNA doit avoir une politique publique de divulgation des vulnérabilités, une source publique pour les nouvelles divulgations (votre page d'avis) et accepter les conditions d'utilisation du programme. L'intégration passe par un formulaire d'inscription, une session d'introduction et des exercices pratiques. Dans l'UE, l'ENISA joue le rôle de Root pour les organisations de son périmètre, y compris les éditeurs de technologies et les projets open source.
- C'est adapté à un éditeur qui publie régulièrement des CVE pour ses propres produits, a déjà un PSIRT et une page d'avis, et veut maîtriser le calendrier.
- Ce n'est pas forcément votre première étape si vous publiez une poignée de CVE par an, ou si vos produits sont des paquets open source sur GitHub, où GitHub peut attribuer les ID dans le cadre de l'avis.
Pour obtenir des ID CVE sans être CNA, voir divulgation coordonnée des vulnérabilités.
La place de CRACI : les versions touchées
L'essentiel d'un avis relève de la rédaction. Le champ qui exige des preuves est celui des versions touchées, et pour les vulnérabilités des composants tiers c'est aussi le plus difficile à établir correctement : lesquelles de vos releases ont livré la version vulnérable, y compris comme dépendance transitive, et depuis quand.
CRACI exécute vos builds GitHub Actions sur ses propres runners et enregistre les paquets que chaque job a réellement récupérés, y compris les dépendances transitives et les paquets restaurés depuis les caches CI. Chaque paquet affiche ses avis (CVE, GHSA et autres identifiants) avec leur gravité. L'historique des builds montre chaque build passé et son SBOM, et quels builds contenaient une dépendance vulnérable, pour que vous connaissiez la période pendant laquelle vous étiez touché, dans la limite de votre durée de conservation (180 jours par défaut, personnalisable avec Enterprise). Les équipes de sécurité trient les résultats et les transmettent aux équipes responsables du correctif, et CRACI prévient les personnes concernées d'une vulnérabilité et de sa gravité. Voir suivi des vulnérabilités.
Lorsqu'une vulnérabilité activement exploitée déclenche l'obligation de notification du CRA, CRACI prépare le contenu des notifications (alerte précoce, notification et rapport final) ; une personne de votre entreprise les soumet via la Single Reporting Platform.
Quand CRACI n'est pas la réponse
- Rédiger et publier l'avis. CRACI ne rédige ni ne publie d'avis de sécurité, en CSAF ou dans un autre format. Utilisez pour cela votre propre site, les GitHub Security Advisories ou un outil CSAF.
- Recevoir les signalements. CRACI ne reçoit pas les signalements de vulnérabilités des chercheurs ou des clients, et ne les suit pas comme des dossiers. Utilisez votre boîte de réception dédiée, le signalement privé de vulnérabilités de GitHub ou un outil de suivi de dossiers.
- Les vulnérabilités de votre propre code. CRACI rapproche les avis des paquets que vos builds ont récupérés. Une faille comme le path traversal de l'exemple, dans votre propre code, demande une revue de code pour savoir quand elle a été introduite.
- Les builds hors de GitHub Actions. CRACI prend en charge GitHub Actions aujourd'hui ; GitLab CI et Jenkins sont sur la feuille de route.
- Les releases plus anciennes que votre durée de conservation. L'historique des builds couvre les builds que CRACI a enregistrés et conservés.
Avis de sécurité : questions fréquentes
Qu'est-ce qu'un avis de sécurité ?
Un avis de sécurité est une notice du fournisseur d'un produit qui décrit une vulnérabilité de ce produit : quels produits et versions sont touchés, quelle est sa gravité, ce qu'un attaquant pourrait faire, et comment la corriger ou l'atténuer. Il porte généralement un ID CVE et est publié une fois qu'un correctif est disponible.
Quelle est la différence entre un avis de sécurité et un bulletin de sécurité ?
Un avis couvre généralement une vulnérabilité, ou quelques vulnérabilités liées, en détail. Un bulletin regroupe de nombreux correctifs pour une release ou une période, souvent selon un calendrier fixe ; Android, par exemple, publie ses bulletins de sécurité chaque mois. Certains éditeurs emploient les deux termes indifféremment.
Que doit contenir un avis de sécurité ?
Un ID d'avis et un ID CVE, un titre, les produits et versions touchés sous forme de plages par branche, les produits vérifiés et non touchés, les versions corrigées, la gravité avec le vecteur CVSS complet, la CWE, une description, l'impact et ses conditions préalables, les contournements, les remerciements, une chronologie, des références et un historique des révisions.
Comment créer un avis de sécurité sur GitHub ?
Dans un dépôt public, ouvrez l'onglet Security and quality, cliquez sur Advisories sous Reporting, puis sur New draft security advisory. Renseignez le titre, la description, les produits touchés, la gravité, la CWE et les remerciements, puis enregistrez le brouillon. Une fois le correctif publié, demandez une CVE si nécessaire et cliquez sur Publish advisory.
GitHub peut-il attribuer un ID CVE à mon avis ?
Oui, si votre projet ne relève pas d'une autre CNA. GitHub est une CVE Numbering Authority. Demandez la CVE depuis le brouillon d'avis ; la demande ne rend pas l'avis public, et GitHub indique examiner généralement les demandes sous 72 heures. GitHub publie les détails de la CVE une fois l'avis rendu public.
Les avis de sécurité doivent-ils être lisibles par machine ?
De plus en plus, oui. Publiez une page web pour les personnes, et ajoutez une version lisible par machine pour les clients qui automatisent : CSAF pour les produits vendus aux entreprises et à l'industrie, OSV pour les paquets open source, et VEX pour indiquer quelles vulnérabilités connues ne touchent pas votre produit. Générez-les à partir du même enregistrement.
Quand faut-il publier un avis de sécurité ?
En même temps que les versions corrigées, après un éventuel préavis sous embargo aux clients clés et aux éditeurs en aval. Ne publiez plus tôt, avec des atténuations, que si la vulnérabilité est déjà publique ou exploitée, et mettez l'avis à jour quand le correctif sort.
Faut-il être CNA pour publier un avis de sécurité ?
Non. Tout le monde peut publier un avis. Être CVE Numbering Authority signifie seulement que vous pouvez attribuer vous-même des ID CVE. Sinon, une CNA dont le périmètre couvre votre produit, GitHub pour les projets open source hébergés sur GitHub, ou une CNA of Last Resort peut attribuer l'ID.
Sachez quelles releases indiquer comme touchées
Un avis n'est exact que si ses versions touchées le sont. Réservez une démo pour voir lesquels de vos builds GitHub Actions contenaient un paquet vulnérable.
Réserver une démo