GraphQL
Introduction
GraphQL est souligné comme une alternative efficace aux API REST, offrant une approche simplifiée pour interroger les données du backend. Contrairement à REST, qui nécessite souvent de nombreuses requêtes sur des points de terminaison variés pour collecter des données, GraphQL permet de récupérer toutes les informations requises via une seule requête. Cette rationalisation bénéficie considérablement aux développeurs en réduisant la complexité de leurs processus de récupération de données.
GraphQL et Sécurité
Avec l'avènement de nouvelles technologies, y compris GraphQL, de nouvelles vulnérabilités de sécurité émergent également. Un point clé à noter est que GraphQL ne comprend pas de mécanismes d'authentification par défaut. Il incombe aux développeurs de mettre en œuvre de telles mesures de sécurité. Sans une authentification appropriée, les points de terminaison GraphQL peuvent exposer des informations sensibles à des utilisateurs non authentifiés, posant un risque de sécurité significatif.
Attaques de Force Brute de Répertoire et GraphQL
Pour identifier les instances GraphQL exposées, l'inclusion de chemins spécifiques dans des attaques de force brute de répertoire est recommandée. Ces chemins sont :
/graphql
/graphiql
/graphql.php
/graphql/console
/api
/api/graphql
/graphql/api
/graphql/graphql
Identifier les instances GraphQL ouvertes permet d'examiner les requêtes prises en charge. Cela est crucial pour comprendre les données accessibles via le point de terminaison. Le système d'introspection de GraphQL facilite cela en détaillant les requêtes qu'un schéma prend en charge. Pour plus d'informations à ce sujet, consultez la documentation GraphQL sur l'introspection : GraphQL : Un langage de requête pour les API.
Empreinte
L'outil graphw00f est capable de détecter quel moteur GraphQL est utilisé sur un serveur, puis imprime des informations utiles pour l'auditeur de sécurité.
Requêtes universelles
Pour vérifier si une URL est un service GraphQL, une requête universelle, query{__typename}
, peut être envoyée. Si la réponse inclut {"data": {"__typename": "Query"}}
, cela confirme que l'URL héberge un point de terminaison GraphQL. Cette méthode repose sur le champ __typename
de GraphQL, qui révèle le type de l'objet interrogé.
Énumération de base
Graphql prend généralement en charge GET, POST (x-www-form-urlencoded) et POST(json). Bien que pour des raisons de sécurité, il est recommandé de n'autoriser que le json pour prévenir les attaques CSRF.
Introspection
Pour utiliser l'introspection afin de découvrir des informations sur le schéma, interrogez le champ __schema
. Ce champ est disponible sur le type racine de toutes les requêtes.
Avec cette requête, vous trouverez le nom de tous les types utilisés :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-45033ea2a7d8c631430146a2ddf713919a8d9c82%252Fimage%2520%28202%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=fe1148da&sv=1)
Avec cette requête, vous pouvez extraire tous les types, leurs champs et leurs arguments (ainsi que le type des arguments). Cela sera très utile pour savoir comment interroger la base de données.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-a4059618a9238087dbd99bd3dbe85c1ac7dbdf8a%252Fimage%2520%28207%29%2520%283%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=a9d6503&sv=1)
Erreurs
Il est intéressant de savoir si les erreurs vont être affichées car elles contribueront avec des informations utiles.
Énumérer le schéma de la base de données via l'introspection
Si l'introspection est activée mais que la requête ci-dessus ne s'exécute pas, essayez de supprimer les directives onOperation
, onFragment
et onField
de la structure de la requête.
Requête d'inspection en ligne :
La dernière ligne de code est une requête graphql qui va extraire toutes les métadonnées du graphql (noms d'objets, paramètres, types...)
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-7093c0a2830aa13b97b7d9f5085b0843e5d003af%252Fimage%2520%28206%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=a3fe072b&sv=1)
Si l'introspection est activée, vous pouvez utiliser GraphQL Voyager pour visualiser dans une interface graphique toutes les options.
Interrogation
Maintenant que nous savons quel type d'informations est stocké dans la base de données, essayons d'extraire certaines valeurs.
Dans l'introspection, vous pouvez trouver quels objets vous pouvez interroger directement (car vous ne pouvez pas interroger un objet juste parce qu'il existe). Dans l'image suivante, vous pouvez voir que le "queryType" est appelé "Query" et qu'un des champs de l'objet "Query" est "flags", qui est également un type d'objet. Par conséquent, vous pouvez interroger l'objet de drapeau.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-eef992753b188040adb6f33d8661d77ec19da736%252Fscreenshot-from-2021-03-13-18-17-48.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=c1cd2092&sv=1)
Notez que le type de la requête "flags" est "Flags", et que cet objet est défini comme suit :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-722d32196143296167bc2e966402ed482da8fe36%252Fscreenshot-from-2021-03-13-18-22-57.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=b41a93cb&sv=1)
Vous pouvez voir que les objets "Flags" sont composés par name et value. Ensuite, vous pouvez obtenir tous les noms et valeurs des drapeaux avec la requête :
Notez que dans le cas où l'objet à interroger est un type primitif comme une chaîne de caractères comme dans l'exemple suivant
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-3f805b3ce38d310716e41d985a9ae2544a5cdcce%252Fimage%2520%28441%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=cbe834f2&sv=1)
Vous pouvez simplement interroger avec:
Dans un autre exemple où il y avait 2 objets à l'intérieur de l'objet de type "Query" : "user" et "users". Si ces objets n'ont pas besoin d'arguments pour être recherchés, vous pouvez récupérer toutes les informations à leur sujet en demandant simplement les données que vous voulez. Dans cet exemple sur Internet, vous pourriez extraire les noms d'utilisateur et les mots de passe enregistrés :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-b42b37ed36c78ebf2c6dcce7b8241a0817d5c8b1%252Fimage%2520%28208%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=aa9c05f1&sv=1)
Cependant, dans cet exemple, si vous essayez de le faire, vous obtenez cette erreur :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-61c135212c51ced29938aef8f285ac19f8f85fe4%252Fimage%2520%28210%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=1554f1d0&sv=1)
Il semble qu'il effectuera la recherche en utilisant l'argument "uid" de type Int.
Quoi qu'il en soit, nous savions déjà que, dans la section Énumération de base, une requête avait été proposée qui nous montrait toutes les informations nécessaires : query={__schema{types{name,fields{name, args{name,description,type{name, kind, ofType{name, kind}}}}}}}
Si vous lisez l'image fournie lorsque j'ai exécuté cette requête, vous verrez que "user" avait l'arg "uid" de type Int.
Ainsi, en effectuant une légère attaque par force brute sur l'uid, j'ai découvert qu'avec l'uid=1, un nom d'utilisateur et un mot de passe ont été récupérés :
query={user(uid:1){user,password}}
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-629c1147c044a7edfc0452bb86ed657ea911aef6%252Fimage%2520%28211%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=548b6c6b&sv=1)
Notez que j'ai découvert que je pouvais demander les paramètres "user" et "password" car si j'essaie de chercher quelque chose qui n'existe pas (query={user(uid:1){noExists}}
), j'obtiens cette erreur :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-8bad097887b80495e770000f595f2a1dbfbae19f%252Fimage%2520%28213%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=43af1c40&sv=1)
Et lors de la phase d'énumération, j'ai découvert que l'objet "dbuser" avait comme champs "user" et "password.
Astuce de vidage de chaîne de requête (merci à @BinaryShadow_)
Si vous pouvez rechercher par un type chaîne de caractères, comme : query={theusers(description: ""){username,password}}
et que vous recherchez une chaîne vide, cela videra toutes les données. (Notez que cet exemple n'est pas lié à l'exemple des tutoriels, pour cet exemple, supposez que vous pouvez rechercher en utilisant "theusers" par un champ de type chaîne de caractères appelé "description").
Recherche
Dans cette configuration, une base de données contient des personnes et des films. Les personnes sont identifiées par leur e-mail et leur nom ; les films par leur nom et leur classement. Les personnes peuvent être amies les unes avec les autres et avoir également des films, indiquant des relations au sein de la base de données.
Vous pouvez rechercher des personnes par le nom et obtenir leurs adresses e-mail :
Vous pouvez rechercher des personnes par leur nom et obtenir les films auxquels elles sont abonnées :
Notez comment il est indiqué de récupérer le name
des subscribedMovies
de la personne.
Vous pouvez également rechercher plusieurs objets en même temps. Dans ce cas, une recherche de 2 films est effectuée :
Ou même relations de plusieurs objets différents en utilisant des alias :
Mutations
Les mutations sont utilisées pour effectuer des changements côté serveur.
Dans l'introspection, vous pouvez trouver les mutations déclarées. Dans l'image suivante, le "MutationType" est appelé "Mutation" et l'objet "Mutation" contient les noms des mutations (comme "addPerson" dans ce cas) :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-44a446c60fb9a4afd4bf483f63901eeb7ffa9268%252Fscreenshot-from-2021-03-13-18-26-27.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=8c719da6&sv=1)
Dans cette configuration, une base de données contient des personnes et des films. Les personnes sont identifiées par leur email et leur nom ; les films par leur nom et leur note. Les personnes peuvent être amies les unes avec les autres et avoir également des films, indiquant des relations au sein de la base de données.
Une mutation pour créer de nouveaux films dans la base de données peut ressembler à celle-ci (dans cet exemple, la mutation est appelée addMovie
) :
Notez comment les valeurs et le type de données sont indiqués dans la requête.
De plus, la base de données prend en charge une opération de mutation, nommée addPerson
, qui permet la création de personnes ainsi que leur association à des amis et des films existants. Il est crucial de noter que les amis et les films doivent préexister dans la base de données avant de les lier à la personne nouvellement créée.
Surcharge de directive
Comme expliqué dans l'une des vulnérabilités décrites dans ce rapport, une surcharge de directive implique d'appeler une directive même des millions de fois pour amener le serveur à gaspiller des opérations jusqu'à ce qu'il soit possible de le soumettre à une attaque par déni de service (DoS).
Force brute par lots en 1 requête API
Ces informations ont été prises sur https://lab.wallarm.com/graphql-batching-attack/. L'authentification via l'API GraphQL consiste à envoyer simultanément de nombreuses requêtes avec des identifiants différents pour les vérifier. Il s'agit d'une attaque de force brute classique, mais il est maintenant possible d'envoyer plus d'une paire de login/mot de passe par requête HTTP en raison de la fonctionnalité de lotissement de GraphQL. Cette approche tromperait les applications de surveillance des taux externes en leur faisant croire que tout va bien et qu'il n'y a pas de robot de force brute essayant de deviner des mots de passe.
Ci-dessous, vous trouverez la démonstration la plus simple d'une demande d'authentification d'application, avec 3 paires d'adresses e-mail/mot de passe différentes à la fois. Il est évidemment possible d'en envoyer des milliers en une seule requête de la même manière :
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-e3b2aeec042f09deee15222f09139489ae7dd63d%252Fimage%2520%28182%29%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=f6eaabb&sv=1)
Comme le montre la capture d'écran de la réponse, les première et troisième requêtes ont renvoyé null et ont reflété les informations correspondantes dans la section error. La deuxième mutation avait les données d'authentification correctes et la réponse contenait le jeton de session d'authentification correct.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F2088318145-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Frq9WIQinJaxpWMvakjIQ%252Fuploads%252Fgit-blob-e2f82d4dfbc68e5dea4c4c45ae6111533f4220cc%252Fimage%2520%28119%29%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ed48c2ff&sv=1)
GraphQL sans introspection
De plus en plus de points de terminaison GraphQL désactivent l'introspection. Cependant, les erreurs que GraphQL renvoie lorsqu'une requête inattendue est reçue sont suffisantes pour des outils comme clairvoyance pour recréer la majeure partie du schéma.
De plus, l'extension Burp Suite GraphQuail observe les requêtes d'API GraphQL passant par Burp et construit un schéma GraphQL interne à chaque nouvelle requête qu'il voit. Il peut également exposer le schéma pour GraphiQL et Voyager. L'extension renvoie une fausse réponse lorsqu'elle reçoit une requête d'introspection. En conséquence, GraphQuail affiche toutes les requêtes, arguments et champs disponibles pour une utilisation dans l'API. Pour plus d'informations, consultez ceci.
Une liste de mots intéressante pour découvrir les entités GraphQL peut être trouvée ici.
Contournement des défenses d'introspection GraphQL
Contournement des défenses d'introspection GraphQL
Pour contourner les restrictions sur les requêtes d'introspection dans les API, l'insertion d'un caractère spécial après le mot-clé __schema
s'avère efficace. Cette méthode exploite les erreurs courantes des développeurs dans les modèles regex qui visent à bloquer l'introspection en se concentrant sur le mot-clé __schema
. En ajoutant des caractères comme des espaces, des sauts de ligne et des virgules, que GraphQL ignore mais qui pourraient ne pas être pris en compte dans les regex, les restrictions peuvent être contournées. Par exemple, une requête d'introspection avec un saut de ligne après __schema
peut contourner de telles défenses :
Si cela échoue, envisagez des méthodes de requête alternatives, telles que les requêtes GET ou les POST avec x-www-form-urlencoded
, car des restrictions peuvent s'appliquer uniquement aux requêtes POST.
Découverte des structures GraphQL exposées
Lorsque l'introspection est désactivée, l'examen du code source du site web à la recherche de requêtes préchargées dans les bibliothèques JavaScript est une stratégie utile. Ces requêtes peuvent être trouvées en utilisant l'onglet Sources
dans les outils de développement, fournissant des informations sur le schéma de l'API et révélant potentiellement des requêtes sensibles exposées. Les commandes pour rechercher dans les outils de développement sont :
CSRF dans GraphQL
Si vous ne savez pas ce qu'est le CSRF, lisez la page suivante:
CSRF (Cross Site Request Forgery)Vous pourrez trouver plusieurs points de terminaison GraphQL configurés sans jetons CSRF.
Notez que les requêtes GraphQL sont généralement envoyées via des requêtes POST en utilisant le Content-Type application/json
.
Cependant, la plupart des points de terminaison GraphQL prennent également en charge les requêtes POST form-urlencoded
:
Par conséquent, comme les requêtes CSRF comme les précédentes sont envoyées sans requêtes de pré-vérification, il est possible d'effectuer des changements dans le GraphQL en abusant d'une CSRF.
Cependant, notez que la nouvelle valeur par défaut du cookie pour le drapeau samesite
de Chrome est Lax
. Cela signifie que le cookie ne sera envoyé que depuis un site web tiers dans les requêtes GET.
Notez qu'il est généralement possible d'envoyer la requête query également en tant que requête GET et que le jeton CSRF pourrait ne pas être validé dans une requête GET.
De plus, en abusant d'une attaque XS-Search, il pourrait être possible d'extraire du contenu de l'endpoint GraphQL en abusant des informations d'identification de l'utilisateur.
Pour plus d'informations, consultez le message original ici.
Autorisation dans GraphQL
De nombreuses fonctions GraphQL définies sur l'endpoint pourraient uniquement vérifier l'authentification du demandeur mais pas l'autorisation.
La modification des variables d'entrée de la requête pourrait entraîner la divulgation de détails sensibles sur le compte fuité.
Une mutation pourrait même entraîner une prise de contrôle de compte en essayant de modifier les données d'autres comptes.
Contourner l'autorisation en GraphQL
Chainer des requêtes peut contourner un système d'authentification faible.
Dans l'exemple ci-dessous, vous pouvez voir que l'opération est "forgotPassword" et qu'elle ne devrait exécuter que la requête forgotPassword qui lui est associée. Cela peut être contourné en ajoutant une requête à la fin, dans ce cas, nous ajoutons "register" et une variable utilisateur pour que le système s'inscrive en tant que nouvel utilisateur.
Contourner les limites de taux en utilisant des alias en GraphQL
En GraphQL, les alias sont une fonctionnalité puissante qui permet de nommer explicitement les propriétés lors de l'envoi d'une requête API. Cette capacité est particulièrement utile pour récupérer plusieurs instances du même type d'objet dans une seule requête. Les alias peuvent être utilisés pour surmonter la limitation qui empêche les objets GraphQL d'avoir plusieurs propriétés avec le même nom.
Pour une compréhension détaillée des alias GraphQL, la ressource suivante est recommandée : Aliases.
Alors que l'objectif principal des alias est de réduire la nécessité de nombreuses appels API, un cas d'utilisation non intentionnel a été identifié où les alias peuvent être exploités pour exécuter des attaques par force brute sur un point de terminaison GraphQL. Cela est possible car certains points de terminaison sont protégés par des limiteurs de taux conçus pour contrer les attaques par force brute en restreignant le nombre de requêtes HTTP. Cependant, ces limiteurs de taux pourraient ne pas tenir compte du nombre d'opérations dans chaque requête. Étant donné que les alias permettent d'inclure plusieurs requêtes dans une seule requête HTTP, ils peuvent contourner de telles mesures de limitation de taux.
Considérez l'exemple fourni ci-dessous, qui illustre comment les requêtes aliasées peuvent être utilisées pour vérifier la validité des codes de réduction de magasin. Cette méthode pourrait contourner la limitation de taux car elle compile plusieurs requêtes en une seule requête HTTP, permettant potentiellement de vérifier simultanément de nombreux codes de réduction.
Outils
Scanners de vulnérabilités
https://github.com/gsmith257-cyber/GraphCrawler : Boîte à outils qui peut être utilisée pour récupérer des schémas et rechercher des données sensibles, tester l'autorisation, forcer les schémas et trouver des chemins vers un type donné.
https://blog.doyensec.com/2020/03/26/graphql-scanner.html : Peut être utilisé en tant que standalone ou extension Burp.
https://github.com/swisskyrepo/GraphQLmap : Peut être utilisé en tant que client CLI pour automatiser les attaques.
https://gitlab.com/dee-see/graphql-path-enum : Outil qui répertorie les différentes façons d'atteindre un type donné dans un schéma GraphQL.
https://github.com/doyensec/inql : Extension Burp pour des tests GraphQL avancés. Le Scanner est le cœur d'InQL v5.0, où vous pouvez analyser un point de terminaison GraphQL ou un fichier de schéma d'introspection local. Il génère automatiquement toutes les requêtes et mutations possibles, les organisant dans une vue structurée pour votre analyse. Le composant Attaquant vous permet d'exécuter des attaques GraphQL en lot, ce qui peut être utile pour contourner les limites de taux mal implémentées.
Clients
https://github.com/graphql/graphiql : Client GUI
https://altair.sirmuel.design/ : Client GUI
Tests automatiques
Vidéo expliquant AutoGraphQL : https://www.youtube.com/watch?v=JJmufWfVvyU
Références
Last updated