Autorisation et périmètre
En une phraseLe scan actif envoie de vraies attaques : sans mandat écrit, c'est une intrusion.
ZAP fait deux choses très différentes. Il observe le trafic, sans risque. Et il attaque : il rejoue des requêtes modifiées pour déclencher des failles. La seconde peut créer des comptes, envoyer des courriels, modifier des données, saturer un service. On ne la lance que sur ce qu'on a le droit de casser.
Un document signé qui nomme : les domaines et adresses exactes dans le périmètre, ceux qui en sont exclus, la fenêtre horaire, l'intensité acceptée, un contact technique joignable pendant le test, et la conduite à tenir en cas d'incident. Un scan lancé « pour voir » sur une cible de production sans ce cadre vous expose personnellement.
Testez d'abord hors production
Un environnement de recette, une copie, une application volontairement vulnérable (OWASP Juice Shop, DVWA) pour régler votre configuration avant de toucher la vraie cible.
Gardez la preuve de ce que vous avez fait
ZAP enregistre toutes les requêtes dans sa session. Conservez-la, horodatée : elle prouve le périmètre réellement testé et sert de journal en cas de litige.
Installer et tenir à jour
En une phraseVersion stable 2.17, Java 17 au minimum, et les add-ons à jour depuis la place de marché.
ZAP 2.17 relève son socle à Java 17 et branche ses règles sur les catégories de l'OWASP Top 10:2025. Toutes les fonctions récentes d'authentification et d'automatisation vivent dans des add-ons mis à jour chaque mois : un ZAP « à jour » dont les add-ons datent passe à côté de l'essentiel.
# Java 17+ exigé par ZAP 2.17
java -version
# Lancement graphique classique
zap.sh # Linux / macOS
zap.bat # Windows
# Mode "daemon" sans interface, piloté par l'API (port 8090)
zap.sh -daemon -port 8090 -config api.key=VOTRE_CLE
# Image stable, tout inclus
docker pull zaproxy/zap-stable
# Les scripts packagés : point d'entrée le plus simple
docker run -t zaproxy/zap-stable zap-baseline.py -t https://cible-autorisee.example
docker run -t zaproxy/zap-stable zap-full-scan.py -t https://cible-autorisee.example
docker run -t zaproxy/zap-stable zap-api-scan.py -t https://cible/openapi.json -f openapi
Lancez la mise à jour des add-ons en ligne de commande avant un audit : zap.sh -cmd -addonupdate. Et pour rejouer un audit à l'identique dans six mois, notez la version de ZAP et celle de chaque add-on (visible dans « Gérer les add-ons ») dans votre rapport. Un résultat qui change entre deux scans vient souvent d'une règle mise à jour, pas de l'application.
Les add-ons utiles, et ce que chacun apporte
| Add-on | Ce qu'il permet | Ce que ça ajoute |
|---|---|---|
| Automation Framework | Décrire tout l'audit dans un fichier YAML | Rejouer l'audit à l'identique, du poste au pipeline |
| Authentication Helper | Détecter et configurer la connexion | Auth navigateur, Testeur et Rapport d'authentification |
| Ajax Spider | Explorer dans un vrai navigateur | Couvre les applications à page unique (React, Vue, Angular) invisibles au spider classique |
| Active & Passive scan rules | Le moteur de détection | Les paquets beta et alpha ajoutent des règles au-delà du socle « release » |
| Alert Filters | Reclasser ou masquer une alerte précise | Gérer les faux positifs nommément, directement dans le plan |
| Replacer | Modifier les requêtes à la volée | Retirer un cookie, changer un rôle, injecter un en-tête |
| Forced Browse | Deviner fichiers et répertoires | Trouve l'exposé non lié : sauvegardes, pages d'admin, fichiers oubliés |
| OpenAPI / GraphQL / SOAP | Importer la définition d'API | Crée d'un coup tous les points d'entrée avec leurs paramètres |
| Access Control Testing | Comparer l'accès utilisateur par utilisateur | Révèle ce qu'un compte, ou un anonyme, atteint sans y avoir droit |
| Token Generation and Analysis | Générer et analyser un lot de jetons | Mesure l'entropie du jeton de session |
| JWT (SasanLabs) | Scanner et fuzzer les jetons JWT | Algorithme « none », confusion d'algorithme, secret faible |
Contexte et modes
En une phraseLe contexte définit le périmètre technique ; le mode empêche ZAP de tirer en dehors.
Un contexte est la fiche de la cible : les URL incluses, celles exclues, l'authentification, les utilisateurs, la gestion de session. Tout le reste s'appuie dessus. Deux minutes de contexte propre évitent des heures d'analyse d'un scan qui a débordé sur un sous-domaine tiers ou s'est déconnecté à chaque requête.
Les quatre modes, du plus sûr au plus large
| Mode | Ce qu'il autorise | Quand |
|---|---|---|
| Safe | Aucune action intrusive, même déclenchée à la main | Découverte, démonstration, formation |
| Protected | Les attaques ne sont permises que sur les URL dans un contexte | Réglage par défaut d'un audit sérieux |
| Standard | Tout est permis partout | Jamais sur une cible mal délimitée |
| ATTACK | Scanne automatiquement tout nouveau nœud d'un contexte | Usage expert, périmètre verrouillé |
Travaillez en mode Protected avec un contexte bien borné. ZAP refusera alors d'attaquer une URL hors périmètre, même par erreur de clic. C'est votre garde-fou technique, en plus du mandat.
# Inclure l'application cible
https://app.cible-autorisee\.example/.*
# Exclure ce qui détruit la session ou sort du périmètre
https://app.cible-autorisee\.example/.*logout.*
https://app.cible-autorisee\.example/.*(supprimer|delete|purge).*
https://.*\.google(apis)?\.com/.*
La première URL que ZAP suivra pendant l'exploration est souvent le lien « Déconnexion ». Il perd alors sa session et scanne toute l'application en visiteur anonyme, sans le voir. Excluez les URL de déconnexion du contexte avant toute chose.
Cartographier la cible
En une phraseOn ne teste bien que ce qu'on a vu : l'exploration conditionne toute la suite.
ZAP ne peut attaquer que les URL qu'il connaît. Trois explorateurs se complètent, selon la façon dont l'application est construite.
Le Spider classique
Suit les liens du HTML. Rapide, mais aveugle à ce que le JavaScript construit après le chargement. Suffisant pour un site de pages servies par le serveur.
L'AJAX Spider
Pilote un vrai navigateur et clique dans la page. Indispensable pour une application à une seule page (React, Vue, Angular) où les routes n'existent qu'une fois le code exécuté. Plus lent, à cadrer dans le temps.
Le moyen le plus fiable reste l'exploration manuelle : naviguez dans l'application via le proxy ZAP, en utilisant chaque fonction comme un vrai utilisateur. ZAP enregistre tout. Pour les parcours clés (paiement, création de dossier), c'est la seule méthode qui garantit que les bonnes requêtes sont dans l'arbre avant le scan.
Importer la structure plutôt que la deviner
Si l'application expose une description, ne laissez pas ZAP deviner : importez-la. ZAP lit les définitions OpenAPI, GraphQL et SOAP, et crée directement tous les points d'entrée avec leurs paramètres. C'est à la fois plus complet et plus rapide que l'exploration.
# Depuis une définition OpenAPI / Swagger
zap.sh -cmd -openapifile ./openapi.json -openapitargeturl https://api.cible/
# GraphQL et SOAP disposent de leurs propres add-ons d'import
Le scan passif
En une phraseIl lit tout le trafic sans jamais rien envoyer de plus : sans risque, toujours actif.
Pendant que vous explorez, le scan passif analyse chaque réponse et lève des alertes sans toucher à l'application : en-têtes de sécurité manquants, cookies mal réglés, fuites d'information, bibliothèques datées, contenus mixtes. C'est gratuit en risque, et souvent la moitié des constats d'un rapport. Laissez-le finir avant de passer à l'actif.
Dans un plan automatisé, intercalez toujours un temps d'attente du scan passif (passiveScan-wait) entre l'exploration et le scan actif, puis à nouveau avant le rapport. Sinon le rapport part avant que toutes les alertes passives soient calculées, et il est incomplet.
L'authentification
En une phraseC'est le point qui fait échouer la plupart des audits ZAP : si ZAP n'est pas connecté, il ne teste que la façade.
Pour configurer l'authentification, il faut répondre à trois questions sur l'application : comment on se connecte, comment la session est maintenue, et comment savoir si une requête est authentifiée. ZAP sait de mieux en mieux y répondre seul, mais vous devez comprendre les trois.
Les quatre méthodes
| Méthode | Principe | Pour quelle application |
|---|---|---|
| Authentification navigateur | ZAP ouvre un vrai navigateur et remplit le formulaire de connexion comme un utilisateur | Le choix par défaut aujourd'hui, y compris pour beaucoup d'applications modernes |
| Script client (Zest) | Un script côté navigateur, enregistré puis rejoué, pour les connexions complexes | Parcours à plusieurs étapes, écrans de consentement, flux inhabituels |
| Auto-détection | Une règle passive repère la connexion et configure l'authentification seule | Première approche rapide, à vérifier ensuite |
| Certificat client | Authentification par certificat TLS | Applications internes à authentification mutuelle |
La bonne pratique : l'authentification navigateur
Longtemps on bricolait une authentification « par formulaire » en désignant à la main les champs et l'URL de soumission. L'approche recommandée aujourd'hui est l'authentification navigateur : vous donnez l'URL de connexion et des identifiants valides, et ZAP remplit le formulaire dans un vrai navigateur. Il gère les champs chargés par JavaScript, le TOTP, et des étapes manuelles définies quand le parcours est inhabituel.
Comprendre d'abord l'application à la mainavant toute configuration
Connectez-vous dans un navigateur, outils de développement ouverts. Repérez la requête de connexion, où atterrit le jeton de session (cookie ? en-tête ?), et une URL qui ne répond que connecté. Sans ces trois réponses, aucune configuration ne tiendra.
Lancer le Testeur d'authentificationAuth Helper
Le Testeur d'authentification prend l'URL de connexion et les identifiants, tente la connexion dans un navigateur visible, et vous dit ce qu'il a trouvé : champ identifiant, champ mot de passe, méthode de session, URL de vérification. On règle ici, pas pendant le scan.
Fixer la gestion de sessioncookie ou en-tête
Session par cookie : ZAP la maintient automatiquement via l'authentification navigateur, cookies de connexion inclus. Session par en-tête (jeton porteur) : la gestion par en-tête prend en charge autant d'en-têtes que nécessaire.
Choisir la stratégie de vérificationle point le plus négligé
ZAP doit savoir, à chaque requête, s'il est encore connecté. L'auto-détection trouve souvent une URL de contrôle. Sinon, désignez une URL qui ne répond qu'en session, avec un marqueur de connexion et un marqueur de déconnexion. Sans cela, ZAP se croit connecté alors qu'il ne l'est plus, et le scan ne vaut rien.
Relire le Rapport d'authentificationcaptures et diagnostics
Le Rapport d'authentification montre, captures d'écran à l'appui, ce que ZAP a vu à chaque étape et où il a échoué. C'est le premier endroit à regarder quand « ça ne se connecte pas ».
Quand le jeton ou la vérification passe par un autre domaine que l'application (un api.domaine ou auth.domaine séparé), ce domaine doit être inclus dans le contexte. Sinon ZAP n'envoie pas le cookie d'authentification vers l'URL de vérification, et se croit déconnecté. C'est la cause numéro un des échecs d'authentification en mode automatisé.
Cookies et session
En une phraseLe cookie de session est la clé du compte : ses attributs et sa robustesse sont un test à part entière.
Une fois ZAP connecté, la session elle-même devient une cible. Trois questions, trois familles de tests.
1. Les attributs du cookie
Le scan passif les relève sans rien envoyer. Pour un cookie de session, on attend :
| Attribut | Ce qu'il protège | Attendu |
|---|---|---|
| Secure | Le cookie n'est envoyé qu'en HTTPS | Présent, toujours |
| HttpOnly | Le JavaScript ne peut pas lire le cookie, ce qui limite le vol par XSS | Présent pour un cookie de session |
| SameSite | Limite l'envoi du cookie depuis un autre site, ce qui gêne le CSRF | Lax ou Strict selon l'usage |
| Domaine et portée | Évite de diffuser le cookie à des sous-domaines inutiles | Le plus étroit possible |
2. La fixation de session
Le test : l'identifiant de session change-t-il à la connexion ? Notez le cookie avant de vous authentifier, connectez-vous, comparez. S'il est identique, un attaquant qui a imposé un identifiant avant la connexion garde la main après. ZAP aide à le voir, mais la vérification manuelle est la plus sûre.
3. La solidité de l'identifiant et l'expiration
L'identifiant de session est-il assez long et imprévisible ? L'outil de comparaison de jetons de ZAP (« Token Generation ») collecte un grand nombre d'identifiants et mesure leur variabilité. Vérifiez aussi qu'une session expire côté serveur après déconnexion et après un délai d'inactivité : un cookie supprimé côté navigateur mais toujours valide côté serveur reste exploitable.
Le Requester et l'outil de rejeu de ZAP permettent de renvoyer une requête en modifiant un seul élément : retirer le cookie, en changer un octet, réutiliser une session fermée. C'est ainsi qu'on démontre une faille de session, pas en lisant une alerte automatique.
Attaquer l'authentification et le jeton
En une phraseAprès avoir appris à ZAP à se connecter, on retourne l'arme contre la connexion : peut-on la forcer, la contourner, ou prédire le jeton ?
C'est un test à part entière, et souvent le plus parlant d'un rapport. Il se mène en trois temps : la robustesse du mécanisme de connexion, la solidité du jeton de session, et le cas particulier des jetons JWT.
A. La robustesse de l'authentification
| Test | Ce qu'on cherche | Avec quoi |
|---|---|---|
| Transport | Identifiants envoyés uniquement en HTTPS, jamais dans l'URL ni en GET | Scan passif |
| Énumération de comptes | Réponse différente selon que l'identifiant existe ou non (message, code, temps) | Règle « Possible Username Enumeration » et vérification manuelle |
| Force brute et bourrage | Absence de verrouillage, de temporisation ou de captcha après plusieurs échecs | Le Fuzzer de ZAP avec une liste de mots de passe |
| Politique et autocomplétion | Mots de passe faibles acceptés, champ mot de passe en autocomplétion | Scan passif et test manuel |
| Anti-CSRF | Jeton anti-CSRF sur le formulaire de connexion et les actions sensibles | Scan passif et actif |
| Messages d'erreur | Erreurs qui révèlent quel champ est faux, ou des traces techniques | Scan passif, lecture des réponses |
| Réinitialisation du mot de passe | Jeton de réinitialisation prévisible, injection d'en-tête Host, lien qui n'expire pas | Analyse de jetons et test manuel |
Capturer la requête de connexionune requête POST
Depuis l'historique, repérez la requête d'envoi du formulaire. Clic droit, puis « Attaquer, Fuzz ».
Marquer le champ à faire varierle mot de passe
Sélectionnez la valeur du mot de passe dans la requête et ajoutez-la comme emplacement de fuzzing.
Charger une liste de valeurspayloads
Un fichier de mots de passe courants suffit pour le test. L'objectif n'est pas de deviner le mot de passe, mais de voir si l'application réagit.
Lancer et triercode et taille de réponse
Triez les réponses par code HTTP et par taille. Une réponse qui se démarque signale soit une connexion réussie, soit un message d'erreur distinct qui trahit un compte existant.
Conclure sur la défenseverrouillage ?
Si les cent tentatives passent sans verrouillage ni ralentissement, l'application est vulnérable au bourrage d'identifiants. C'est le constat.
B. La solidité du jeton de session
Le jeton de session vaut le mot de passe : qui le devine ou le vole prend le compte. Quatre tests le couvrent.
L'entropie du jeton
L'add-on Token Generation and Analysis génère un grand nombre de jetons et mesure leur variabilité, position par position. Un jeton trop court, ou construit sur un compteur, apparaît prévisible. Attention : un jeton qui est le condensé d'un numéro croissant peut passer les tests statistiques tout en restant devinable — recoupez avec la logique de génération.
La fixation
Le jeton change-t-il à la connexion ? Notez-le avant de vous authentifier, connectez-vous, comparez. S'il est identique, un attaquant qui a imposé un jeton avant la connexion garde la main après.
L'invalidation
Après déconnexion, le jeton est-il refusé côté serveur, et pas seulement effacé du navigateur ? Y a-t-il une expiration d'inactivité et une expiration absolue ? Rejouez une requête avec un jeton fermé pour le vérifier.
La portée
Le cookie est-il limité au bon domaine et au bon chemin, en HTTPS, hors de portée du JavaScript ? Jeton jamais réécrit dans l'URL. C'est le scan passif qui le dit.
C. Le cas des jetons JWT
Si l'application porte sa session dans un JWT, l'add-on JWT ajoute une règle de scan actif et un fuzzer spécialisés. Pour fuzzer un JWT, il faut fournir à ZAP la clé de signature — secret HMAC ou clé privée RSA — car modifier le jeton oblige à le re-signer.
| Attaque testée | Ce qu'elle révèle |
|---|---|
| Algorithme « none » | Le serveur accepte un jeton non signé : la vérification peut être contournée entièrement |
| Confusion d'algorithme | Le serveur accepte un jeton signé avec un autre algorithme que prévu (par exemple HS256 au lieu de RS256) |
| Secret faible | Le secret de signature se retrouve par dictionnaire, ce qui permet de forger n'importe quel jeton |
| Expiration et revendications | Jeton sans expiration, expiration non vérifiée, ou données sensibles en clair dans la charge utile |
Le scan actif
En une phraseIl rejoue des requêtes modifiées pour provoquer les failles : puissant, intrusif, à doser.
Le scan actif est le cœur attaquant de ZAP. Il teste injection SQL, XSS, traversée de répertoire, injection de commande, désérialisation et le reste. Deux réglages gouvernent son comportement : la force d'attaque (combien de variantes il essaie) et le seuil d'alerte (à partir de quelle certitude il remonte un constat).
Les politiques et le ciblage par étiquettes
Plutôt que d'activer les centaines de règles d'un coup, construisez une politique de scan. ZAP permet désormais de composer une politique par étiquettes d'alerte : cibler les règles portant l'étiquette d'une catégorie de l'OWASP Top 10:2025, par exemple, sans gérer chaque règle à la main. Plus lisible, plus facile à maintenir dans un plan d'automatisation.
Monter la force avec discernement
Une force « Insane » multiplie les requêtes et le temps. Réservez-la à une cible hors production qui le supporte. En recette partagée ou proche de la production, restez en « Medium » et prévenez l'équipe.
Surveiller l'effet de bord
Le scan actif crée des données, envoie des formulaires, peut déclencher des courriels ou des alertes. Excluez les actions destructrices, coupez les intégrations sortantes en recette, et gardez un œil sur la charge pendant le scan.
Un portail de paiement, un fournisseur d'identité, une API externe : même atteints depuis l'application cible, ils sont hors de votre mandat. Excluez-les du contexte. Les attaquer, c'est attaquer quelqu'un qui ne vous a rien autorisé.
L'Automation Framework
En une phraseUn seul fichier YAML décrit tout l'audit et le rejoue à l'identique, du poste au CI.
C'est le cœur d'un usage professionnel de ZAP. L'Automation Framework enchaîne des jobs : définir le contexte et l'authentification, explorer, attendre le passif, scanner activement, produire le rapport. Le même fichier tourne sur votre poste, en Docker et dans un pipeline. Fini les configurations cliquées, impossibles à reproduire.
env:
contexts:
- name: cible
urls: ["https://app.cible-autorisee.example"]
includePaths: ["https://app.cible-autorisee.example/.*"]
excludePaths:
- "https://app.cible-autorisee.example/.*logout.*"
- "https://.*\.googleapis\.com/.*"
authentication:
method: "browser" # authentification navigateur
parameters:
loginPageUrl: "https://app.cible-autorisee.example/login"
loginPageWait: 5
browserId: "firefox-headless"
verification:
method: "autodetect" # laisse ZAP trouver l'URL de contrôle
sessionManagement:
method: "autodetect"
users:
- name: "testeur"
credentials:
username: "${ZAP_USER}" # injecté par variable, jamais en clair
password: "${ZAP_PASS}"
parameters:
failOnError: true
progressToStdout: true
jobs:
- type: passiveScan-config # règles passives actives dès le départ
parameters: { scanOnlyInScope: true }
- type: spider # exploration des liens
parameters: { context: "cible", user: "testeur", maxDuration: 10 }
- type: spiderAjax # exploration du JavaScript
parameters: { context: "cible", user: "testeur", maxDuration: 10 }
- type: passiveScan-wait # on attend la fin du passif
- type: activeScan # le scan intrusif, sur périmètre autorisé
parameters: { context: "cible", user: "testeur", policy: "Top10-2025" }
- type: passiveScan-wait
- type: report # rapport final
parameters:
template: "traditional-html-plus"
reportDir: "./rapports"
reportFile: "zap-{{yyyy-MM-dd}}"
# Sur le poste
zap.sh -cmd -autorun ./zap-plan.yaml
# En Docker, identifiants passés par l'environnement
docker run -t -v $(pwd):/zap/wrk/:rw \
-e ZAP_USER -e ZAP_PASS \
zaproxy/zap-stable zap.sh -cmd -autorun /zap/wrk/zap-plan.yaml
Configurez tout à la main dans ZAP Desktop, validez avec le Testeur d'authentification, puis exportez un plan d'automatisation. Vous repartez d'un YAML qui marche, au lieu de l'écrire de mémoire. ZAP peut aussi vérifier des statistiques de connexion dans le plan (nombre de contextes authentifiés) et échouer si l'authentification n'a pas pris.
Aller plus loin : compte de test, cookies, session et contrôle d'accès
Jusqu'ici, ZAP teste l'application une fois connecté. Le niveau au-dessus consiste à vérifier ce qui reste accessible sans le cookie, avec une session fermée, ou avec un compte qui ne devrait pas en avoir le droit. C'est le test du contrôle d'accès, la première catégorie de l'OWASP Top 10, et c'est entièrement scriptable.
1. Prouver que le compte de test s'est vraiment connecté
Le pire scénario d'un audit automatisé : ZAP scanne une heure en se croyant connecté, alors qu'il a perdu la session. Ajoutez un test qui fait échouer le plan si l'authentification n'a pas eu lieu.
- type: requestor
parameters: { user: "testeur" }
requests:
- url: "https://app.cible-autorisee.example/mon-compte"
name: "page réservée aux connectés"
tests:
- type: "stats"
statistic: "stats.auth.success" # nombre de connexions réussies
site: "https://app.cible-autorisee.example"
operator: ">="
value: 1
onFail: "error" # 0 connexion => le plan échoue
2. Rejouer une requête sensible, avec puis sans session
Le job requestor envoie une requête ciblée. L'idée : lancer la même requête deux fois, d'abord comme utilisateur de test, puis sans aucun utilisateur — donc sans cookie de session — et comparer les réponses.
# A) authentifié : doit renvoyer la donnée (200)
- type: requestor
parameters: { user: "testeur" }
requests:
- url: "https://app.cible-autorisee.example/api/factures/1042"
name: "facture 1042 - authentifié"
responseCode: 200 # code attendu ; ZAP signale un écart
# B) anonyme : DOIT être refusé (401 ou 403)
- type: requestor
requests:
- url: "https://app.cible-autorisee.example/api/factures/1042"
name: "facture 1042 - anonyme"
responseCode: 401 # si on obtient 200, l'accès est cassé
3. Retirer le cookie, ou endosser un autre rôle
Le job replacer modifie les requêtes à la volée. On s'en sert pour retirer l'en-tête du cookie de session sur les requêtes suivantes, ou pour remplacer un en-tête de rôle et jouer un utilisateur de rang inférieur.
- type: replacer
rules:
- description: "retirer le cookie de session"
matchType: "req_header" # agit sur un en-tête de requête
matchString: "Cookie"
replacementString: "" # vide => en-tête supprimé
tokenProcessing: false
4. Le contrôle d'accès complet, utilisateur par utilisateur
L'add-on Access Control Testing industrialise tout cela. Vous définissez, pour chaque utilisateur et pour l'utilisateur « non authentifié », quelles URL il a le droit d'atteindre ; ZAP rejoue tout l'arbre exploré sous chaque identité et liste les écarts entre le droit théorique et la réponse réelle.
| Identité | Règle déclarée | Ce que ZAP vérifie |
|---|---|---|
| Compte de test | Autorisé sur son espace, interdit sur l'administration | Qu'une page d'admin lui renvoie bien un refus |
| Compte de rang inférieur | Interdit sur les données d'un autre | Qu'il ne lise pas la facture d'un tiers |
| Non authentifié | Interdit sur tout le périmètre connecté | Qu'aucune page protégée ne réponde sans session |
accessControl) depuis un script ou le pipeline. Le reste du plan — connexion, exploration, requêtes rejouées — s'automatise, lui, entièrement en YAML.5. Deux explorateurs, et pourquoi l'un passe anonyme
Nuance d'expert à ne pas rater : avec l'authentification navigateur, le navigateur est déjà connecté au moment où il démarre. Le Spider classique envoie des requêtes directes que ZAP ré-authentifie à la volée ; l'AJAX Spider, lui, explore dans ce navigateur et est traité comme « déjà connecté ». Pour couvrir les deux points de vue, prévoyez un passage authentifié et un passage délibérément anonyme, puis comparez ce que chacun a atteint.
6. En intégration continue, l'action dédiée
Pour un scan authentifié non trivial, l'action GitHub « ZAP Automation Framework Scan » exécute votre plan complet — contexte, connexion, requêtes rejouées, scan — là où l'action baseline s'arrête au passif. C'est l'action recommandée dès que l'authentification entre en jeu.
- uses: zaproxy/action-full-scan@v0.12.0
with:
target: "https://recette.cible-autorisee.example"
env:
ZAP_USER: "${{ secrets.ZAP_USER }}" # jamais en clair dans le dépôt
ZAP_PASS: "${{ secrets.ZAP_PASS }}"
CI/CD et rapports
En une phraseIntégrer ZAP au pipeline a de la valeur à une condition : qu'il ne bloque pas sur des faux positifs.
ZAP fournit des actions GitHub et des images pensées pour le CI. Le piège est de câbler un scan qui échoue au moindre bruit : l'équipe le désactive en une semaine. La clé est de gérer les faux positifs proprement et de choisir ce qui fait vraiment échouer la construction.
Trois portes d'entrée selon le besoin
| Mécanisme | Usage | Intrusif |
|---|---|---|
| zap-baseline | Scan passif rapide à chaque construction : en-têtes, cookies, fuites | Non, sûr sur presque toute cible |
| zap-full-scan | Exploration plus scan actif, pour une recette dédiée | Oui, périmètre autorisé seulement |
| zap-api-scan | Scan guidé par une définition OpenAPI, GraphQL ou SOAP | Oui |
name: zap-baseline
on: [push]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: zaproxy/action-baseline@v0.14.0
with:
target: "https://recette.cible-autorisee.example"
rules_file_name: ".zap/rules.tsv" # faux positifs maîtrisés
fail_action: true
Maîtriser les faux positifs, sans fermer les yeux
Deux outils, deux niveaux. Le fichier de règles (rules.tsv) fixe, règle par règle, ce qui est ignoré, en avertissement ou bloquant. Les filtres d'alerte (Alert Filters) sont plus fins : ils rabaissent ou masquent une alerte précise sur une URL précise, et s'enregistrent dans le plan d'automatisation. La règle d'or : un faux positif se documente et se filtre nommément, jamais en coupant toute une famille de règles.
Les rapports
Pour l'humain
Le modèle HTML enrichi donne un rapport lisible, trié par risque, avec la preuve de chaque constat. C'est ce qui part au client.
Pour la machine
Les formats JSON, XML, SARIF et Markdown alimentent un tableau de bord, une forge ou un suivi de tickets. SARIF s'affiche directement dans l'onglet sécurité de GitHub.
ZAP sait désormais scanner un serveur MCP comme une cible à part entière, via une action dédiée, et piloter des scans navigateur OWASP PTK depuis le plan d'automatisation. Si vous exposez des agents IA ou des serveurs MCP, c'est une surface à inscrire au périmètre.
La checklist d'un audit propre
Avant
Mandat signé, périmètre et exclusions écrits, contact joignable, cible de préférence hors production, ZAP et add-ons à jour, versions notées.
Cadrer
Contexte créé, URL de déconnexion et domaines tiers exclus, mode Protected, authentification validée au Testeur, stratégie de vérification confirmée.
Explorer
Exploration manuelle des parcours clés, puis Spider et AJAX Spider, ou import de la définition d'API. Vérifier que les requêtes authentifiées sont bien dans l'arbre.
Analyser
Laisser finir le scan passif, lancer le scan actif avec une politique ciblée et une force adaptée à la cible, surveiller la charge et les effets de bord. Tester à part la connexion et le jeton : énumération, force brute sur compte de test, entropie et invalidation du jeton, et JWT le cas échéant.
Conclure
Trier les alertes, écarter les faux positifs en les documentant, démontrer les vraies failles par le rejeu, produire le rapport, archiver la session horodatée.
Questions fréquentes
Faut-il une autorisation pour scanner une application avec ZAP ?
Oui pour le scan actif, qui envoie de vraies attaques. Il faut un mandat écrit nommant les cibles, les exclusions, la fenêtre horaire et un contact. Le scan passif, lui, n'envoie rien de plus que votre navigation normale.
Quelle différence entre scan passif et scan actif ?
Le passif observe le trafic sans rien ajouter : sans risque, toujours actif. L'actif rejoue des requêtes modifiées pour provoquer des failles : intrusif, réservé au périmètre autorisé.
ZAP peut-il tester derrière une authentification ?
Oui. L'authentification navigateur remplit le formulaire comme un utilisateur, maintient la session et vérifie l'état connecté. Le Testeur d'authentification valide la configuration avant le scan, et le Rapport d'authentification montre où ça coince.
Pourquoi mon scan ne trouve rien derrière la connexion ?
Presque toujours parce que ZAP n'est pas resté connecté : URL de déconnexion suivie, domaine de vérification absent du contexte, ou stratégie de vérification mal réglée. Commencez par le Rapport d'authentification.
Pour aller plus loin
Test d'intrusion applicatif
Un audit mené sur votre périmètre, avec rapport priorisé et accompagnement des correctifs.
Réserver 30 minutesAttaques de la chaîne logicielle
Scanner ses dépendances avant qu'elles n'atteignent la production.
Lire le guide