#063Technique3 min

Analyser une API avec Hackaiz

Prouver le contrôle du domaine, examiner les routes accessibles et connaître les limites des contrôles.

Équipe Hackaiz · mis à jour le 21/11/2026

Illustration : un ingénieur travaille à côté de serveurs.
Illustration : un ingénieur travaille à côté de serveurs. Photo d’illustration, pas une capture d’écran.

01Identifier le domaine qui reçoit les appels

Une API est une interface que des logiciels appellent pour lire des données ou effectuer des actions. Son adresse peut différer de celle de votre application : une page sur app.exemple.fr peut appeler api.exemple.fr. Commencez par repérer le domaine déployé qui reçoit ces requêtes. La vérification du site vitrine ne décrit pas à elle seule la protection des dossiers privés ou des opérations administratives.

Hackaiz inclut des contrôles d'API dans l'analyse autorisée des sites, notamment un examen de routes découvertes dans une description OpenAPI ou Swagger. Il ne s'agit pas de promettre l'essai de toutes les opérations. Distinguez l'adresse déployée, le dépôt de code et la base de données afin que chaque résultat ait un périmètre identifiable.

02Fournir la preuve avant de lancer l’analyse

Ouvrez /connect et préparez la cible voulue. Toute analyse de site ou d'API exige d'abord une preuve de contrôle du domaine. Vous pouvez placer la valeur affichée dans un enregistrement DNS TXT sous _hackaiz, la publier par HTTPS dans /.well-known/hackaiz-verification.txt, ou transmettre l'instruction de Hackaiz à l'IA du projet pour qu'elle crée ce fichier. La preuve concerne le domaine indiqué à l'écran.

Si vous ne pouvez ni modifier le DNS ni publier le fichier, sollicitez le responsable du domaine. Connaître l'URL ou consulter la documentation publique ne constitue pas une autorisation d'analyse. Notez séparément les adresses de développement et de production ; la preuve du domaine de l'interface ne vaut pas automatiquement pour un autre nom d'hôte utilisé par l'API.

03Comprendre la sélection des routes

Le contrôle d'authentification recherche une description OpenAPI ou Swagger à des emplacements de documentation connus. Il en retient les opérations GET admissibles, destinées à lire des informations. Il écarte les routes comportant des paramètres dans le chemin et celles nécessitant d'autres paramètres obligatoires. Une opération déclarée explicitement publique n'est pas signalée comme dépourvue d'authentification par ce contrôle.

Des requêtes anonymes, en nombre limité, recherchent ensuite une réponse réussie contenant des données JSON structurées. Une page HTML renvoyée par défaut n'est pas prise pour une réponse d'API. L'absence de description exploitable ou d'opérations admissibles ne démontre pas la sécurité de l'API : elle limite simplement cette source d'observations sur les routes.

04Interpréter les réponses dans leur contexte

Un point relevé peut indiquer la requête GET anonyme, la route, le statut reçu et un extrait masqué. Demandez au responsable si les informations retournées doivent être publiques. Un catalogue de catégories publiques et une liste de factures clients n'ont pas le même public attendu. Un nom de route évoquant l'administration aide à prioriser l'examen, sans définir à lui seul la politique d'accès.

Une réponse anonyme ne prouve pas toutes les formes d'accès entre utilisateurs. L'authentification identifie l'appelant ; l'autorisation décide s'il peut consulter ce dossier ou effectuer cette opération. Examinez les contrôles côté serveur et, si nécessaire, raccordez séparément le dépôt ou la base pour comprendre leur mise en œuvre. Une seule requête externe ne couvre pas tout ce fonctionnement.

05Faire corriger puis vérifier le comportement

Les analyses sélectionnées utilisent des crédits. Les contrôles décochés ne sont ni exécutés ni facturés : associez vos conclusions à la liste des vérifications effectivement réalisées. Les résultats utilisent les niveaux Danger, À corriger et À surveiller. Identifiez la route et les éléments observés, puis confiez la correction au responsable de l'authentification ou des autorisations de l'API.

Une correction proposée par GitHub reste une demande de fusion en brouillon, soumise à une revue et une approbation humaines, sans fusion automatique. Après déploiement du changement approuvé, refaites l'analyse autorisée pertinente et assurez-vous que les réponses volontairement publiques fonctionnent encore. Cette nouvelle analyse utilise aussi des crédits ; précisez la route à revérifier et les opérations qui restent hors périmètre.

Questions fréquentes

Cet article vous a-t-il aidé ?

Articles liés