Aller au contenu

Pentests DAST avec ZAP (Zed Attack Proxy) en CI/CD

Nous avons vu précédemment des outils pour analyser ton code, tes dépendances et image docker, mais de façon statique appelé SAST.

Ici je te propose plonger dans le monde du DAST, AKA l'analyse cette fois-ci dîtes dynamique.

Avoir un système qui tourne chaque nuit, analyse ton application avec des tests d'intrusions qui analyses ton API et tes endpoints d'accès à tes autres micro-services, database, etc, et qui en modifie dynamiquement les paramètres, attribut et contenu, te permet d'avoir encore plus de retour sur la sécurité de ton système.

Cela va aller du simple bruteforce par des patterns communs, en allant avec tout type d'injections, etc.

Combiner un tel système avec des daily report et un système de monitoring & d'alerting avec Grafana, Datadog ou PagerDuty te permet d'avoir une vision intégrale à un instant T de l'ensemble des CVE que tu pourrais rencontrer.

ZAP (Zed Attack Proxy)

Info

Longtemps connu sous le nom d'OWASP ZAP, le projet a quitté l'OWASP et s'appelle aujourd'hui ZAP by Checkmarx. L'outil, ses scripts et ses images Docker restent open source.

C'est un outils écrit en java open source très connu et très activement maintenu, qui te permet plusieurs choses :

  • Découverte de ton API/endpoint, de ton application web avec des systèmes de spider et crawler. Ce sont des sortes de bot qui vont se promener tout seul sur ton site pour en découvrir toute les pages
  • Test d'intrusions statique
  • Test d'intrusions dynamique

En fin d'analyse, il te dévoile un rapport avec l'ensemble des vulnérabilités qu'il aura rencontre sur ton application. Il les classes selon la criticité de la faille détecté, et te donnes des conseils pour comment les fixer.

Extension par marketplace

Etant open source, il existe une multitude d'extensions intéréssante. Tu peux retrouver des rules supplémentaires d'attaques pour améliorer l'éfficacité du tool, avoir des outputs de resultats de tes tests sous divers formats, et bien d'autres.

Tips - Script

Zap Proxy te permet de coder sous divers language (Javascript, Zest, Groovy, Kotlin, Python avec Jython engine, Ruby), des scripts variés te permettant de réaliser toute sorte de tâche pour des uses cases spécifique que tu aurais besoin et d'améliorer dynamiquement ses utilités :

  • Authentification : réaliser des authentication complexe
  • Http Sender : script appelé à chaque requête/réponse
  • Session management : gère comment les sessions sont maintenu dans ton app
  • Stand alone : appelé manuellement par ta main
  • Targeted : comme le Stand Alone, mais avec une target bien spécifique
  • Et bien d'autres 🔥

Tips - Authentification

Authentification simple

Afin que Zap proxy analyse et test ton site dans sa globalité, il est nécessaire si tu as une partie avec de l'authentification, par exemple un site web de vente en ligne, de lui fournir les instructions pour être loggé comme un vrai utilisateur.

Pour cela tu peux très bien lui indiqué une simple page de connexion, avec un username/password traditionnel à remplir avec un sytème de bouton basique. Tu devras lui fournir aussi un système lui permettant de se rendre compte si il a bien réussi son authentification (ex, accès à une page spécifique à un compte utilisateur).

Authentification complexe

Il fonctionne notemment avec les sites web moderne à base d'OIDC (OpenID Connect), OAuth ou encore Kong, qui se base sur une authentification avec un serveur spécifique, des redirections spécifiques, peut être même avec des sytemes de token, bearer token, JWT, etc. Pour réaliser ce genre d'authentification complexe, tu devras utiliser un script spécifique selon ton type d'authent recherché, vu dans la section plus haut. Je détaille ces cas dans l'authentification JWT, OIDC, OAuth et Kong avec ZAP.

Exemple

Fonctionnement basique

Si tu souhaites juste faire une première utilisation pour voir comment il fonctionne, tu peux te baser sur les scripts built-in :

  • zap-api-scan.py
  • zap-baseline.py
  • zap-full-scan.py

Script built-in avec app en ligne

Je te montre ici comment industrialiser le process en CI/CD, si tu souhaites tester une application web qui tourne déjà sur ton serveur.

Comme pour les autres tests de la catégorie Nightly, le scan ne tourne que dans un pipeline planifié, grâce à la règle if: $CI_PIPELINE_SOURCE == "schedule". Pour créer la planification, va dans le menu Build > Pipeline schedules de ton projet GitLab, clique sur New schedule et renseigne une expression cron, par exemple 0 2 * * * pour un lancement chaque nuit à 2 h.

Un scan actif est une attaque

zap-full-scan.py lance un scan actif : ZAP attaque réellement la cible (injections, fuzzing de paramètres...). Ne lance un scan actif que sur une cible dont tu as l'autorisation écrite. Ici, DAST_TARGET_URL est une variable CI/CD qui pointe sur ta propre app de test (staging, review app...). Si tu veux seulement un scan passif, sans attaque, utilise zap-baseline.py.

owasp_zap_scan:
  stage: nightly
  image: zaproxy/zap-stable:2.17.0
  allow_failure: true # zap-*-scan.py sort en code 2 dès qu'une alerte WARN est levée
  rules:
    - if: $CI_PIPELINE_SOURCE == "schedule"
  before_script:
    - mkdir -p /zap/wrk
  script:
    - /zap/zap-full-scan.py -t "$DAST_TARGET_URL" -r htmlreport.html
  after_script:
    # GitLab n'uploade que les artifacts situés dans le répertoire du projet
    - cp /zap/wrk/htmlreport.html "$CI_PROJECT_DIR/"
  artifacts:
    when: always
    paths:
      - htmlreport.html

Script built-in avec app en local

Si tu souhaites à l'inverse tester une application en localhost avant de la pousser en ligne afin de t'assurer que l'application soit dépourvue de CVE, tu peux la lancer depuis ta pipeline avec les Gitlab Services.

owasp_zap_scan:
  stage: nightly
  image: zaproxy/zap-stable:2.17.0
  allow_failure: true
  rules:
    - if: $CI_PIPELINE_SOURCE == "schedule"
  before_script:
    - mkdir -p /zap/wrk
  services:
    - name: $mon_registry:$mon_tag
      alias: mon-app
  script:
    - /zap/zap-full-scan.py -t "http://mon-app:mon-port" -r htmlreport.html
  after_script:
    - cp /zap/wrk/htmlreport.html "$CI_PROJECT_DIR/"
  artifacts:
    when: always
    paths:
      - htmlreport.html

Dans le cas ou tu utilises un registry privé, tu dois gérer ton docker login pour pouvoir pull ton image sans soucis.

Je te donne ici un exemple de configuration si tu gères tes propres Gitlab runners en self-hosted, te permette de gérer cet authentification.

Ici je te montre pour accéder au registry de Docker.io :

[[runners]]
  executor = "docker"
  environment = ["DOCKER_AUTH_CONFIG={\"auths\":{\"https://index.docker.io/v1/\":{\"auth\":\"base_64\"}}}"]

A toi de remplacer la partie base_64 par l'output de la commande suivante :

echo -n "username:password" | base64

Note

Dans le cas où tu n'as pas accès à la configuration de tes runners, définis DOCKER_AUTH_CONFIG en variable CI/CD (au niveau du projet ou du groupe), avec la même valeur JSON. Ne la définis pas dans un before_script : le runner pull l'image du job et les services avant d'exécuter le moindre script, ce serait donc trop tard.

Fonctionnement avec authentification complexe

Pour réaliser ton pentest, tu vas devoir comprendre comment le mettre en place.

Tu dois d'abord lancer le Daemon de ZAP. C'est un simple serveur qui va tourner et attendre des instructions. Pour cela, à partir de l'image officielle de ZAP, lance-le en mode headless avec zap.sh -daemon -host 0.0.0.0 -port 8080 -config api.key=$ZAP_API_KEY. L'option -daemon démarre ZAP sans UI, ce qui est exactement ce qu'on veut en CI/CD.

Une fois le daemon lancé, tu peux interagir avec ce serveur avec des scripts en Python en utilisant le SDK de ZAP via son package PyPi. Libre à toi de faire ton propre utilisation custom (Chose que j'avais réalisé chez Thales histoire d'avoir quelque chose qui fit 100% nos besoin en terme d'analyse). Par exemple :

  1. Attendre de façon scriptée le lancement du daemon ZAP (et donc d'éviter un sleep en dur)
  2. Lancer le spider simple
  3. Lancer le spider ajax
  4. Lancer le scan passif
  5. Lancer le scan actif
  6. Générer le rapport de résultat en HTML
  7. Shutdown le serveur

Le ZAP Automation Framework

Aujourd'hui, plutôt que de scripter toutes ces étapes à la main avec le SDK Python, je te conseille le ZAP Automation Framework : tu décris ton scan dans un plan YAML, et ZAP l'exécute de bout en bout, sans daemon à piloter.

# zap-plan.yaml

env:
  contexts:
    - name: mon-app
      urls:
        - ${DAST_TARGET_URL}
  parameters:
    failOnError: true
    progressToStdout: true

jobs:
  - type: spider
    parameters:
      maxDuration: 5             # en minutes
  - type: spiderAjax             # plus lent, mais indispensable pour une SPA
    parameters:
      maxDuration: 5
  - type: passiveScan-wait
  - type: activeScan             # attaque réellement la cible, cf. l'encadré plus haut
    parameters:
      maxScanDurationInMins: 30
  - type: report
    parameters:
      template: traditional-html
      reportDir: /zap/wrk
      reportFile: zap-report

Tu le lances depuis l'image zaproxy/zap-stable:2.17.0 avec zap.sh -cmd -autorun /zap/wrk/zap-plan.yaml. ZAP remplace ${DAST_TARGET_URL} par la variable d'environnement du même nom, enchaîne les jobs dans l'ordre et écrit le rapport /zap/wrk/zap-report.html.

Pour l'authentification, chaque contexte du plan accepte un bloc authentication (méthodes form, json, script...) et une liste de users, que tu passes ensuite aux jobs avec leur paramètre user. Pour voir toutes les options disponibles, génère un plan commenté avec zap.sh -cmd -autogenmax /zap/wrk/plan-complet.yaml. Et pour les cas les plus tordus (OIDC, JWT, Kong), je détaille les scripts d'authentification dans l'authentification JWT, OIDC, OAuth et Kong avec ZAP.

Pour aller plus loin