เอกสารนี้อธิบายวิธีผสานรวม Credential Manager API กับแอป Android ที่ใช้ WebView ไลบรารี android.webkit.WebView รองรับ Credential Manager โดยค่าเริ่มต้นในเวอร์ชัน 1.12.0 ขึ้นไป
สิ่งที่ต้องมีก่อน
หากต้องการใช้ Credential Manager ใน WebView ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในสคริปต์บิลด์ของโมดูลแอป
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 เริ่มต้นสำหรับกระบวนการลงทะเบียน (สร้าง) และการตรวจสอบสิทธิ์ (รับ) นอกจากนี้ ยังควรจัดการการตรวจสอบความถูกต้องและการยืนยันการตอบกลับที่ได้รับจากหน้าเว็บด้วย
ตรวจสอบว่าการติดตั้งใช้งานเป็นไปตามคําแนะนําเกี่ยวกับ UX