W tym dokumencie opisujemy, jak zintegrować interfejs Credential Manager API z aplikacją na Androida, która korzysta z WebView. Credential Manager jest obsługiwany natywnie w bibliotece android.webkit.WebView w wersji 1.12.0 i nowszych.
Wymagania wstępne
Aby używać Credential Manager w komponencie WebView, dodaj do skryptu kompilacji modułu aplikacji te zależności:
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")
}
Musisz też powiązać aplikację z witryną, która jest jej własnością, za pomocą połączenia zasobów cyfrowych. Więcej informacji znajdziesz w artykule o dodawaniu powiązań zasobów cyfrowych.
Korzystanie z biblioteki WebKit
Aby używać biblioteki WebKit, sprawdź, czy funkcja jest obsługiwana, a następnie włącz obsługę, wywołując 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.")
}
}
},
)
}
}
}
Integracja z witryną
Aby dowiedzieć się, jak utworzyć integrację z siecią, przeczytaj artykuł Tworzenie klucza dostępu do logowania bez hasła. Możesz też zapoznać się ze źródłem witryny demonstracyjnej.
Testowanie i wdrażanie
Przetestuj dokładnie cały proces w kontrolowanym środowisku, aby sprawdzić, czy komunikacja między aplikacją na Androida, stroną internetową i backendem przebiega prawidłowo.
Wdróż zintegrowane rozwiązanie w środowisku produkcyjnym i sprawdź, czy backend może obsługiwać przychodzące żądania rejestracji i uwierzytelniania. Kod backendu powinien generować początkowy kod JSON na potrzeby procesów rejestracji (tworzenia) i uwierzytelniania (pobierania). Powinna też obsługiwać sprawdzanie i weryfikację odpowiedzi otrzymanych ze strony internetowej.
Sprawdź, czy implementacja jest zgodna z zaleceniami dotyczącymi wygody użytkowników.