Приложения и доступ к API

Токен на предъявителя

Определение

Токен на предъявителя — учётные данные, для использования которых достаточно владеть самим токеном без доказательства владения отдельным криптографическим ключом.

Также ищут: Bearer token · bearer-токен · предъявительский токен

Зачем это знать

Действующую строку на предъявителя защищают и при передаче, и в хранилище. Владение ею не отменяет проверку получателя, времени, полномочий и объекта.

Связи из словаря

Карта понятия

Токен на предъявителя
Доказательная часть

Что подтверждено

  1. Любая сторона, владеющая токеном на предъявителя, может использовать его без доказательства владения криптографическим ключом.

    Граница применимости: Свойства токена на предъявителя в OAuth 2.0.

  2. Токен рекомендуется передавать в заголовке Authorization; параметр запроса URI не рекомендуется, потому что URL часто попадает в журналы.

    Граница применимости: Передача токена на предъявителя по HTTP.

  3. TLS защищает передачу токена, но не стирает его копию из журнала. В закрытом примере посторонний получил действующий токен на предъявителя без иной привязки и может предъявить его до прекращения действия, если остальные условия запроса выполнены.

    Граница применимости: Редакторский сценарий утечки токена на предъявителя. Ограничения получателя, срока и доступа продолжают действовать; универсальный обход API не утверждается.

  4. Клиенту запрещено передавать токен на предъявителя несколькими способами в одном запросе. Дублирование одного секрета в заголовке Authorization и параметре URL не создаёт дополнительной защиты.

    Граница применимости: Способы передачи токена на предъявителя по RFC 6750, раздел 2. Предпочтение заголовка не отменяет TLS и защиты хранилищ.

  5. Предъявление действующего токена на предъявителя с правильным получателем ещё не разрешает произвольное действие. Ресурсный сервер проверяет достаточность полномочий и собственные правила для запрошенного объекта.

    Граница применимости: Редакторское разделение владения токеном, ошибок недостаточных полномочий RFC 6750 и прикладной защиты API.

Граница терминов

Не путать

Токен на предъявителя Токен с подтверждением владения

Токен на предъявителя предъявляют без связанного ключа; токен с подтверждением владения требует дополнительного криптографического доказательства.

Токен на предъявителя Ключ API

Bearer описывает способ использования токена OAuth, apiKey — отдельную схему API. Оба секрета требуют защиты, а прикладные права задаются независимо.

Перед спецификацией

Что проверить

  1. Определите, является ли токен предъявительским.
  2. Используйте защищённый транспорт.
  3. Выберите один допустимый способ передачи.
  4. Избегайте размещения токена в URL.
  5. Исключите токены из журналов.
  6. Проверьте срок, получателя и доступ к объекту.
  7. При утечке обработайте прекращение действия токена.
Открытые основания

Первоисточники

  • Стандарт5
  • Первичная спецификация
    The OAuth 2.0 Authorization Framework: Bearer Token Usage Internet Engineering Task Force · RFC 6750, October 2012 · проверено

    Определяет bearer-token presentation, защиту от disclosure, Authorization header и ошибки invalid_token/insufficient_scope.

    Утверждения: 01 · 02 · 03 · 04 · 05

  • Первичная спецификация
    Best Current Practice for OAuth 2.0 Security Internet Engineering Task Force · RFC 9700, January 2025 · проверено

    Актуализирует OAuth security: exact redirect matching, PKCE, sender-constrained tokens и безопасный refresh-token lifecycle.

    Утверждения: 03

  • Первичная спецификация
    Guidelines for API Protection for Cloud-Native Systems National Institute of Standards and Technology · NIST SP 800-228-upd1, includes updates as of 13 March 2026 · проверено

    Задаёт API lifecycle controls для authentication, authorization, rate limits, resource limits, logging и monitoring.

    Утверждения: 05

  • Первичная спецификация
    OAuth 2.0 Demonstrating Proof of Possession Internet Engineering Task Force · RFC 9449, September 2023 · проверено

    Определяет application-layer proof-of-possession и sender-constrained tokens с защитой от replay.

  • Первичная спецификация
    OpenAPI Specification v3.1.1 OpenAPI Initiative · OpenAPI Specification 3.1.1, 24 October 2024 · проверено

    Определяет API security schemes, включая apiKey в header/cookie/query, mutualTLS, OAuth 2.0 и OpenID Connect.

Карта знаний

Связанные понятия

Из знания — в навык

Курсы по теме

Подтвердите действие