Bu dokümanda, Credential Manager API'nin WebView kullanan bir Android uygulamasıyla nasıl entegre edileceği açıklanmaktadır. Kimlik Bilgisi Yöneticisi, 1.12.0 ve sonraki sürümlerde android.webkit.WebView kitaplığında yerel olarak desteklenir.
Ön koşullar
WebView'da Kimlik Bilgisi Yöneticisi'ni kullanmak için uygulama modülünüzün derleme komut dosyasına aşağıdaki bağımlılıkları ekleyin:
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")
}
Ayrıca, dijital öğe bağlantısını kullanarak uygulamanızı, uygulamanızın sahip olduğu bir web sitesiyle ilişkilendirmeniz gerekir. Daha fazla bilgi için dijital öğe bağlantısı ekleme başlıklı makaleyi inceleyin.
WebKit kitaplığını kullanma
WebKit kitaplığını kullanmak için özellik desteğini kontrol edin ve ardından setWebAuthenticationSupport() yöntemini çağırarak desteği etkinleştirin:
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.")
}
}
},
)
}
}
}
Web entegrasyonu
Web entegrasyonu oluşturmayı öğrenmek için Şifresiz girişler için geçiş anahtarı oluşturma başlıklı makaleyi inceleyin. Demo site kaynağına da bakabilirsiniz.
Test ve dağıtım
Android uygulaması, web sayfası ve arka uç arasında doğru iletişimin kurulduğunu doğrulamak için tüm akışı kontrollü bir ortamda kapsamlı bir şekilde test edin.
Entegre çözümü üretime dağıtarak arka ucun gelen kayıt ve kimlik doğrulama isteklerini işleyebildiğini doğrulayın. Arka uç kodu, kayıt (oluşturma) ve kimlik doğrulama (alma) işlemleri için ilk JSON'u oluşturmalıdır. Ayrıca, web sayfasından alınan yanıtların doğrulanması ve onaylanması işlemlerini de gerçekleştirmelidir.
Uygulamanın kullanıcı deneyimi önerilerine uygun olduğunu doğrulayın.