---
title: Vue d'ensemble des audits
description: Ce que contrôle un audit de dépôt, en lecture seule et sans IA, et ce qui n'est jamais conservé.
---

# 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

| Famille | Contrôle | Ce qui est examiné |
| --- | --- | --- |
| Statique (toujours) | **Signaux de secrets** | Clés, jetons et mots de passe dans les fichiers texte lus ; fichiers sensibles versionnés |
| Statique (toujours) | **Accessibilité HTML statique** | Langue déclarée du document et texte alternatif des images, dans les fichiers HTML du dépôt |
| Statique (toujours) | **Dépendances** | Pré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](06-accord-de-recette.md) 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](05-ouvrir-une-issue-depuis-un-constat.md).

## 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.

> [!NOTE]
> Les audits de dépôt, l'ouverture d'issues et les contrôles dynamiques sont à activer par l'exploitant. Voir [GitHub App et interrupteurs](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md).

## 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](../07-integration-api/01-vue-d-ensemble.md) et [Ressources pour agents IA](../07-integration-api/07-agent-ia.md). La qualification n'est pas disponible par l'API.

## Pour continuer

[Prérequis et lancement](02-prerequis-et-lancement.md)
