Audits et banc d'essai

Vue d'ensemble des audits

Un audit contrôle un dépôt rattaché sans rien y modifier. Il produit des constats que vous qualifiez, puis un rapport final remis au client. Aucun modèle d'IA n'intervient dans un audit.

Qui peut le faire : tout membre du projet consulte les audits. L'Opérateur, le Responsable et l'Administrateur lancent un audit et qualifient les constats. L'ouverture d'une issue GitHub depuis un constat est réservée au Responsable et à l'Administrateur, avec une vérification récente.

Deux familles de contrôles#

FamilleContrôleCe qui est examiné
Statique (toujours)Signaux de secretsClés, jetons et mots de passe dans les fichiers texte lus ; fichiers sensibles versionnés
Statique (toujours)Accessibilité HTML statiqueLangue déclarée du document et texte alternatif des images, dans les fichiers HTML du dépôt
Statique (toujours)DépendancesPrésence d'un fichier de verrouillage npm ; alertes Dependabot ouvertes, si le dépôt les autorise
Dynamique (sur demande)Accessibilité des pages rendues (a11y_pages)Pages de votre environnement de recette, chargées dans un navigateur et analysées avec axe
Dynamique (sur demande)Balayage actif ZAP (active_scan)Exploration et tests actifs de l'environnement de recette avec ZAP

Les contrôles statiques lisent le code sur GitHub, au commit de la branche par défaut retenu au lancement. Les contrôles dynamiques visent uniquement l'origine HTTPS couverte par un accord de recette en cours.

Lecture seule#

  • L'audit ne crée ni branche, ni commit, ni PR.
  • La lecture statique porte sur 32 fichiers texte au plus, de 32 000 octets chacun.
  • Un audit conserve 100 constats au plus ; au-delà, il est marqué Partiel.
  • Les contrôles dynamiques s'exécutent dans des conteneurs isolés, séparés de la plateforme, et respectent un budget de requêtes.

La seule écriture possible est l'ouverture d'une issue GitHub depuis un constat statique validé, sur décision explicite d'un Responsable. Voir Ouvrir une issue depuis un constat.

Ce qui n'est jamais conservé#

  • La valeur d'un secret détecté : seuls la règle et un emplacement sûr sont gardés. L'emplacement d'un secret ou d'un fichier sensible n'est jamais reproduit dans le rapport.
  • Le contenu brut des fichiers lus.
  • Les URL, chemins et jetons des contrôles dynamiques dans le journal des actions.
  • Les constats d'un contrôle dynamique arrêté parce que l'accord ou vos droits ont changé.

Limites à connaître#

Le contrôle Accessibilité HTML statique mesure un échantillon de code source. Il ne remplace pas une recette d'accessibilité des pages rendues. Pour cela, utilisez le contrôle dynamique Accessibilité des pages rendues.

Une analyse d'accessibilité d'une capture HTML hors réseau existe aussi : c'est un outil en ligne de commande pour l'exploitant, sans écran dans la plateforme et sans résultat enregistré dans un audit.

Le parcours type#

  1. Lancer l'audit depuis la page Audits du projet.
  2. Lire les contrôles et leur couverture.
  3. Qualifier chaque constat : Valider ou Rejeter.
  4. Ouvrir le rapport final et générer son édition PDF.
  5. Si besoin, ouvrir une issue GitHub depuis un constat validé.

Les audits sont aussi disponibles par l'API (scopes audits:read et audits:create). Voir Intégration API et Ressources pour agents IA. La qualification n'est pas disponible par l'API.

Pour continuer#

Prérequis et lancement