Audits et banc d'essai

Ouvrir une issue depuis un constat

Un constat validé peut devenir une issue GitHub dans le dépôt audité. L'équipe du dépôt la traite ensuite comme toute autre issue. C'est la seule écriture qu'un audit peut faire sur GitHub.

Qui peut le faire : le Responsable et l'Administrateur, avec une vérification récente. Sans vérification récente, le dossier affiche « Une vérification récente est requise pour le responsable qui publie. ».

Conditions#

  • L'ouverture d'issues depuis les audits est activée par l'exploitant.
  • Le constat est Validé et provient d'un contrôle statique. Les constats des contrôles dynamiques restent dans le rapport : ils n'ouvrent jamais d'issue.
  • Le dépôt est actif, rattaché, et la case Autoriser la proposition de correctifs de sa politique est cochée (voir Surveillance et politique du dépôt).
  • Les issues sont activées sur le dépôt GitHub, qui n'est ni archivé ni désactivé.

Pas à pas#

  1. Ouvrez le dossier d'audit. Les actions ne sont proposées que sur le dossier, pas sur le rapport final.
  2. Sur la carte d'un constat Validé, dépliez Préparer une issue GitHub.
  3. Lisez l'avertissement : « La publication reprend un résumé de remédiation. Un dépôt public ou interne reçoit un suivi générique. ».
  4. Si le dépôt est public ou interne, cochez J'autorise le suivi générique si le dépôt est public ou interne.
  5. Cliquez sur Confirmer l'ouverture.

Contenu de l'issue#

Visibilité du dépôtTitreCorps
Privé[Audit] suivi de l'intitulé du constat, par exemple [Audit] Image HTML sans attribut altConseil de remédiation et, sauf pour un secret ou un fichier sensible, le fichier concerné
Public ou interne[Audit] Suivi de maintenance« Un constat interne a été qualifié. Consulter le dossier privé pour les détails. »

L'issue ne contient jamais la valeur d'un secret, les notes internes, ni l'emplacement d'un secret ou d'un fichier sensible.

Suivre l'ouverture#

La carte du constat affiche l'état de la demande :

AffichageSignification
En fileDemande enregistrée, en attente du worker
Envoi à confirmerLa création est partie ; la plateforme attend la preuve GitHub
Issue #<numéro> (lien)L'issue existe sur GitHub
Confirmation de visibilité requiseLe dépôt est public ou interne et la case n'était pas cochée : dépliez de nouveau Préparer une issue GitHub, cochez la case et confirmez
Publication bloquéeUne vérification a échoué au moment d'écrire (droits, rattachement, politique, visibilité, issues désactivées)

Une seule issue par constat#

L'ouverture est unique : renvoyer la demande ne crée pas de doublon. Si GitHub ne confirme pas la création, la plateforme recherche l'issue signée par la GitHub App avant toute nouvelle tentative. Sans preuve, la demande reste en attente et rien n'est renvoyé.

Au moment de l'écriture, la plateforme revérifie la version du dépôt et du projet, le rattachement, la politique, la visibilité et vos droits. Si la visibilité du dépôt a changé entre-temps, l'écriture est refusée.

Refus courants#

MessageCauseQue faire
« Audit indisponible ou accès refusé. »Rôle insuffisant ou vérification récente expiréePassez par Vérifier à nouveau mon identité
« Cette action exige un état ou une autorisation à jour. »Constat dynamique, dépôt arrêté ou non rattaché, case Autoriser la proposition de correctifs décochéeCorrigez la configuration du dépôt
« Service temporairement indisponible. »Ouverture d'issues non activée, ou service indisponibleContactez l'exploitant

Pour continuer#

Accord de recette