• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

Bearer-токен

Bearer-токен — секрет, передаваемый в заголовке HTTP Authorization по схеме «Bearer <токен>»; использовать его может любой обладатель, поэтому токен хранят в секрете и передают только по HTTPS.

Схема Bearer, определённая для OAuth 2.0 в RFC 6750 и сегодня применяемая далеко за его пределами, — простейшая форма HTTP-аутентификации. Клиент отправляет Authorization: Bearer, а за ним токен, и сервер проверяет только токен: сам запрос не подписывается, и единственное требуемое доказательство — обладание токеном. Как следует из названия (bearer — «предъявитель»), токен работает для любого его держателя, как наличные.

Поэтому bearer-аутентификация удобна и универсальна, а вся её безопасность сосредоточена в двух местах: в шифровании канала, чтобы токен нельзя было прочитать при передаче, и в обращении с секретом на обеих сторонах. По сравнению со схемами, где подписывается каждый запрос, bearer-токены гораздо проще интегрировать, а для вызовов между серверами они сопоставимо безопасны, если права токена ограничены, токен регулярно ротируется и привязан к IP-адресам. Токен может быть непрозрачным, как большинство ключей API, — тогда сервер ищет его у себя, — или самодостаточным, как JSON Web Token, — тогда сервер его проверяет; заголовок в обоих случаях одинаков.

Пример

Разработчик, отлаживающий условную интеграцию, вставляет в публичный трекер задач полную команду cURL вместе с рабочим ключом. Теперь любой, кто её скопирует, может отправлять сообщения за счёт баланса этой учётной записи. Редактирование публикации не поможет, потому что ключ уже могли скопировать; поможет отзыв ключа и выпуск нового.

Типичные ошибки

  • Передавать токен в строке запроса URL, откуда он попадает в журналы и историю браузера.
  • Отправлять его по обычному HTTP — даже один раз, даже при тестировании.
  • Заключать токен в кавычки или пропускать пробел после Bearer.
  • Записывать заголовок Authorization в журнал целиком.

В SMSMeteor: каждый запрос к API содержит Authorization: Bearer sk_live_… или, для тестирования, ключ sk_test_. Ключам выдаются права send, read или оба, и их можно ограничить списком разрешённых IP-адресов; если ключ отсутствует, отозван, не имеет нужных прав или ограничен по IP, запрос получает 401 unauthorized. Трафик в обратном направлении аутентифицируется иначе: события, отправляемые на эндпоинт вашего вебхука, содержат HMAC-подпись. Подробнее о ключах — в статье «Ключ API» и на странице безопасности.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку