Рабочий SSO в браузере не доказывает, что мобильное приложение войдёт тем же способом. Native app — публичный OAuth client: он не умеет безопасно хранить общий client secret и не должен собирать пароль во встроенной форме. Вход открывается в системном браузере, затем зарегистрированная ссылка возвращает authorization code приложению.

Сначала исключите WebView и проверьте полный Authorization Code flow с PKCE. Если браузер уже имеет сессию провайдера, пароль может не потребоваться — это и есть эффект SSO. Но приложение всё равно генерирует state/verifier, получает собственный code, обменивает его и проверяет ответ.

Один вход состоит из шести проверяемых переходов

ШагКонтрольное значениеГде ломается
discoveryissuer и endpointsдругой tenant/environment
authorizeclient_id, redirect_uri, state, code_challengeошибка регистрации клиента
browser sessionсессия IdPWebView изолировал cookies
app redirectточный scheme/host/pathссылка открыла не тот пакет
token exchangecode_verifier и тот же redirect_uriinvalid_grant/PKCE mismatch
validationiss, aud, nonce, exp, signatureпринят токен другого issuer/client

У каждого запуска входа свой correlation ID. В журнал попадают названия этапов, fingerprint конфигурации и коды ошибок, но не authorization code, token, verifier или содержимое пользовательских claims.

PKCE связывает authorize и token exchange

verifier  = random high-entropy value kept only for this attempt
challenge = BASE64URL(SHA256(verifier))

GET /authorize?
  response_type=code&client_id=mobile&
  redirect_uri=https%3A%2F%2Fapp.example.com%2Foauth%2Fcallback&
  code_challenge=...&code_challenge_method=S256&state=...&nonce=...

POST /token
  grant_type=authorization_code&code=...&
  redirect_uri=https%3A%2F%2Fapp.example.com%2Foauth%2Fcallback&
  code_verifier=...

RFC 7636 определяет verifier и challenge; RFC 8252 требует PKCE для public native clients. Verifier хранится до callback в контексте конкретной попытки входа. Если приложение перезапустилось и потеряло его, повторный обмен не чинят отключением PKCE — вход начинают заново с понятным сообщением.

Redirect должен принадлежать приложению, а не любому обработчику

RFC 8252 описывает private-use scheme, claimed HTTPS URI и loopback URI для desktop-сценариев. Для iOS/Android предпочтительна платформа-подтверждаемая HTTPS-ссылка, когда инфраструктура это позволяет: она уменьшает риск перехвата другим приложением. Redirect URI регистрируют точной строкой и передают одинаково на authorize и token endpoints.

  • Проверьте release package/bundle ID и production association-файлы домена.
  • Не помещайте access token или ID Token в redirect URI.
  • Не продолжайте вход, если state не совпал или отсутствует сохранённый verifier.
  • Обрабатывайте повторный callback идемпотентно: один code обменивается один раз.
  • Не разрешайте произвольный post-login URL из непроверенного query-параметра.

Discovery защищает от смешивания окружений

OpenID Connect Discovery публикует конфигурацию по `/.well-known/openid-configuration`. Полученный `issuer` должен точно совпасть с ожидаемым issuer и с `iss` в ID Token. Мобильный dev-клиент, случайно направленный на production authorize и staging token endpoint, часто заканчивает `invalid_grant` или ошибкой подписи.

Не собирайте URL endpoints строками из нескольких настроек. Храните один доверенный issuer на environment, получайте metadata, проверяйте точное значение issuer и используйте одну конфигурацию в пределах попытки входа.

Симптом показывает границу ответственности

СимптомВероятный слойСледующая проверка
браузер вошёл, приложение не открылосьApp/Universal Linkassociation, package, полный callback URL
приложение открылось, state mismatchлокальное состояниеодна ли попытка входа и сохранён ли state
invalid_granttoken exchangecode reuse, verifier, redirect URI, issuer
ID token rejectedOIDC validationJWKS, iss, aud, nonce, часы устройства/backend
каждый раз просит парольbrowser/IdP sessionвнешний ли user-agent и не принуждает ли prompt
вход есть, API отвечает 401ресурсный APIaudience/scope access token и backend session

Матрица входа включает отмену и перезапуск

  1. Войти при закрытом приложении и живой browser session IdP.
  2. Повторить без сессии IdP и пройти полный login/MFA.
  3. Отменить системный браузер и убедиться, что попытка не остаётся pending.
  4. Убить приложение между authorize и callback, проверить безопасное восстановление либо новый старт.
  5. Отправить старый callback повторно: новая сессия не должна появиться.
  6. Проверить два environment и два tenant без смешивания issuer/JWKS.
  7. Истечь локальную сессию приложения и восстановить её через живую сессию IdP.

Для разбора нужны issuer, client ID, зарегистрированные redirect URI, platform association, обезличенная последовательность этапов и точный OAuth error. Client secret, code, verifier, refresh/access/ID tokens не присылайте. Исправление подтверждает не только первый вход, но отмену, повтор callback и восстановление после перезапуска.

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