اصالت‌سنجی کاربران با «وب‌نما»

این سند نحوه ادغام Credential Manager API با برنامه Android را که از WebView استفاده می‌کند شرح می‌دهد. «مدیر اطلاعات کاربری» به‌طور پیش‌فرض در کتابخانه android.webkit.WebView در نسخه ۱.۱۲.۰ و نسخه‌های جدیدتر پشتیبانی می‌شود.

پیش‌نیازها

برای استفاده از «مدیر اطلاعات کاربری» در 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")
}

همچنین باید برنامه‌تان را بااستفاده از پیوند دارایی دیجیتال به وب‌سایتی که برنامه‌تان مالک آن است منسوب کنید. برای اطلاعات بیشتر، افزودن پیوند دارایی دیجیتال را ببینید.

استفاده از کتابخانه 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 اولیه را برای فرایندهای ثبت‌نام (ایجاد) و اصالت‌سنجی (دریافت) تولید کند. همچنین باید اعتبار سنجی و درستی‌سنجی پاسخ‌های دریافتی از صفحه وب را مدیریت کند.

تأیید کنید که پیاده‌سازی با توصیه‌های تجربه کاربری مطابقت دارد.