В этой статье блога мы рассмотрим различные способы добавления токена на предъявителя в GraphQL Playground. GraphQL Playground — мощный инструмент, который позволяет разработчикам взаимодействовать с API-интерфейсами GraphQL и тестировать запросы и мутации. Добавление токена-носителя часто требуется для целей аутентификации и авторизации. Мы обсудим пять методов вместе с примерами кода, чтобы продемонстрировать, как этого можно достичь.

Метод 1: использование заголовков HTTP
Один из самых простых способов добавить токен-носитель в GraphQL Playground — включить его в заголовки HTTP. Для этой цели обычно используется заголовок «Authorization» со значением «Bearer ». Вот пример того, как добавить токен в заголовки HTTP:

{
  "headers": {
    "Authorization": "Bearer <token>"
  }
}

Метод 2: использование свойства contextна сервере GraphQL
Если вы используете сервер GraphQL, вы можете использовать свойство contextдля передачи токена-носителя. context— это объект, который используется всеми функциями преобразователя. Вот пример того, как добавить токен с помощью свойства context:

const server = new ApolloServer({
  typeDefs,
  resolvers,
  context: ({ req }) => ({
    token: req.headers.authorization
  })
});

Метод 3: использование переменной среды
Другой распространенный подход — сохранить токен носителя в переменной среды и получить к нему доступ в коде. Этот метод обеспечивает гибкость, поскольку токен можно легко обновлять без изменения кода. Вот пример использования переменной среды для токена-носителя:

const token = process.env.BEARER_TOKEN;

Метод 4: использование API fetch
Если вы отправляете запросы API GraphQL с помощью API fetch, вы можете добавить токен носителя в заголовки запрос. Вот пример того, как добавить токен с помощью API fetch:

const fetchGraphqlData = async () => {
  const response = await fetch('https://example.com/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`
    },
    body: JSON.stringify({ query: '{ ... }' })
  });
  const data = await response.json();
  // Process the response data
};

Метод 5. Использование клиентской библиотеки GraphQL
Если вы используете клиентскую библиотеку GraphQL, например Apollo Client, вы можете добавить токен носителя во время инициализации клиента. Вот пример того, как добавить токен с помощью клиента Apollo:

import { ApolloClient, createHttpLink, InMemoryCache } from '@apollo/client';
const httpLink = createHttpLink({
  uri: 'https://example.com/graphql',
  headers: {
    'Authorization': `Bearer ${token}`
  }
});
const client = new ApolloClient({
  link: httpLink,
  cache: new InMemoryCache()
});

В этой статье мы рассмотрели пять различных способов добавления токена на предъявителя в GraphQL Playground. Независимо от того, используете ли вы заголовки HTTP, свойство contextна сервере GraphQL, переменные среды, API fetchили клиентскую библиотеку GraphQL, у вас есть несколько вариантов аутентификации и авторизуйте ваши запросы GraphQL. Выберите метод, который лучше всего соответствует требованиям вашего проекта и потребностям безопасности.

Не забывайте безопасно обращаться с токенами на предъявителя и рассмотрите возможность использования других механизмов аутентификации, таких как OAuth или JWT, в зависимости от вашего конкретного варианта использования.