В этом документе описывается, как интегрировать Credential Manager API с приложением Android, в котором используется WebView. Менеджер учетных данных поддерживается в библиотеке android.webkit.WebView версии 1.12.0 и более поздних.
Требования
Чтобы использовать Менеджер учетных данных в WebView, добавьте в скрипт сборки модуля приложения следующие зависимости:
dependencies {
implementation("androidx.credentials:credentials:1.6.0-beta02")
implementation("androidx.credentials:credentials-play-services-auth:1.6.0-beta02")
implementation("androidx.webkit:webkit:1.14.0")
}
Вам также потребуется связать приложение с сайтом, который ему принадлежит, используя протокол Digital Asset Links. Подробнее о том, как добавить связь с цифровыми объектами…
Используйте библиотеку WebKit
Чтобы использовать библиотеку WebKit, проверьте поддержку функций, а затем включите поддержку, вызвав setWebAuthenticationSupport():
class WebViewActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
// Put your webview link here.
val url = "https://project-sesame-426206.appspot.com/passkey-signup"
AndroidView(
factory = { context ->
WebView(context).apply {
settings.javaScriptEnabled = true
webViewClient = WebViewClientImpl()
}
},
update = { webView ->
run {
webView.loadUrl(url)
if (WebViewFeature.isFeatureSupported(WebViewFeature.WEB_AUTHENTICATION)) {
WebSettingsCompat.setWebAuthenticationSupport(
webView.settings,
WebSettingsCompat.WEB_AUTHENTICATION_SUPPORT_FOR_APP,
)
// Check if getWebauthenticationSupport may have been disabled by the WebView.
Log.e(
"WebViewPasskeyDemo",
"getWebAuthenticationSupport result: " + WebSettingsCompat.getWebAuthenticationSupport(
webView.settings
),
)
} else {
Log.e("WebViewPasskeyDemo", "WebView does not support passkeys.")
}
}
},
)
}
}
}
Интеграция с сайтом
Чтобы узнать, как создать интеграцию с сайтом, прочитайте статью Как создать ключ доступа для входа без пароля. Вы также можете ознакомиться с исходным кодом демонстрационного сайта.
Тестирование и развертывание
Тщательно протестируйте весь процесс в контролируемой среде, чтобы убедиться в правильности взаимодействия между приложением Android, веб-страницей и серверной частью.
Разверните интегрированное решение в рабочей среде и убедитесь, что серверная часть может обрабатывать входящие запросы на регистрацию и аутентификацию. Код бэкенда должен генерировать исходный JSON для процессов регистрации (создания) и аутентификации (получения). Кроме того, оно должно проверять ответы, полученные от веб-страницы.
Убедитесь, что реализация соответствует рекомендациям по UX.