Ресурсы · 43
OAuth и OpenID Connect: проверка интеграции от начала до конца
Разделение прав доступа при входе в систему, делегировании и передаче данных, затем тестирование перенаправлений, токенов, сессий и отзыва.
Обновлено · 8 min
Чего помогает достичь это руководство
- Разделение идентификации и авторизации.
- Отклонение непреднамеренных перенаправлений и токенов.
- Тщательное тестирование отказов и успешных действий.
- Проверка удаления доступа после ухода или инцидента.
Быстрая проверка
- Какой поставщик и эмитент ожидаются?
- Точно ли зарегистрирован URI перенаправления?
- Не используется ли токен идентификации ошибочно в качестве токена доступа?
- Проверяет ли каждый ресурс право собственности?
- Какой доступ сохраняется после отзыва?
Пошаговый метод
- 1
Схема развернутого потока.
Идентификация публичного или конфиденциального клиента, браузера, сервера авторизации, API и поставщика OIDC. Зафиксируйте, куда перемещаются коды и токены, кто их хранит и какие роли предоставлены. Схема продаж не отражает фактическое развертывание.
Результат: поток, границы доверия и владельцы компонентов.
- 2
Проверка транзакции входа в систему.
Используйте поток кода с PKCE, соответствующим клиенту. Проверьте S256, привязку транзакций, зарегистрированные перенаправления и защиту от поддельных запросов. Протестируйте неожиданный URI, некорректный верификатор, воспроизведенный код и неожиданного эмитента. RFC 9700 разделяет требования и рекомендации по типу клиента.
Результат: разрешенные и запрещенные результаты тестирования.
- 3
Проверка правильности токена.
API проверяет свой токен доступа в соответствии с форматом и правилами поставщика: подпись или интроспекция, эмитент, аудитория, срок действия и разрешения. Клиент OIDC отдельно проверяет токен идентификации. Действительная подпись не подтверждает принадлежность токена этому API.
Результат: проверка контракта, аудитории и тестов на истечение срока действия.
- 4
Проверка прав доступа.
Тестирование объекта, принадлежащего другой учетной записи, роли более низкого уровня, закрытого поля и административной операции. Область действия или аутентифицированный шлюз не заменяют серверные проверки запрашиваемого ресурса. Используйте авторизованные тестовые учетные записи и данные.
Результат: матрица ролей, объектов, операций и ожидаемых отказов.
- 5
Проверка истечения срока действия и отзыва.
Разделение локальной сессии, сессии поставщика, токена доступа и токена обновления. Тестирование выхода из системы, потери устройства, изменения роли, ротации ключа подписи и сбоя поставщика. Документирование остаточного времени доступа вместо предположения, что выход из системы немедленно отзывает все.
Результат: временная шкала удаления доступа и исключения.
- 6
Наблюдение без раскрытия секретов.
Журналирование ссылки на транзакцию, решения о проверке, категории ошибки и версии конфигурации. Исключить коды, токены и секреты. Подготовить диагностику, завершить интеграцию и откатить к проверенной конфигурации; повторно запустить тесты после изменения поставщика. Результат
Результат: рабочая процедура и регрессионные проверки.
Вымышленный пример
Иллюстративная ситуация
Показательная ситуация: два клиента используют одного поставщика идентификации. Токен, действительный для первого, предоставляется API второго клиента.
Решение и ожидаемые доказательства
API отклоняет неправильную аудиторию, записывает трассировку без токена и не возвращает данных. Отказ становится регрессионным тестом.
Различение механизмов
| Механизм | Назначение | Проверка или ограничение |
|---|---|---|
| OAuth 2.0 | Делегирование доступа к ресурсам | Разрешения объектов на стороне сервера |
| OpenID Connect | Установление личности с помощью проверенного токена ID | Проверка эмитента, аудитории и транзакции |
| Сессия приложения | Поддержание авторизации приложения | Истечение срока действия, аннулирование и защита сессии |
Показатели управления
| Показатель | Что он измеряет | Первое действие |
|---|---|---|
| Исправление отказов | Запрещенные случаи фактически блокируются | Исправление каждого неожиданного принятия |
| Задержка отзыва | Время до исчезновения соответствующего доступа | Проверка сессий и токенов отдельно |
| Сбои проверки | Отклонения по причине и версии | Разделение атак и ошибок конфигурации |
Распространенные ошибки
- Путаница аутентификации с авторизацией
- Принятие любой аудитории после проверки подписи
- Регистрация широкого перенаправления URI
- Ведение журнала токенов для упрощения отладки
Часто задаваемые вопросы
Заменяет ли PKCE все элементы управления?
Нет. Он защищает обмен кодом в предполагаемом потоке; проверка токенов, перенаправления, авторизация бизнеса и сессии по-прежнему требуют проверки.
Является ли JWT разрешением?
JWT — это формат. Утверждения становятся пригодными для использования только после проверки и применения правил вашего API.
Следует ли создавать проверку с нуля?
Предпочтительнее использовать поддерживаемую библиотеку и документацию поставщика, а затем протестировать свою конфигурацию. Правильная библиотека все еще может быть настроена неправильно.
Какие доказательства сохранять для полезной проверки?
Сохраните контекст учётной записи, роли, ресурс и ответы API. Успешный вход не доказывает правильные права; не записывайте секреты сеанса.
OAuth/OIDC: адресат и доступ
Подробные справочные заметки в этой версии доступны на английском.
Which token belongs to which recipient? A testable validation contract
A secure OAuth/OIDC integration connects each token to its purpose, issuer and intended recipient. An ID token tells the OIDC client about authentication; an access token is presented to a protected resource. Successful sign-in alone does not authorise a read, a change or an AI agent’s tool call.
This reference covers a specific profile: an API consuming JWT access tokens under RFC 9068. OAuth 2.0 does not require every access token to use JWT. Clients must treat their access tokens as opaque; the resource server owns the validation contract. The examples below are fictional, with no secret or usable signature.
Four objects with distinct purposes
| Object | Recipient and purpose | Boundary to retain |
|---|---|---|
| Authorisation code | Authorisation server token endpoint: redeem the code within the intended transaction. | The code is not an API permission; check binding to the client, redirect and PKCE. |
| ID token | OIDC client: validate identity and transaction; aud contains its client_id. | Do not reuse it as an API access credential; apply the OIDC rules for the relevant flow. |
| Access token | Resource server: access within the grant; its audience identifies the intended resource. | Validate the token, then operation and object permissions. The client must not depend on its internal content. |
| Refresh token | Authorisation server token endpoint: obtain new access tokens. | Do not send it to the resource server; its lifecycle differs from the local session. |
Eight controls for the validation contract
| Control | Rule and scope | Evidence without tokens |
|---|---|---|
| Profile and typ | For RFC 9068, check typ = at+jwt or application/at+jwt. Other profiles need their own rules; “any signed JWT” is too broad a contract. | Configured profile and a rejected ID/access token confusion case. |
| Algorithm and keys | Verify the signature with the expected issuer’s keys and algorithms allowed by configuration. RFC 9068 excludes alg = none; a received value does not set policy by itself. | Cryptographic policy version and result, with no secret material. |
| Issuer iss | Compare exactly with the expected issuer. A similar host, path or suffix does not establish trust. | Configuration reference and issuer_mismatch reason. |
| Audience aud | The expected recipient must appear in aud. An audience array is possible; finding the recipient does not replace other checks. | Expected resource and a test using a token intended for another API. |
| Expiry exp | Current time must precede exp; any small clock leeway is an explicit policy. The teaching fixture uses zero seconds of leeway. | Test clock, configured leeway and an exercised expiry boundary. |
| Scopes and object | Bind each scope to the resource and operation. Then check ownership, tenant and business policy on the server. RFC 9068 does not define all this authorisation. | Action, test object, applied rule and a cross-tenant denial. |
| OIDC transaction and PKCE | If nonce was sent, verify its presence and equality in the ID token. RFC 9700 requires PKCE for public clients and recommends it for confidential clients; bind the challenge to the transaction, with S256 recommended. | Wrong nonce, replayed code and wrong code_verifier tests in the authorised flow. |
| Access lifetime and removal | Separate access-token expiry, renewal and application session. RFC 9700 requires sender constraint or rotation to detect refresh-token replay for public clients. | Residual access timeline, user departure and an exercised revocation procedure. |
Read fictional claims without treating them as proof
Teaching clock: 2026-10-22 at 10:00:00 UTC. The JSON contains a readable header and claims only; no signed JWT serialization is supplied. exp is 10:05:00 UTC and iat is 09:59:00 UTC. The .example domains and identifiers belong solely to this scenario.
{
"header": {
"typ": "at+jwt",
"alg": "RS256",
"kid": "training-key-01"
},
"claims": {
"iss": "https://identity.example/",
"sub": "training-subject-17",
"aud": "https://api.example/evidence",
"exp": 1792663500,
"iat": 1792663140,
"jti": "training-event-001",
"client_id": "training-console",
"scope": "evidence:read"
}
}Decoding JSON does not validate a signature or establish trust in keys. Where stated, cryptography is an exercise assumption, never a check performed by this page. The profile also has required claims including sub, client_id, iat and jti: the eight-control table is not a complete validator. A subject does not necessarily identify a person; jti alone does not implement replay protection.
Ten review cases: decision, limit and expected evidence
01 · Token intended for the API: continue to business checks
Situation: iss, aud, typ and exp match the fictional contract; evidence:read is present. Signature verification is assumed solely for the exercise.
Decision: continue to operation and object checks, without automatically declaring “access allowed”. Expected evidence: business rule and test object reviewed separately.
02 · Assumed correct signature, wrong audience
Change: aud targets https://api.example/billing rather than the evidence resource. Other assumptions remain the same.
Decision: reject this token for this API. A correct signature does not change its recipient. Expected evidence: no resource content returned and a token-free audience failure record.
03 · Different issuer with plausible claims
Change: iss is https://other-identity.example/. An HTTPS URL does not make it equivalent to the configured issuer.
Decision: reject the issuer match. Expected evidence: exact comparison with https://identity.example/ and a regression test.
04 · Expiry reached at the exact second
Change: exp equals the test clock, 10:00:00 UTC, with zero seconds of leeway in this fixture.
Decision: reject as expired. “Now is before exp” is false at equality; this example does not establish a universal clock policy. Expected evidence: tests before, at and after the boundary under the real policy.
05 · ID token presented as an access token
Change: a fictional ID token has typ = JWT and aud = training-console. It targets the OIDC client.
Decision: reject it as an RFC 9068 JWT access token. Validating it at the OIDC client does not turn it into an access token. Expected evidence: separate validation rules for each token type.
06 · Write scope presented for a read operation
Change: scope is evidence:write while the call requires evidence:read.
Decision: deny the read under the exercise policy, which defines no write → read implication. Scope names and relationships belong to the contract. Expected evidence: an explicit operation/scope matrix, without inferring permissions from names.
07 · Readable JSON, unverified cryptography
Situation: the JSON is readable and values appear to match, but cryptographic validation and trusted keys are not established.
Decision: stop acceptance; the state is unverified. Expected evidence: configured library output and trust-contract checks. Reading claims alone must not release protected data.
08 · Correct token, another tenant’s object
Situation: test token checks are assumed to pass. The requested object belongs to another tenant and business policy denies this read.
Decision: deny the object. evidence:read does not grant access to every account’s evidence. Expected evidence: server-side cross-tenant test and no leakage through content or returned fields.
09 · Audience array containing the expected resource
Change: aud contains https://api.example/evidence and https://api.example/archive. The expected resource is listed.
Decision: this audience check can pass; continue all other checks. An array is not a wildcard. Expected evidence: scopes remain meaningful for the resource, with no ambiguous grant.
10 · ID token nonce differs from the transaction
Separate OIDC transaction, outside the API cases: sent nonce = training-transaction-A; received nonce = training-transaction-B.
Decision: reject the ID token for this transaction under OIDC Core §3.1.3.7. This does not replace PKCE or API rules. Expected evidence: compare with the original transaction and test missing nonce when one was sent.
Six useful acceptance-review records
- Map clients, issuers, APIs and expected audiences, with an owner for each boundary.
- Versioned validation contract: format, libraries, trusted keys, algorithms and clock leeway.
- Action, scope, tenant and object matrix; state denials and the permission implications actually defined.
- Synthetic fixtures, a fixed clock, negative variants and observed results in the authorised environment.
- Separate session, access-token and refresh-token timelines during departure, revocation and provider outage.
- Redacted log: internal transaction reference, policy version, decision reason and date; exclude tokens, codes and secrets.
Primary sources and reading scope
- IETF · RFC 9700 · OAuth 2.0 Security BCP · BCP 240 · January 2025
§2.1.1 PKCE · §2.2 replay · §2.3 privilege restriction · §4.14 refresh tokens - IETF · RFC 9068 · JWT access token profile · Standards Track · October 2021
§2.1 typ · §2.2 claims · §4 validation · §6 client treats access tokens as opaque - OpenID Foundation · OpenID Connect Core 1.0 · Final · incorporating errata set 2 · 2023-12-15
§2 ID Token · §3.1.3.7 issuer, audience, expiry and nonce - IETF · RFC 8725 · JWT Best Current Practices · BCP 225 · February 2020
§3.1 algorithms · §3.8–3.9 issuer and audience · §3.11–3.12 token type separation - IETF · RFC 6749 · OAuth 2.0 framework · Standards Track · October 2012 · read with RFC 9700
§1.3.1 authorization code · §1.4 access token · §1.5 refresh token · §3.3 scope
Sources reviewed on
Официальные ссылки
Ссылки подтверждают метод. Адаптируйте проверки к вашему контексту; они не являются сертификацией. Оригинальные названия ссылок и исходные документы могут быть на другом языке.
Источники проверены .
