Сначала установите, отсутствует ли refresh_token в ответе token endpoint или он исчезает уже в вашем SDK и хранилище. Это разные неисправности. На разрешённом тестовом клиенте фиксируйте только наличие поля и этап обработки, без самого токена. Повторный вход наугад может скрыть причину, изменив сохранённое согласие.
Успешный вход не обещает фоновый доступ
ID Token подтверждает результат идентификации, access token нужен для обращения к ресурсу, а refresh token позволяет запрашивать новый access token. Не подставляйте один тип вместо другого. Требование «пользователь вошёл» отдельно от требования «фоновая задача сможет обращаться к API после его ухода».
OpenID Connect Core 1.0 с errata set 2 описывает offline_access как запрос offline-доступа и связывает его с возвратом authorization code и согласием. prompt=consent требуется, если нет других допустимых оснований обработки такого запроса. Источник проверен 25 октября 2026 года. Провайдер может выдавать refresh token и в других контекстах; универсального обещания выдачи на каждый вход нет.
| Наблюдение | Где продолжить |
|---|---|
| Нет code в выбранном flow | Совместимость сценария offline access |
| offline_access отсутствует | Формирование authorization request |
| Провайдер не выдал поле | Политика клиента и согласие |
| Поле было, SDK не вернул | Контракт библиотеки и версия |
| SDK вернул, после сохранения пусто | Запись и последующее чтение |
Безопасная трасса показывает присутствие, а не значение
Условные диагностические признаки:
authorize: requested_offline_access=true
flow: authorization_code
token_response: has_refresh_token=true
sdk_result: has_refresh_token=true
storage_write: completed=true
background_job: credential_reference_found=trueТакая трасса не заменяет проверку протокола. Она локализует потерю уже после выдачи. Если поле отсутствует на первой границе, бессмысленно чинить сериализацию базы. Если оно есть до SDK, сравните документированный результат библиотеки с вашим адаптером: часть библиотек хранит учётные данные внутри своего token cache. Не извлекайте их в браузер только ради удобства просмотра.
Сравнивайте один и тот же client_id, tenant или issuer и тип клиента. Разрешение в тестовой регистрации не доказывает настройку production. Дополнительные параметры конкретного провайдера берите из его руководства: чужой пример с access_type или специальным grant-флагом не становится общим параметром OIDC.
Проверка согласия требует управляемого эксперимента
- Записать ожидаемый сценарий: интерактивный вход или фоновая работа.
- Сверить flow, scopes и политику тестового клиента.
- Проверить первый вход с предусмотренным согласием.
- Повторить вход и сравнить наличие поля на тех же границах.
- Проверить отказ в offline-доступе без бесконечного повторного запроса согласия.
Сбрасывать согласия всех рабочих пользователей ради эксперимента нельзя. Используйте отдельную разрешённую учётную запись и фиксируйте исходное состояние. Если политика запрещает нужный доступ, интерфейс должен объяснить ограничение или предложить предусмотренный интерактивный сценарий, а не создавать цикл входа при каждом открытии страницы.
Появление поля не завершает реализацию фоновой работы. Нужны защищённое хранение, обработка отзыва и правила замены учётных данных по документации провайдера. Поведение при ротации и конкурирующих обновлениях проверяют отдельно; здесь диагностируется первичная выдача. Не затирайте существующие данные пустым полем повторного ответа без понимания контракта.
На разбор принесите название провайдера, flow, scopes, версию SDK и карту has_refresh_token по этапам. Токены, authorization code и client secret не нужны. По этой карте сразу видно, кто должен исправлять проблему: администратор политики, автор authorization request или обработчик ответа приложения.