---
title: Prérequis et lancement
description: Préparer un dépôt pour l'audit, lancer l'audit depuis la page Audits et comprendre les refus de lancement.
---

# Prérequis et lancement

La page **Audits** d'un projet lance un audit sur un dépôt et liste les audits passés. Elle indique aussi ce qu'il manque quand un audit ne peut pas démarrer.

**Qui peut le faire** : l'Opérateur, le Responsable et l'Administrateur lancent un audit. Le Lecteur ne voit que la carte **Historique des audits**. Aucune vérification récente n'est demandée.

## Ouvrir la page Audits

1. Ouvrez le projet depuis **Projets**.
2. Dans la barre **Espace projet**, cliquez sur **Audits**.

La page s'affiche à l'adresse `/projects/<projectId>/audits`.

## Prérequis

| Niveau | Prérequis | Qui le règle |
| --- | --- | --- |
| Instance | Audits de dépôt activés | L'exploitant |
| Instance | GitHub App configurée | L'exploitant |
| Dépôt | Dépôt actif : case **Autoriser les travaux sur ce dépôt** cochée | Le Responsable, voir [Rattacher un dépôt](../02-projets-et-depots/03-rattacher-un-depot.md) |
| Dépôt | Dépôt rattaché : **Vérifier et rattacher** | L'Administrateur, voir [Lier le dépôt à la GitHub App](../02-projets-et-depots/04-liaison-github-app.md) |

Un dépôt nouvellement déclaré démarre à l'arrêt : pensez à cocher **Autoriser les travaux sur ce dépôt** puis à enregistrer.

La surveillance des issues n'est pas nécessaire pour un audit statique. Elle l'est pour les contrôles dynamiques, qui demandent aussi un accord de recette.

## Ce que la page affiche quand il manque quelque chose

La carte **Audit du dépôt** ne masque plus le formulaire sans explication. Elle affiche :

- **Audits désactivés sur cette instance** : l'exploitant doit activer les audits pour le web et le worker, puis redéployer ;
- **GitHub App non configurée** : l'exploitant doit renseigner les identifiants de la GitHub App ;
- **Dépôts à préparer avant l'audit** : chaque dépôt bloqué, avec un lien vers sa fiche et la consigne (« arrêté : cocher « Autoriser les travaux sur ce dépôt » dans sa fiche » ou « non rattaché : cliquer sur « Vérifier et rattacher » dans sa fiche ») ;
- **Aucun dépôt dans ce projet** : déclarez un dépôt depuis la page du projet, puis rattachez-le.

## Lancer un audit, pas à pas

1. Dans la carte **Audit du dépôt**, choisissez le **Dépôt à auditer**. Seuls les dépôts prêts sont proposés.
2. Pour un audit statique seul, ne cochez rien d'autre.
3. Pour ajouter des contrôles dynamiques, cochez dans **Contrôles sur la recette autorisée** les contrôles voulus et renseignez leur **Budget de requêtes** (voir [Contrôles dynamiques](07-controles-dynamiques.md)).
4. Cliquez sur **Lancer l'audit**.
5. La page du dossier d'audit s'ouvre. Son badge passe de **En file** à **En cours**, puis à **Terminé** ou **Partiel**.

Pendant un [arrêt global](../06-administration-et-supervision/09-arret-global.md), l'audit est accepté et reste **En file** : le dossier affiche l'encadré **En attente de la levée de l'arrêt global**, et l'audit démarre une seule fois après la levée. Les contrôles dynamiques demandés sont acceptés si l'accord les couvre ; l'accord est relu avant l'envoi.

Sur le dossier, le bouton **Actualiser** recharge l'état tant que l'audit ou ses contrôles dynamiques sont en cours.

## Historique des audits

La carte **Historique des audits** liste les audits du projet : dépôt, date et état, 30 par page. Le lien **Audits suivants** affiche la suite.

## Refus courants

Les refus de lancement portent un code stable, le même dans l'interface et dans l'API :

| Code | Message affiché | Que faire |
| --- | --- | --- |
| `repository_audits_disabled` (503) | « Audits de dépôt désactivés sur cette instance : définir MVP_REPOSITORY_AUDITS_ENABLED=true pour le web et le worker (variable de la ressource Coolify), puis redéployer. » | Transmettre à l'exploitant |
| `repository_stopped` (409) | « Dépôt arrêté : cocher « Autoriser les travaux sur ce dépôt » dans sa fiche, puis enregistrer. » | Activer le dépôt |
| `repository_not_bound` (409) | « Dépôt non rattaché à la GitHub App : ouvrir sa fiche et cliquer sur « Vérifier et rattacher ». » | Demander le rattachement à l'Administrateur |

Autres messages possibles :

| Message | Cause |
| --- | --- |
| « Aucun accord actuel ne couvre ces contrôles dynamiques et leur budget. » | Contrôle dynamique demandé sans accord compatible |
| « Audit indisponible ou accès refusé. » | Rôle insuffisant ou projet hors de votre périmètre |
| « Service temporairement indisponible. » | Réessayer plus tard |

L'API utilise les mêmes codes : voir [Erreurs de l'API](../07-integration-api/05-erreurs.md).

## Pour continuer

[Lire un audit](03-lire-un-audit.md)
