In diesem Dokument wird beschrieben, wie Sie die Credential Manager API in eine Android-App einbinden, die WebView verwendet. Der Credential Manager wird in der android.webkit.WebView-Bibliothek ab Version 1.12.0 nativ unterstützt.
Vorbereitung
Wenn Sie den Credential Manager in WebView verwenden möchten, fügen Sie dem Build-Script Ihres App-Moduls die folgenden Abhängigkeiten hinzu:
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")
}
Außerdem müssen Sie Ihre App über die Verknüpfung digitaler Assets mit einer Website verknüpfen, die zu Ihrer App gehört. Weitere Informationen finden Sie unter Verknüpfung digitaler Assets hinzufügen.
WebKit-Bibliothek verwenden
Wenn Sie die WebKit-Bibliothek verwenden möchten, prüfen Sie, ob die Funktion unterstützt wird, und aktivieren Sie dann die Unterstützung, indem Sie setWebAuthenticationSupport() aufrufen:
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.")
}
}
},
)
}
}
}
Webintegration
Informationen zum Erstellen einer Webintegration finden Sie unter Passkey für die passwortlose Anmeldung erstellen. Sie können auch die Quelle der Demowebsite aufrufen.
Testen und bereitstellen
Testen Sie den gesamten Ablauf gründlich in einer kontrollierten Umgebung, um die ordnungsgemäße Kommunikation zwischen der Android-App, der Webseite und dem Backend zu überprüfen.
Stellen Sie die integrierte Lösung in der Produktion bereit und prüfen Sie, ob das Backend eingehende Registrierungs- und Authentifizierungsanfragen verarbeiten kann. Der Backend-Code sollte die anfänglichen JSON-Daten für die Registrierung (Erstellen) und die Authentifizierung (Abrufen) generieren. Außerdem sollte es die Validierung und Verifizierung der von der Webseite empfangenen Antworten übernehmen.
Prüfen Sie, ob die Implementierung den UX-Empfehlungen entspricht.