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#
- Sur la page Audits, carte Historique des audits, cliquez sur le nom du dépôt de l'audit voulu.
- 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#
| Badge | Signification |
|---|---|
| En file | L'audit attend le worker. |
| En cours | Les contrôles sont en train de lire le dépôt. |
| Terminé | Tous les contrôles ont une couverture complète. |
| Partiel | Au moins un contrôle est incomplet ou indisponible, ou plus de 100 constats ont été trouvés. |
| Échec | L'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 :
Signaux de secrets
24 élément(s) lu(s) · 3 ignoré(s) Partiel · 1840 ms| État d'un contrôle | Signification |
|---|---|
| Terminé | Tous les éléments éligibles ont été lus. |
| Partiel | Une partie seulement a été lue : limite de 32 fichiers, arborescence tronquée par GitHub, ou plus de 100 alertes Dependabot. |
| Indisponible | Le 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 potentiel | Signaux de secrets |
| Fichier sensible | Signaux de secrets |
| Image sans attribut alt | Accessibilité HTML statique |
| Langue HTML absente | Accessibilité HTML statique |
| Fichier de verrouillage manquant | Dépendances |
| Alerte de dépendance | Dé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.