Как выбрать подходящий способ реализации ключей доступа в приложении для Android

Ключи доступа стали стандартом безопасной и удобной аутентификации, и все больше сервисов внедряют их как на сайтах, так и в приложениях для Android. Однако когда вы начинаете добавлять ключи доступа в приложение Android, вы часто сталкиваетесь с ключевым архитектурным вопросом: вызываете ли вы нативные API напрямую, открываете ли существующую страницу входа в веб-браузере на вкладке браузера или запускаете ключи доступа внутри WebView в приложении?

Обзор

Поддержку ключей доступа в приложениях для Android можно реализовать тремя основными способами: с помощью Менеджера учетных данных, вкладки аутентификации и WebView. В официальной документации приведены пошаговые инструкции по реализации каждого варианта. Чтобы выбрать архитектуру, которая минимизирует неудобства для пользователей и при этом позволяет контролировать затраты на разработку и обслуживание, необходимо понимать характеристики и ограничения каждого варианта на высоком уровне. В этом руководстве объясняется, как выбрать правильный подход в зависимости от дизайна вашего приложения и существующей инфраструктуры аутентификации. В таблице ниже сравниваются эти подходы.

Функция Менеджер учетных данных Вкладка аутентификации WebView
Рекомендуемый вариант использования Приложения с нативным интерфейсом входа Повторное использование существующей веб-страницы входа или поставщика идентификационной информации OAuth или OpenID Connect (OIDC) Существующие гибридные приложения WebView (только собственный домен)
Интерфейс и удобство использования Интеграция с нижним экраном ОС и автозаполнением клавиатуры Специальная вкладка браузера для аутентификации Встроенная веб-страница с нижним экраном ОС
Автозаполнение и условный интерфейс Поддерживается (автозаполнение Менеджера учетных данных) Поддерживается (условный интерфейс WebAuthn) Не поддерживается
Обмен учетными данными и сеансами Ключи доступа используются на сайте и в приложении с помощью assetlinks.json и общего rpId (файлы cookie Chrome не используются). Передает в Chrome файлы cookie и данные об учетных данных (можно отключить, используя режим временного просмотра). Передает ключи доступа с помощью assetlinks.json, но изолирует файлы cookie и сеансы от Chrome.
Digital Asset Links (assetlinks.json) Обязательно для веб-домена доверяющей стороны Требуется в домене URI переадресации для переадресации HTTPS (рекомендуется вместо специальных схем, для которых он не требуется). Требуется в веб-домене проверяющей стороны (нельзя использовать со сторонними поставщиками идентификационной информации).

Менеджер учетных данных

Если в вашем приложении для Android есть встроенные экраны входа или регистрации, мы рекомендуем использовать библиотеку Jetpack Менеджера учетных данных.

Главное преимущество Менеджера учетных данных заключается в том, что он объединяет ключи доступа, пароли и функцию "Войти с аккаунтом Google" в единую оптимизированную систему. При входе пользователь проходит биометрическую аутентификацию одним нажатием, не выходя из приложения. Это упрощает процесс входа. Даже если пользователь закроет нижний экран и нажмет на поле ввода имени пользователя или пароля, вы можете использовать PendingGetCredentialRequest, чтобы показать ключи доступа, пароли и кнопку "Войти с аккаунтом Google" прямо на клавиатуре или в раскрывающемся списке подсказок автозаполнения. Этот резервный вариант обеспечивает встроенную интеграцию автозаполнения, эквивалентную условному интерфейсу WebAuthn.

Нижний экран Менеджера учетных данных с вариантами входа: ключ доступа, войти с аккаунтом Google и пароль.
Рисунок 1. Менеджер учетных данных объединяет ключи доступа, функцию "Войти с аккаунтом Google" и пароли в системном нижнем экране.

Менеджер учетных данных также обеспечивает полное соответствие функций современным возможностям жизненного цикла ключей доступа в интернете. С помощью Менеджера учетных данных вы можете:

Ключи доступа поддерживаются на устройствах с Android 9 (уровень API 28) и более поздними версиями. Другие учетные данные, например пароли, поддерживаются на устройствах с более ранними версиями Android через сервисы Google Play. В Android 14 (уровень API 34) и более поздних версиях Менеджер учетных данных также работает со сторонними поставщиками учетных данных, выбранными пользователем. Для дополнительных возможностей, таких как интеграция автозаполнения на основе View (PendingGetCredentialRequest) и Signal API, требуется Android 15 (уровень API 35) или более поздняя версия.

Обмен учетными данными между сайтом и приложением

Для начала выполните предварительные требования, чтобы разместить файл Digital Asset Links (assetlinks.json) в своем веб-домене и связать сайт с приложением для Android. Связывание сайта и приложения с помощью assetlinks.json означает, что у них будет один и тот же идентификатор проверяющей стороны (rpId). Таким образом, ключи доступа, созданные на сайте в Chrome, будут работать в нативном приложении для Android через Менеджер учетных данных, а ключи доступа, созданные в приложении, – на сайте. Менеджер учетных данных позволяет использовать одни и те же учетные данные на сайте и в приложении. Вкладка аутентификации нужна, только если вы хотите повторно использовать интерфейс входа на сайт или страницу поставщика идентификационной информации.

Как описано в разделе Создание ключа доступа, вам также необходимо настроить сервер для проверки источников приложений Android (android:apk-key-hash:ENCODED_SHA256_HASH, отформатированный с использованием хеша SHA-256 сертификата подписи APK, закодированного по алгоритму Base64URL без заполнителей). Если у вашего приложения нативный интерфейс и вы хотите, чтобы пользователи могли входить с помощью ключей доступа, выберите Менеджер учетных данных.

Вкладка аутентификации

Многие сервисы используют микросервис поставщика идентификационной информации (IdP), созданный на основе OAuth или OpenID Connect (OIDC), или хотят повторно использовать существующую страницу входа в веб-приложение с поддержкой ключа доступа в мобильных приложениях. Раньше для этого использовались специальные вкладки. Начиная с Chrome 137 и AndroidX Browser 1.9.0, вкладка аутентификации предоставляет специальную вкладку браузера, предназначенную для процессов аутентификации.

Вкладка Auth Tab с минималистичным интерфейсом входа в браузере без пунктов меню браузера общего назначения.
Рисунок 2. Вкладка аутентификации – это специальный интерфейс браузера, предназначенный для процессов аутентификации.

Стандартные специальные вкладки предназначены для использования в качестве встроенных браузеров общего назначения. Они содержат элементы интерфейса, не связанные со входом, например меню "Поделиться", закладки и кнопку Открыть в Chrome, которые могут отвлекать пользователей. Они также требуют объявления фильтров интентов в файле манифеста для получения перенаправлений после аутентификации, добавления шаблонного кода и защиты от перехвата интентов вредоносными приложениями.

Вкладка Auth Tab решает эти проблемы, связанные с аутентификацией. Она удаляет ненужные элементы интерфейса браузера, такие как кнопка сворачивания и меню общего доступа, и представляет собой сфокусированный интерфейс, содержащий только основные возможности входа, включая ключ доступа и автозаполнение пароля. Вместо маршрутизации через интенты ОС вкладка Auth Tab доставляет перенаправления аутентификации непосредственно в обратный вызов в приложении, используя либо специальную схему, либо URL по HTTPS, проверенный с помощью [протокола] связи цифровых объектов, что повышает безопасность и сокращает шаблон реализации.

Обмен сеансами и резервные пользовательские вкладки

По умолчанию вкладка Auth также передает файлы cookie и состояние учетных данных непосредственно в системный браузер Chrome. Это позволяет приложению использовать активные сеансы входа в Chrome и запускать существующую реализацию WebAuthn без изменений, включая условный интерфейс и режим немедленного интерфейса (веб-эквивалент preferImmediatelyAvailableCredentials Менеджера учетных данных). Если же вам нужен изолированный сеанс аутентификации, который не использует файлы cookie и историю браузера, вы можете включить режим инкогнито, вызвав AuthTabIntent.Builder.setEphemeralBrowsingEnabled(true).

Хотя вы добавляете в приложение androidx.browser:browser (версии 1.9.0 или более поздней), будет ли вкладка аутентификации работать во время выполнения, зависит от браузера по умолчанию. Если браузером по умолчанию является Chrome версии ниже 137 или сторонний браузер, который не поддерживает вкладку аутентификации, то вместо нее автоматически запускается стандартная пользовательская вкладка. В этом случае перенаправление после аутентификации выполняется через фильтр интентов в AndroidManifest.xml, как в стандартных пользовательских вкладках, а не через обратный вызов вкладки аутентификации (ActivityResultCallback). В рабочей среде мы рекомендуем либо заранее проверять поддержку браузера по умолчанию с помощью CustomTabsClient.isAuthTabSupported(context, provider), чтобы разветвить поток, либо сохранить фильтр интентов манифеста, чтобы приложение могло обрабатывать результаты из любого пути. Примеры реализации резервных вариантов можно найти в Android Browser Helper.

Требования к безопасности OAuth и OIDC

Вкладка Auth Tab защищает и упрощает только клиентский канал перенаправления из браузера обратно в ваше приложение; он не защищает автоматически сам протокол OAuth или OIDC. В частности, учитывая резервный вариант для специальных вкладок, необходимо следовать рекомендациям по использованию OAuth 2.0 в нативных приложениях (RFC 8252). В частности, используйте PKCE (Proof Key for Code Exchange, RFC 7636) с параметрами code_challenge и code_verifier, чтобы предотвратить перехват кода авторизации, проверку параметра state, чтобы предотвратить подделку межсайтовых запросов (CSRF) и атаки с фиксацией сеанса, а также генерацию и проверку параметра nonce в OpenID Connect, чтобы предотвратить атаки с повторным воспроизведением токена идентификатора. Поскольку эти средства защиты уже действуют, Google рекомендует перенести архитектуры веб-версии процесса входа со стандартных специальных вкладок на вкладки Auth.

WebView

Некоторые приложения созданы на основе гибридной архитектуры WebView, в которой невозможно выделить только экран входа в нативный интерфейс (Менеджер учетных данных) или вкладку браузера (вкладка Auth). В таких случаях вы можете включить поддержку WebAuthn непосредственно в WebView.

Чтобы использовать ключи доступа в WebView, добавьте в файл build.gradle библиотеку AndroidX WebKit (androidx.webkit:webkit версии 1.12.0 или более поздней) и зависимости Менеджера учетных данных (androidx.credentials:credentials и androidx.credentials:credentials-play-services-auth). Затем проверьте поддержку функции с помощью WebViewFeature.isFeatureSupported(WebViewFeature.WEB_AUTHENTICATION) и включите поддержку WebAuthn, вызвав WebSettingsCompat.setWebAuthenticationSupport(webView.settings, WebSettingsCompat.WEB_AUTHENTICATION_SUPPORT_FOR_APP). Эта конфигурация автоматически связывает запросы на создание ключей доступа и аутентификацию с веб-страниц в WebView с Менеджером учетных данных.

Ограничения домена и UX

Как и в случае со встроенными интеграциями Менеджера учетных данных, вам необходимо выполнить требования, чтобы разместить файл Digital Asset Links (assetlinks.json) в веб-домене полагающейся стороны и связать его с приложением. Ваш сервер получает android:apk-key-hash:ENCODED_SHA256_HASH (хеш сертификата SHA-256, закодированный в Base64URL) в качестве источника. Поскольку этот подход требует размещения assetlinks.json в домене проверяющей стороны, чтобы доверять сертификату подписи вашего приложения Android, он работает только в том случае, если вы контролируете веб-домен проверяющей стороны (собственный веб-вход). Если в процессе аутентификации пользователь перенаправляется к внешнему или стороннему поставщику идентификационной информации, где вы не можете разместить файл assetlinks.json для пакета приложения, вместо WebView необходимо использовать вкладку аутентификации или нативную функцию "Войти с аккаунтом Google" через Менеджер учетных данных.

Учитывайте два ограничения, связанных с UX и функциональностью: WebView не поддерживает условный интерфейс (автозаполнение mediation: "conditional", когда пользователь выбирает поле ввода) и не использует файлы cookie или сеансы входа совместно с системным браузером Chrome. Поэтому при разработке новых процессов аутентификации мы рекомендуем использовать Менеджер учетных данных или вкладку Auth. Однако если вы хотите добавить поддержку ключей доступа в существующее собственное гибридное приложение без серьезных изменений архитектуры, вы можете интегрировать ключи доступа с WebView.

Сводка

Выбор подхода к реализации ключей доступа зависит от текущего интерфейса и инфраструктуры аутентификации вашего приложения.

  • Если в вашем приложении есть нативный интерфейс входа и вы хотите, чтобы он был интегрирован с ОС без перехода в браузер, выберите Менеджер учетных данных, чтобы входить с помощью ключа доступа.
  • Если вы используете микросервис поставщика идентификационной информации OAuth или OIDC, перенаправляете пользователей к внешнему поставщику идентификационной информации или хотите повторно использовать существующую страницу входа в веб-сервис с поддержкой ключей доступа (включая условный интерфейс) и делиться активными сеансами браузера с Chrome, используйте вкладку аутентификации и реализуйте требования безопасности, описанные в OAuth 2.0 для нативных приложений (RFC 8252), в частности PKCE, state и nonce.
  • Если ваше приложение построено на гибридной архитектуре WebView, в которой вход должен выполняться на встроенных собственных веб-страницах, используйте WebView, учитывая отсутствие поддержки условного интерфейса и изолированных файлов cookie.

Дальнейшие действия