Aller au contenu

Prompt IA · Pentest web

Prompt : plan de test d’une API depuis OpenAPI

Prompt qui construit un plan de test d’API depuis un extrait OpenAPI : endpoints par risque, matrice d’autorisations, tests par catégorie OWASP API Top 10.

Par Steven Carrier Publié le

Compatible avec : Claude, autres assistants conversationnels

Tu es auditeur en sécurité des API. Construis le plan de test de l'API décrite par l'extrait OpenAPI ci-dessous, aligné sur l'OWASP API Security Top 10 édition 2023.

Périmètre autorisé : {{perimetre}}
Rôles disponibles : {{roles}}
Contraintes de la mission : {{contraintes}}
Extrait de la description OpenAPI :
{{extrait_openapi}}

Produis :
1. un regroupement des endpoints par niveau de risque (élevé, moyen, faible), avec la raison : données sensibles, action de modification ou de suppression, objets identifiés par un identifiant, absence apparente d'authentification ;
2. une matrice d'autorisations sous forme de tableau (rôles en colonnes, endpoints et méthodes en lignes) où chaque case indique l'accès attendu d'après la description (autorisé, refusé, à vérifier) ;
3. pour chaque catégorie de l'édition 2023 (API1 Broken Object Level Authorization, API2 Broken Authentication, API3 Broken Object Property Level Authorization, API4 Unrestricted Resource Consumption, API5 Broken Function Level Authorization, API6 Unrestricted Access to Sensitive Business Flows, API7 Server Side Request Forgery, API8 Security Misconfiguration, API9 Improper Inventory Management, API10 Unsafe Consumption of APIs), les tests à mener sur les endpoints concernés, avec leur priorité ;
4. les tests à exclure ou à adapter à cause des contraintes ;
5. les points que la description ne permet pas de trancher et les questions à poser au client.

Précise que la matrice décrit un comportement attendu à vérifier, pas un comportement observé. Ne propose aucun test hors du périmètre indiqué et aucune charge utile d'exploitation.

Remplacez les variables surlignées avant usage.

Ce prompt transforme une description OpenAPI en trame de test : quels endpoints examiner en premier, qui doit pouvoir faire quoi, et quels tests mener pour chacune des dix catégories de l’OWASP API Security Top 10. Il accélère la préparation d’une mission sur une API volumineuse, en complément de la méthodologie de test d’API REST.

Remplir les variables

Variable Exemple
{{perimetre}} https://api.recette.example.org/v2, hors environnement de production
{{roles}} anonyme, utilisateur, gestionnaire, administrateur (un compte de test par rôle)
{{contraintes}} boîte grise, limite de 20 requêtes par seconde, pas de test de déni de service, création de données autorisée en recette
{{extrait_openapi}} les chemins, méthodes, paramètres, schémas et sections security utiles, en YAML ou JSON

Collez un extrait ciblé plutôt que toute la description : un fichier très long dépasse souvent la capacité utile du modèle. Retirez les URL internes, les exemples contenant de vraies données et les secrets.

Relire le résultat

  • Confrontez la matrice d’autorisations à ce que le client attend réellement : la description OpenAPI indique rarement qui a le droit de faire quoi, le modèle déduit une partie des cases.
  • Vérifiez que le résultat reprend bien les catégories de l’édition 2023 listées dans le prompt : un modèle mélange volontiers avec l’édition 2019, dont la numérotation diffère.
  • Écartez les tests qui s’appliquent à une fonction absente de l’API (téléversement, appels à des services tiers) et ajoutez ceux que l’extrait ne laisse pas voir.
  • Rappelez que la description peut être en retard sur l’API déployée : des endpoints non documentés relèvent de la catégorie API9 (Improper Inventory Management), à chercher par l’énumération.
  • Ne collez dans le prompt aucune information du client que votre convention ne vous autorise pas à partager avec un service d’IA ; anonymisez les noms de domaine, de champs métier et les exemples de données.

Sources

Ressources liées

  • Méthodologie · Pentest web · Pentest infra et AD · Cloud

    Cadrage d’un pentest

    Checklist de cadrage d’un test d’intrusion : périmètre, autorisations écrites, contacts d’urgence, comptes de test et gestion des données.

    Publié le

  • Outil · Pentest web · Pentest infra et AD

    Calculateur CVSS 3.1

    Calculez le score de base CVSS 3.1 d’une vulnérabilité, sa sévérité et son vecteur, ou collez un vecteur existant pour le relire. Calcul local.

    Publié le

  • Cheatsheet · Pentest web

    Cheatsheet Burp Suite

    Burp Suite pour un test web autorisé : proxy et certificat, périmètre, historique HTTP, Repeater, Intruder prudent, Decoder et export de preuves.

    Publié le

BEAROPS

Besoin d’un test d’intrusion ?

Les experts BEAROPS testent vos applications, votre infrastructure et votre cloud, en boîte noire ou grise, selon les référentiels de l’OWASP, du NIST et de l’ANSSI.