Настройка GraphQL Rate Limiting и Depth Limiting

GraphQL даёт клиентам большую гибкость, но эта же гибкость делает API уязвимым. Один запрос с глубиной вложенности 50 уровней и сотней aliases может генерировать миллионы объектов, забивая CPU и базу данных. Мы сталкивались с кейсами, когда неограниченный endpoint падал под нагрузкой всего от пары запросов в минуту. По данным официальной документации GraphQL, защита от таких аспектов — обязательное условие продакшен-релиза. Depth limiting, query complexity и rate limiting — три ключевых механизма, которые мы внедряем. Depth limiting в 3 раза эффективнее наивного ограничения по времени. За 1–2 рабочих дня мы настраиваем ограничение глубины, сложности и частоты запросов. Закажите защиту вашего GraphQL API прямо сейчас, чтобы обезопасить свой проект и сэкономить до 30% бюджета на инфраструктуру.

Какие проблемы решаем

Без лимитов GraphQL API подвержен DoS-атакам. Злоумышленник может отправить один запрос с рекурсивной вложенностью (user → friends → friends...), который заставит базу данных выполнить тысячи JOIN. Или через aliases запросить одно поле 500 раз, имитируя DDoS. Ещё один вектор — дорогие операции вроде поиска или экспорта, которые потребляют много ресурсов. Мы решаем эти проблемы комплексно, используя depth limiting, query complexity и rate limiting. Стоимость таких атак может достигать упущенной выгоды из-за простоев, поэтому защита окупается быстро.

Как настроить Depth Limiting?

Depth limiting ограничивает максимальную вложенность AST-дерева запроса. Ставим порог в 7 уровней — этого хватает для типичных схем, но блокирует рекурсивные запросы. Для большинства схем порог 7 уровней оптимален: он покрывает 99% легитимных запросов.

import depthLimit from 'graphql-depth-limit'
import { ApolloServer } from '@apollo/server'

const server = new ApolloServer({
  typeDefs,
  resolvers,
  validationRules: [
    depthLimit(7)
  ]
})

Атака без depth limit выглядит так:

{ user { friends { friends { friends { friends { friends { id name } } } } } } } 

Почему важна проверка сложности запроса?

Depth не учитывает широту запроса: запрос с глубиной 2, но запрашивающий 10 000 записей через пагинацию, тоже опасен. Query complexity считает суммарную стоимость, используя множители для аргументов пагинации. Сравните три подхода в таблице:

import { createComplexityLimitRule } from 'graphql-query-complexity'
import { fieldExtensionsEstimator, simpleEstimator } from 'graphql-query-complexity'

const complexityRule = createComplexityLimitRule(1000, {
  estimators: [
    fieldExtensionsEstimator(),
    ({ type, field, args, childComplexity }) => {
      if (args.limit) return args.limit * childComplexity
      if (args.first) return args.first * childComplexity
      return 1 + childComplexity
    },
    simpleEstimator({ defaultComplexity: 1 })
  ],
  onSuccess: (complexity) => console.log(`Query complexity: ${complexity}`),
  formatErrorMessage: (complexity) => `Query too complex (${complexity}). Max allowed: 1000`
})

Сравнение библиотек для защиты GraphQL:

Rate Limiting с Redis

Rate limiting в GraphQL учитывает не только количество запросов, но и их сложность. Используем Redis для хранения счётчиков: лимит на число операций (200 ops/min) и на суммарную сложность (10 000). Для дорогих операций (SearchUsers, ExportData) устанавливаем отдельные лимиты — до 5 вызовов в минуту.

class GraphQLRateLimiter {
  constructor(redis) {
    this.r = redis
  }

  async checkRequest(userId, operationName, complexity) {
    const now = Math.floor(Date.now() / 1000)
    const minute = now - (now % 60)
    const opsKey = `gql:ops:${userId}:${minute}`
    const ops = await this.r.incr(opsKey)
    this.r.expire(opsKey, 120)
    if (ops > 200) {
      throw new GraphQLError('Too many requests', {
        extensions: {
          code: 'RATE_LIMITED',
          retryAfter: 60
        }
      })
    }
    const complexityKey = `gql:complexity:${userId}:${minute}`
    const totalComplexity = await this.r.incrby(complexityKey, complexity)
    this.r.expire(complexityKey, 120)
    if (totalComplexity > 10000) {
      throw new GraphQLError('Query complexity budget exceeded', {
        extensions: {
          code: 'COMPLEXITY_LIMITED',
          retryAfter: 60
        }
      })
    }
    const expensiveOps = ['SearchUsers', 'ExportData', 'GenerateReport']
    if (expensiveOps.includes(operationName)) {
      const expKey = `gql:expensive:${userId}:${minute}`
      const expCount = await this.r.incr(expKey)
      this.r.expire(expKey, 120)
      if (expCount > 5) {
        throw new GraphQLError(`Too many ${operationName} calls`, {
          extensions: {
            code: 'RATE_LIMITED'
          }
        })
      }
    }
    return {
      allowed: true,
      remainingOps: 200 - ops
    }
  }
}

import { createArmor } from '@escape.tech/graphql-armor'

const armor = createArmor({
  maxAliases: { n: 15 },
  maxDirectives: { n: 50 },
  maxDepth: { n: 7 },
  maxTokens: { n: 1000 },
  costLimit: {
    maxCost: 5000,
    objectCost: 2,
    scalarCost: 1,
    depthCostFactor: 1.5,
    ignoreIntrospection: true
  }
})

const server = new ApolloServer({
  typeDefs,
  resolvers,
  plugins: [...armor.plugins],
  validationRules: [...armor.validationRules]
})