Рабочий SSO в браузере не доказывает, что мобильное приложение войдёт тем же способом. Native app — публичный OAuth client: он не умеет безопасно хранить общий client secret и не должен собирать пароль во встроенной форме. Вход открывается в системном браузере, затем зарегистрированная ссылка возвращает authorization code приложению.
Сначала исключите WebView и проверьте полный Authorization Code flow с PKCE. Если браузер уже имеет сессию провайдера, пароль может не потребоваться — это и есть эффект SSO. Но приложение всё равно генерирует state/verifier, получает собственный code, обменивает его и проверяет ответ.
Один вход состоит из шести проверяемых переходов
| Шаг | Контрольное значение | Где ломается |
|---|---|---|
| discovery | issuer и endpoints | другой tenant/environment |
| authorize | client_id, redirect_uri, state, code_challenge | ошибка регистрации клиента |
| browser session | сессия IdP | WebView изолировал cookies |
| app redirect | точный scheme/host/path | ссылка открыла не тот пакет |
| token exchange | code_verifier и тот же redirect_uri | invalid_grant/PKCE mismatch |
| validation | iss, 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 Link | association, package, полный callback URL |
| приложение открылось, state mismatch | локальное состояние | одна ли попытка входа и сохранён ли state |
| invalid_grant | token exchange | code reuse, verifier, redirect URI, issuer |
| ID token rejected | OIDC validation | JWKS, iss, aud, nonce, часы устройства/backend |
| каждый раз просит пароль | browser/IdP session | внешний ли user-agent и не принуждает ли prompt |
| вход есть, API отвечает 401 | ресурсный API | audience/scope access token и backend session |
Матрица входа включает отмену и перезапуск
- Войти при закрытом приложении и живой browser session IdP.
- Повторить без сессии IdP и пройти полный login/MFA.
- Отменить системный браузер и убедиться, что попытка не остаётся pending.
- Убить приложение между authorize и callback, проверить безопасное восстановление либо новый старт.
- Отправить старый callback повторно: новая сессия не должна появиться.
- Проверить два environment и два tenant без смешивания issuer/JWKS.
- Истечь локальную сессию приложения и восстановить её через живую сессию IdP.
Для разбора нужны issuer, client ID, зарегистрированные redirect URI, platform association, обезличенная последовательность этапов и точный OAuth error. Client secret, code, verifier, refresh/access/ID tokens не присылайте. Исправление подтверждает не только первый вход, но отмену, повтор callback и восстановление после перезапуска.