אימות משתמשים באמצעות WebView

במאמר הזה מוסבר איך לשלב את Credential Manager API באפליקציה ל-Android שמשתמשת ב-WebView. יש תמיכה מובנית ב-Credential Manager בספרייה android.webkit.WebView בגרסה 1.12.0 ואילך.

דרישות מוקדמות

כדי להשתמש ב-Credential Manager ב-WebView, צריך להוסיף את יחסי התלות הבאים לסקריפט ה-build של מודול האפליקציה:

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, דף האינטרנט וה-backend תקינה.

פורסים את הפתרון המשולב בסביבת הייצור, ומוודאים שה-backend יכול לטפל בבקשות נכנסות לרישום ולאימות. קוד הקצה העורפי צריך ליצור קובץ JSON ראשוני לתהליכי הרישום (יצירה) והאימות (אחזור). הוא צריך גם לטפל באימות של התגובות שמתקבלות מדף האינטרנט.

מוודאים שההטמעה תואמת להמלצות בנושא חוויית המשתמש.