Web Görünümü ile kullanıcı kimliklerini doğrulama

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.