GraphQL
Learn & practice AWS Hacking:HackTricks Training AWS Red Team Expert (ARTE)
Learn & practice GCP Hacking:
HackTricks Training GCP Red Team Expert (GRTE)
Introdução
GraphQL é destacado como uma alternativa eficiente à REST API, oferecendo uma abordagem simplificada para consultar dados do backend. Em contraste com REST, que muitas vezes exige várias solicitações em diferentes endpoints para reunir dados, o GraphQL permite a recuperação de todas as informações necessárias por meio de uma única solicitação. Essa simplificação beneficia significativamente os desenvolvedores ao diminuir a complexidade de seus processos de recuperação de dados.
GraphQL e Segurança
Com o advento de novas tecnologias, incluindo o GraphQL, novas vulnerabilidades de segurança também surgem. Um ponto chave a ser observado é que o GraphQL não inclui mecanismos de autenticação por padrão. É responsabilidade dos desenvolvedores implementar tais medidas de segurança. Sem a autenticação adequada, os endpoints do GraphQL podem expor informações sensíveis a usuários não autenticados, representando um risco significativo à segurança.
Ataques de Força Bruta em Diretórios e GraphQL
Para identificar instâncias expostas do GraphQL, recomenda-se a inclusão de caminhos específicos em ataques de força bruta em diretórios. Esses caminhos são:
/graphql
/graphiql
/graphql.php
/graphql/console
/api
/api/graphql
/graphql/api
/graphql/graphql
Identificar instâncias abertas do GraphQL permite a análise das consultas suportadas. Isso é crucial para entender os dados acessíveis através do endpoint. O sistema de introspecção do GraphQL facilita isso ao detalhar as consultas que um esquema suporta. Para mais informações sobre isso, consulte a documentação do GraphQL sobre introspecção: GraphQL: A query language for APIs.
Impressão Digital
A ferramenta graphw00f é capaz de detectar qual motor GraphQL está sendo usado em um servidor e, em seguida, imprime algumas informações úteis para o auditor de segurança.
Consultas Universais
Para verificar se uma URL é um serviço GraphQL, uma consulta universal, query{__typename}
, pode ser enviada. Se a resposta incluir {"data": {"__typename": "Query"}}
, isso confirma que a URL hospeda um endpoint GraphQL. Este método depende do campo __typename
do GraphQL, que revela o tipo do objeto consultado.
Enumeração Básica
Graphql geralmente suporta GET, POST (x-www-form-urlencoded) e POST(json). Embora, por questões de segurança, seja recomendado permitir apenas json para prevenir ataques CSRF.
Introspecção
Para usar a introspecção para descobrir informações do esquema, consulte o campo __schema
. Este campo está disponível no tipo raiz de todas as consultas.
Com esta consulta, você encontrará o nome de todos os tipos que estão sendo usados:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-45033ea2a7d8c631430146a2ddf713919a8d9c82%252Fimage%2520%281036%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d62b002e&sv=1)
Com esta consulta, você pode extrair todos os tipos, seus campos e seus argumentos (e o tipo dos argumentos). Isso será muito útil para saber como consultar o banco de dados.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-a4059618a9238087dbd99bd3dbe85c1ac7dbdf8a%252Fimage%2520%28950%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=498d68f9&sv=1)
Erros
É interessante saber se os erros serão exibidos, pois eles contribuirão com informações úteis.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-0cd3e45fccd4b2064fca9fb35add65bea885fd9d%252Fimage%2520%28416%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=c16f008&sv=1)
Enumerar Esquema de Banco de Dados via Introspecção
Se a introspecção estiver habilitada, mas a consulta acima não for executada, tente remover as diretivas onOperation
, onFragment
e onField
da estrutura da consulta.
Consulta de introspecção inline:
A última linha de código é uma consulta graphql que irá despejar todas as metainformações do graphql (nomes de objetos, parâmetros, tipos...)
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-7093c0a2830aa13b97b7d9f5085b0843e5d003af%252Fimage%2520%28363%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=b655cb67&sv=1)
Se a introspecção estiver habilitada, você pode usar GraphQL Voyager para visualizar em uma GUI todas as opções.
Consultando
Agora que sabemos que tipo de informação está salva dentro do banco de dados, vamos tentar extrair alguns valores.
Na introspecção, você pode encontrar qual objeto você pode consultar diretamente (porque você não pode consultar um objeto apenas porque ele existe). Na imagem a seguir, você pode ver que o "queryType" é chamado de "Query" e que um dos campos do objeto "Query" é "flags", que também é um tipo de objeto. Portanto, você pode consultar o objeto flag.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-eef992753b188040adb6f33d8661d77ec19da736%252FScreenshot%2520from%25202021-03-13%252018-17-48.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=17cebd4a&sv=1)
Note que o tipo da consulta "flags" é "Flags", e este objeto é definido como abaixo:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-722d32196143296167bc2e966402ed482da8fe36%252FScreenshot%2520from%25202021-03-13%252018-22-57%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=c5497f0c&sv=1)
Você pode ver que os objetos "Flags" são compostos por name e value. Então você pode obter todos os nomes e valores das flags com a consulta:
Note que, caso o objeto a ser consultado seja um tipo primitivo como string, como no exemplo a seguir
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-3f805b3ce38d310716e41d985a9ae2544a5cdcce%252Fimage%2520%28958%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=69468bf5&sv=1)
Você pode simplesmente consultá-lo com:
Em outro exemplo onde havia 2 objetos dentro do objeto do tipo "Query": "user" e "users". Se esses objetos não precisarem de nenhum argumento para pesquisar, poderia recuperar todas as informações deles apenas pedindo os dados que você deseja. Neste exemplo da Internet, você poderia extrair os nomes de usuário e senhas salvos:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-b42b37ed36c78ebf2c6dcce7b8241a0817d5c8b1%252Fimage%2520%28880%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=f84e70c1&sv=1)
No entanto, neste exemplo, se você tentar fazer isso, receberá este erro:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-61c135212c51ced29938aef8f285ac19f8f85fe4%252Fimage%2520%281042%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ff927ab6&sv=1)
Parece que, de alguma forma, ele irá pesquisar usando o argumento "uid" do tipo Int.
De qualquer forma, já sabíamos disso, na seção Basic Enumeration foi proposta uma consulta que mostrava todas as informações necessárias: query={__schema{types{name,fields{name, args{name,description,type{name, kind, ofType{name, kind}}}}}}}
Se você ler a imagem fornecida quando executei essa consulta, verá que "user" tinha o arg "uid" do tipo Int.
Assim, realizando um leve uid bruteforce, descobri que em uid=1 um nome de usuário e uma senha foram recuperados:
query={user(uid:1){user,password}}
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-629c1147c044a7edfc0452bb86ed657ea911aef6%252Fimage%2520%2890%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=1ad8ef54&sv=1)
Note que eu descobri que poderia pedir os parâmetros "user" e "password" porque se eu tentar procurar algo que não existe (query={user(uid:1){noExists}}
) recebo este erro:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-8bad097887b80495e770000f595f2a1dbfbae19f%252Fimage%2520%28707%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=47ec0ec4&sv=1)
E durante a fase de enumeração, descobri que o objeto "dbuser" tinha como campos "user" e "password.
Truque de despejo de string de consulta (graças ao @BinaryShadow_)
Se você pode pesquisar por um tipo de string, como: query={theusers(description: ""){username,password}}
e você pesquisar por uma string vazia, isso irá despejar todos os dados. (Note que este exemplo não está relacionado com o exemplo dos tutoriais, para este exemplo suponha que você pode pesquisar usando "theusers" por um campo String chamado "description").
Pesquisa
Nesta configuração, um banco de dados contém pessoas e filmes. Pessoas são identificadas por seu email e nome; filmes por seu nome e avaliação. Pessoas podem ser amigas umas das outras e também ter filmes, indicando relacionamentos dentro do banco de dados.
Você pode pesquisar pessoas pelo nome e obter seus emails:
Você pode buscar pessoas pelo nome e obter seus filmes assinados:
Note como é indicado recuperar o name
dos subscribedMovies
da pessoa.
Você também pode pesquisar vários objetos ao mesmo tempo. Neste caso, uma pesquisa de 2 filmes é feita:
Ou até mesmo relações de vários objetos diferentes usando aliases:
Mutations
As mutações são usadas para fazer alterações no lado do servidor.
Na introspecção, você pode encontrar as mutações declaradas. Na imagem a seguir, o "MutationType" é chamado de "Mutation" e o objeto "Mutation" contém os nomes das mutações (como "addPerson" neste caso):
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-44a446c60fb9a4afd4bf483f63901eeb7ffa9268%252FScreenshot%2520from%25202021-03-13%252018-26-27%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=e5a9e6fd&sv=1)
Nesta configuração, um banco de dados contém pessoas e filmes. Pessoas são identificadas por seu email e nome; filmes por seu nome e avaliação. Pessoas podem ser amigas umas das outras e também ter filmes, indicando relacionamentos dentro do banco de dados.
Uma mutação para criar novos filmes dentro do banco de dados pode ser como a seguinte (neste exemplo, a mutação é chamada de addMovie
):
Observe como tanto os valores quanto o tipo de dados são indicados na consulta.
Além disso, o banco de dados suporta uma operação de mutação, chamada addPerson
, que permite a criação de pessoas juntamente com suas associações a amigos e filmes existentes. É crucial notar que os amigos e filmes devem pré-existir no banco de dados antes de serem vinculados à nova pessoa criada.
Sobrecarga de Diretivas
Como explicado em uma das vulnerabilidades descritas neste relatório, uma sobrecarga de diretivas implica chamar uma diretiva até milhões de vezes para fazer o servidor desperdiçar operações até que seja possível realizar um DoS.
Agrupamento de força bruta em 1 solicitação de API
Esta informação foi retirada de https://lab.wallarm.com/graphql-batching-attack/. Autenticação através da API GraphQL com envio simultâneo de muitas consultas com diferentes credenciais para verificá-las. É um ataque clássico de força bruta, mas agora é possível enviar mais de um par login/senha por solicitação HTTP devido ao recurso de agrupamento do GraphQL. Essa abordagem enganaria aplicativos externos de monitoramento de taxa, fazendo-os pensar que está tudo bem e que não há um bot de força bruta tentando adivinhar senhas.
Abaixo você pode encontrar a demonstração mais simples de uma solicitação de autenticação de aplicativo, com 3 pares de email/senha diferentes por vez. Obviamente, é possível enviar milhares em uma única solicitação da mesma forma:
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-e3b2aeec042f09deee15222f09139489ae7dd63d%252Fimage%2520%281081%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=13d9f07d&sv=1)
Como podemos ver na captura de tela da resposta, a primeira e a terceira solicitações retornaram null e refletiram as informações correspondentes na seção error. A segunda mutação teve os dados de autenticação corretos e a resposta contém o token de sessão de autenticação correto.
![](https://book.hacktricks.xyz/~gitbook/image?url=https%3A%2F%2F910640767-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FjzQiXe8oFAkPoN0MXcUG%252Fuploads%252Fgit-blob-e2f82d4dfbc68e5dea4c4c45ae6111533f4220cc%252Fimage%2520%28119%29%2520%281%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=eb7f29bd&sv=1)
GraphQL Sem Introspecção
Cada vez mais endpoints graphql estão desativando a introspecção. No entanto, os erros que o graphql gera quando uma solicitação inesperada é recebida são suficientes para ferramentas como clairvoyance recriarem a maior parte do esquema.
Além disso, a extensão Burp Suite GraphQuail observa solicitações da API GraphQL passando pelo Burp e constrói um esquema interno de GraphQL com cada nova consulta que vê. Ela também pode expor o esquema para GraphiQL e Voyager. A extensão retorna uma resposta falsa quando recebe uma consulta de introspecção. Como resultado, o GraphQuail mostra todas as consultas, argumentos e campos disponíveis para uso dentro da API. Para mais informações verifique isso.
Uma boa lista de palavras para descobrir entidades GraphQL pode ser encontrada aqui.
Contornando defesas de introspecção do GraphQL
Para contornar restrições em consultas de introspecção em APIs, inserir um caractere especial após a palavra-chave __schema
prova ser eficaz. Este método explora descuidos comuns de desenvolvedores em padrões regex que visam bloquear a introspecção, concentrando-se na palavra-chave __schema
. Ao adicionar caracteres como espaços, novas linhas e vírgulas, que o GraphQL ignora, mas que podem não ser considerados no regex, as restrições podem ser contornadas. Por exemplo, uma consulta de introspecção com uma nova linha após __schema
pode contornar tais defesas:
Se não tiver sucesso, considere métodos de solicitação alternativos, como solicitações GET ou POST com x-www-form-urlencoded
, uma vez que as restrições podem se aplicar apenas às solicitações POST.
Tente WebSockets
Como mencionado em esta palestra, verifique se pode ser possível conectar-se ao graphQL via WebSockets, pois isso pode permitir que você contorne um potencial WAF e faça a comunicação websocket vazar o esquema do graphQL:
Descobrindo Estruturas GraphQL Expostas
Quando a introspecção está desativada, examinar o código-fonte do site em busca de consultas pré-carregadas em bibliotecas JavaScript é uma estratégia útil. Essas consultas podem ser encontradas usando a aba Sources
nas ferramentas de desenvolvedor, fornecendo insights sobre o esquema da API e revelando potencialmente consultas sensíveis expostas. Os comandos para pesquisar dentro das ferramentas de desenvolvedor são:
CSRF em GraphQL
Se você não sabe o que é CSRF, leia a página a seguir:
CSRF (Cross Site Request Forgery)Por aí, você poderá encontrar vários endpoints GraphQL configurados sem tokens CSRF.
Observe que as requisições GraphQL geralmente são enviadas via requisições POST usando o Content-Type application/json
.
No entanto, a maioria dos endpoints GraphQL também suporta form-urlencoded
POST requests:
Portanto, como as solicitações CSRF, como as anteriores, são enviadas sem solicitações de pré-vôo, é possível realizar alterações no GraphQL abusando de um CSRF.
No entanto, note que o novo valor padrão do cookie da flag samesite
do Chrome é Lax
. Isso significa que o cookie só será enviado de um site de terceiros em solicitações GET.
Note que geralmente é possível enviar a solicitação de consulta também como uma solicitação GET e o token CSRF pode não estar sendo validado em uma solicitação GET.
Além disso, abusando de um XS-Search ataque pode ser possível exfiltrar conteúdo do endpoint GraphQL abusando das credenciais do usuário.
Para mais informações verifique o post original aqui.
Sequestro de WebSocket entre sites no GraphQL
Semelhante às vulnerabilidades CRSF abusando do GraphQL, também é possível realizar um sequestro de WebSocket entre sites para abusar de uma autenticação com GraphQL com cookies desprotegidos e fazer um usuário realizar ações inesperadas no GraphQL.
Para mais informações, verifique:
WebSocket AttacksAutorização no GraphQL
Muitas funções GraphQL definidas no endpoint podem apenas verificar a autenticação do solicitante, mas não a autorização.
Modificar variáveis de entrada da consulta pode levar a detalhes sensíveis da conta vazados.
A mutação pode até levar a uma tomada de conta ao tentar modificar dados de outra conta.
Bypass authorization in GraphQL
Chaining queries juntos pode contornar um sistema de autenticação fraco.
No exemplo abaixo, você pode ver que a operação é "forgotPassword" e que deve executar apenas a consulta forgotPassword associada a ela. Isso pode ser contornado adicionando uma consulta ao final, neste caso, adicionamos "register" e uma variável de usuário para o sistema registrar como um novo usuário.
Bypassing Rate Limits Using Aliases in GraphQL
Em GraphQL, aliases são um recurso poderoso que permite a nomeação de propriedades explicitamente ao fazer uma solicitação de API. Essa capacidade é particularmente útil para recuperar múltiplas instâncias do mesmo tipo de objeto em uma única solicitação. Aliases podem ser empregados para superar a limitação que impede objetos GraphQL de ter várias propriedades com o mesmo nome.
Para uma compreensão detalhada dos aliases do GraphQL, o seguinte recurso é recomendado: Aliases.
Embora o propósito principal dos aliases seja reduzir a necessidade de numerosas chamadas de API, um caso de uso não intencional foi identificado onde aliases podem ser aproveitados para executar ataques de força bruta em um endpoint GraphQL. Isso é possível porque alguns endpoints são protegidos por limitadores de taxa projetados para frustrar ataques de força bruta, restringindo o número de solicitações HTTP. No entanto, esses limitadores de taxa podem não levar em conta o número de operações dentro de cada solicitação. Dado que os aliases permitem a inclusão de várias consultas em uma única solicitação HTTP, eles podem contornar tais medidas de limitação de taxa.
Considere o exemplo fornecido abaixo, que ilustra como consultas com alias podem ser usadas para verificar a validade de códigos de desconto de loja. Este método poderia contornar a limitação de taxa, uma vez que compila várias consultas em uma única solicitação HTTP, potencialmente permitindo a verificação de numerosos códigos de desconto simultaneamente.
Ferramentas
Scanners de vulnerabilidade
https://github.com/dolevf/graphql-cop: Testa configurações incorretas comuns de endpoints graphql
https://github.com/assetnote/batchql: Script de auditoria de segurança GraphQL com foco em realizar consultas e mutações GraphQL em lote.
https://github.com/dolevf/graphw00f: Identifica a graphql sendo usada
https://github.com/gsmith257-cyber/GraphCrawler: Conjunto de ferramentas que pode ser usado para capturar esquemas e buscar dados sensíveis, testar autorização, forçar esquemas e encontrar caminhos para um tipo específico.
https://blog.doyensec.com/2020/03/26/graphql-scanner.html: Pode ser usado como autônomo ou extensão Burp.
https://github.com/swisskyrepo/GraphQLmap: Pode ser usado como um cliente CLI também para automatizar ataques
https://gitlab.com/dee-see/graphql-path-enum: Ferramenta que lista as diferentes maneiras de acessar um tipo específico em um esquema GraphQL.
https://github.com/doyensec/GQLSpection: O sucessor dos Modos Autônomo e CLI do InQL
https://github.com/doyensec/inql: Extensão Burp para testes avançados de GraphQL. O Scanner é o núcleo do InQL v5.0, onde você pode analisar um endpoint GraphQL ou um arquivo de esquema de introspecção local. Ele gera automaticamente todas as possíveis consultas e mutações, organizando-as em uma visão estruturada para sua análise. O componente Attacker permite que você execute ataques GraphQL em lote, o que pode ser útil para contornar limites de taxa mal implementados.
https://github.com/nikitastupin/clairvoyance: Tenta obter o esquema mesmo com a introspecção desativada, usando a ajuda de alguns bancos de dados Graphql que sugerem os nomes de mutações e parâmetros.
Clientes
https://github.com/graphql/graphiql: Cliente GUI
https://altair.sirmuel.design/: Cliente GUI
Testes Automáticos
Vídeo explicando AutoGraphQL: https://www.youtube.com/watch?v=JJmufWfVvyU
Referências
Aprenda e pratique Hacking AWS:HackTricks Training AWS Red Team Expert (ARTE)
Aprenda e pratique Hacking GCP:
HackTricks Training GCP Red Team Expert (GRTE)
Last updated