Audits et banc d'essai

Lire un audit

Le dossier d'audit présente l'état de l'audit, la couverture de chaque contrôle et la liste des constats à examiner. Il permet de juger ce qui a été vérifié avant de qualifier les résultats.

Qui peut le faire : tout membre du projet (Lecteur compris) et l'Administrateur.

Ouvrir un dossier#

  1. Sur la page Audits, carte Historique des audits, cliquez sur le nom du dépôt de l'audit voulu.
  2. Le dossier s'ouvre à l'adresse /projects/<projectId>/audits/<auditId>.

L'en-tête affiche le dépôt, l'état de l'audit, sa date de fin et le commit lu (Commit suivi de son identifiant).

États d'un audit#

BadgeSignification
En fileL'audit attend le worker.
En coursLes contrôles sont en train de lire le dépôt.
TerminéTous les contrôles ont une couverture complète.
PartielAu moins un contrôle est incomplet ou indisponible, ou plus de 100 constats ont été trouvés.
ÉchecL'audit n'a pas pu lire le dépôt (accès retiré, GitHub indisponible…).

Un audit Terminé ou Partiel peut mener au rapport final. Un audit Partiel reste exploitable : le rapport signale ses limites.

La carte Contrôles#

Chaque ligne indique un contrôle, le nombre d'éléments lus et ignorés, son état et sa durée en millisecondes :

text
Signaux de secrets
24 élément(s) lu(s) · 3 ignoré(s)          Partiel · 1840 ms
État d'un contrôleSignification
TerminéTous les éléments éligibles ont été lus.
PartielUne partie seulement a été lue : limite de 32 fichiers, arborescence tronquée par GitHub, ou plus de 100 alertes Dependabot.
IndisponibleLe contrôle n'a pas pu s'exécuter, par exemple quand Dependabot est désactivé ou non autorisé pour le dépôt.

Signaux de secrets et Accessibilité HTML statique partagent la même étape de lecture : ils affichent donc la même durée.

Les constats#

La section Constats à examiner liste un constat par carte. Chaque carte affiche son intitulé, son emplacement quand il peut être montré, et un badge de qualification : À qualifier, Validé ou Rejeté.

IntituléContrôle
Secret potentielSignaux de secrets
Fichier sensibleSignaux de secrets
Image sans attribut altAccessibilité HTML statique
Langue HTML absenteAccessibilité HTML statique
Fichier de verrouillage manquantDépendances
Alerte de dépendanceDépendances

Les constats des contrôles dynamiques portent le titre donné par l'outil, une sévérité, une référence WCAG ou CWE éventuelle et la règle de l'outil (axe.… ou zap.…). La sévérité vaut Critique, Élevée, Moyenne, Faible ou Information.

Si aucun constat n'existe, la section affiche Aucun constat dans cette vue : consultez alors les contrôles pour connaître le périmètre réellement couvert.

Contrôles sur la recette#

Quand l'audit comprend des contrôles dynamiques, la carte Contrôles sur la recette les liste avec le nombre de requêtes envoyées sur le budget autorisé et, s'il y a lieu, la raison d'arrêt. Voir Contrôles dynamiques.

Ce qui se passe ensuite#

Tant que des constats restent À qualifier, l'en-tête indique leur nombre, par exemple « 3 constats à qualifier avant le rapport. ». Une fois tous qualifiés et les contrôles dynamiques terminés, le lien Ouvrir le rapport final apparaît.

Pour continuer#

Qualifier les constats