เมื่อผู้ใช้สร้างพาสคีย์ เซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้องจะบันทึกรายละเอียดบางอย่างไว้ ส่วนผู้ให้บริการข้อมูลเข้าสู่ระบบ เช่น เครื่องมือจัดการรหัสผ่านบน Google จะบันทึกรายละเอียดอื่นๆ ดังนี้
- เซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้องจะบันทึกข้อมูลเข้าสู่ระบบคีย์สาธารณะ
- ผู้ให้บริการข้อมูลเข้าสู่ระบบจะบันทึกชื่อผู้ใช้ ชื่อที่แสดง คีย์ส่วนตัว และข้อมูลเมตาอื่นๆ ที่เกี่ยวข้อง ข้อมูลเมตานี้ช่วยให้ผู้ใช้ระบุและเลือกพาสคีย์ที่จำเป็นในระหว่างการลงชื่อเข้าใช้
ความไม่สอดคล้องกันที่อาจเกิดขึ้นระหว่างข้อมูลที่บันทึกไว้ในเซิร์ฟเวอร์ของฝ่ายที่信賴กับผู้ให้บริการข้อมูลเข้าสู่ระบบอาจส่งผลให้ผู้ใช้ได้รับประสบการณ์ที่ไม่ดี ปัญหาอาจเกิดขึ้นในสถานการณ์ต่อไปนี้
- ระบบลบข้อมูลเข้าสู่ระบบในเซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้อง แต่ไม่ได้ลบในผู้ให้บริการข้อมูลเข้าสู่ระบบ ซึ่งส่งผลให้ผู้ให้บริการข้อมูลเข้าสู่ระบบแสดงข้อมูลเข้าสู่ระบบที่ลบไปแล้วแก่ผู้ใช้
- มีการอัปเดตชื่อผู้ใช้หรือชื่อที่แสดงในเซิร์ฟเวอร์ของฝ่ายที่เชื่อถือ แต่ไม่ได้อัปเดตในผู้ให้บริการข้อมูลเข้าสู่ระบบ ซึ่งส่งผลให้ผู้ให้บริการข้อมูลเข้าสู่ระบบแสดงรายละเอียดที่ล้าสมัย
Signal API ของ Credential Manager ช่วยให้ฝ่ายที่เกี่ยวข้องสื่อสารกับผู้ให้บริการข้อมูลเข้าสู่ระบบเพื่อลบข้อมูลเข้าสู่ระบบและอัปเดตข้อมูลเมตาของผู้ใช้ เช่น ชื่อผู้ใช้และชื่อที่แสดง คำขอที่รองรับมี 3 ประเภทสำหรับสถานการณ์ที่แตกต่างกัน ดังนี้
SignalUnknownCredentialRequest- ระบุว่าข้อมูลเข้าสู่ระบบที่เฉพาะเจาะจงใช้งานไม่ได้อีกต่อไป และควรซ่อนหรือนำออกจากผู้ให้บริการข้อมูลเข้าสู่ระบบ
SignalAllAcceptedCredentialIdsRequest- แสดงรายการรหัสข้อมูลเข้าสู่ระบบที่ยอมรับแก่ผู้ให้บริการข้อมูลเข้าสู่ระบบ
SignalCurrentUserDetailsRequest- อัปเดตรายละเอียดข้อมูลเมตาของผู้ใช้
ความเข้ากันได้ของเวอร์ชัน
Signal API พร้อมใช้งานในอุปกรณ์ที่ใช้ Android 15 ขึ้นไป และพร้อมใช้งานตั้งแต่เวอร์ชัน 1.6.0-beta03 ของไลบรารี androidx.credentials เป็นต้นไป
การใช้งาน
หากต้องการใช้ Signal API ให้ทำตามขั้นตอนต่อไปนี้
เพิ่มทรัพยากร Dependency ของ Credential Manager ลงในโปรเจ็กต์
Kotlin
dependencies { implementation("androidx.credentials:credentials:1.7.0-alpha02") }
Groovy
dependencies { implementation "androidx.credentials:credentials:1.7.0-alpha02" }
เรียก Signal API
หากต้องการส่งคำขอสัญญาณไปยังผู้ให้บริการข้อมูลเข้าสู่ระบบ ให้ใช้คำขอสัญญาณที่รองรับ คำขอสัญญาณแต่ละประเภทต้องใช้คำขอ JSON ดังที่แสดงในตัวอย่างต่อไปนี้
ข้อมูลเข้าสู่ระบบที่ไม่รู้จัก (
SignalUnknownCredentialRequest)ใช้
SignalUnknownCredentialRequestเพื่อส่งสัญญาณว่าฝ่ายที่เชื่อถือไม่รู้จักรหัสข้อมูลเข้าสู่ระบบ เมื่อผู้ให้บริการข้อมูลเข้าสู่ระบบได้รับสัญญาณนี้ ระบบจะซ่อนหรือลบข้อมูลเข้าสู่ระบบการใช้งาน
ส่งสัญญาณนี้หลังจากพิจารณาแล้วว่าฝ่ายที่อาศัยไม่รู้จักรหัสข้อมูลเข้าสู่ระบบเท่านั้น เช่น เมื่อลบข้อมูลเข้าสู่ระบบออกจากเซิร์ฟเวอร์ ความล้มเหลวในการยืนยันการยืนยันพาสคีย์อื่นๆ เช่น ชาเลนจ์ที่หมดอายุหรือข้อผิดพลาดเกี่ยวกับลายเซ็น ไม่ได้เป็นเหตุผลที่เพียงพอในการส่งสัญญาณนี้ การส่งสัญญาณนี้สำหรับรหัสข้อมูลเข้าสู่ระบบที่รู้จักอาจทำให้ผู้ให้บริการข้อมูลเข้าสู่ระบบซ่อนหรือนำข้อมูลเข้าสู่ระบบที่ถูกต้องออก
พารามิเตอร์ JSON ที่จำเป็นสำหรับคำขอนี้คือ
rpIdและcredentialIdดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้าง JSON ได้ที่ตัวเลือก signalUnknownCredentialcredentialManager.signalCredentialState( SignalUnknownCredentialRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("credentialId", credentialId /* [String] Credential ID of the credential to be hidden or deleted */) }.toString() ) )ข้อมูลเข้าสู่ระบบที่ยอมรับทั้งหมด (
SignalAllAcceptedCredentialIdsRequest)ใช้
SignalAllAcceptedCredentialIdsRequestเพื่อแจ้งผู้ให้บริการข้อมูลเข้าสู่ระบบด้วยชุดข้อมูลเข้าสู่ระบบที่ยอมรับทั้งหมด เมื่อผู้ให้บริการข้อมูลเข้าสู่ระบบได้รับสัญญาณแล้ว ผู้ให้บริการข้อมูลเข้าสู่ระบบจะซ่อนหรือลบข้อมูลเข้าสู่ระบบที่ไม่ได้รวมอยู่ในรายการนี้ หรือเลิกซ่อนข้อมูลเข้าสู่ระบบที่ซ่อนไว้ก่อนหน้านี้ซึ่งตอนนี้รวมอยู่ในรายการแล้วการใช้งาน
ใช้สัญญาณนี้เมื่อการยืนยันพาสคีย์โดยฝ่ายที่อาศัยไม่สำเร็จ ความล้มเหลวนี้หมายความว่าพาสคีย์ไม่ถูกต้อง และผู้ให้บริการข้อมูลเข้าสู่ระบบต้องซ่อนหรือนำพาสคีย์ออก นอกจากนี้ คุณยังใช้สัญญาณนี้ได้ทุกเมื่อที่ต้องการประกาศชุดรหัสข้อมูลเข้าสู่ระบบที่รู้จักไปยังผู้ให้บริการข้อมูลเข้าสู่ระบบ
พารามิเตอร์ JSON ที่จำเป็นสำหรับคำขอนี้คือ
rpId,userIdและallAcceptedCredentialIdsดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้าง JSON ได้ที่ตัวเลือก signalAllAcceptedCredentialcredentialManager.signalCredentialState( SignalAllAcceptedCredentialIdsRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("userId", userId /* [String] User ID of the current user */) put( "allAcceptedCredentialIds", JSONArray(credentialIdsList /* [List<String>] List of accepted Credential IDs */) ) }.toString() ) )รายละเอียดผู้ใช้ปัจจุบัน (
SignalCurrentUserDetailsRequest)ใช้
SignalCurrentUserDetailsRequestเพื่อแจ้งผู้ให้บริการข้อมูลเข้าสู่ระบบว่าข้อมูลเมตา เช่น ชื่อผู้ใช้และชื่อที่แสดงของผู้ใช้ที่ระบุ ได้รับการอัปเดตแล้วและควรปรากฏในผู้ให้บริการข้อมูลเข้าสู่ระบบการใช้งาน
ใช้สัญญาณนี้เมื่อผู้ใช้หรือฝ่ายที่เกี่ยวข้องอัปเดตข้อมูลเมตาของพาสคีย์ที่เชื่อมโยงกับบัญชีผู้ใช้
พารามิเตอร์ JSON ที่จำเป็นสำหรับคำขอนี้คือ
rpId,userId,nameและdisplayNameดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้าง JSON ได้ที่ตัวเลือก signalCurrentUserDetailscredentialManager.signalCredentialState( SignalCurrentUserDetailsRequest( requestJson = JSONObject().apply { put("rpId", rpId /* [String] RP ID of the relying party */) put("userId", userId /* [String] User ID of the current user */) put("name", name /* [String] New Name to be updated for the current user */) put("displayName", displayName /* [String] New display name to be updated for the current user */) }.toString() ) )
ทดสอบการติดตั้งใช้งาน
หากต้องการทดสอบการติดตั้งใช้งาน Signal API ให้ทำตามขั้นตอนต่อไปนี้
ติดตั้งตัวอย่างผู้ให้บริการเอกสารสิทธิ์ชื่อ MyVault
เปิดใช้ MyVault เป็นผู้ให้บริการข้อมูลเข้าสู่ระบบในการตั้งค่า > รหัสผ่าน พาสคีย์ และบัญชี > บริการที่ต้องการ
เปิดใช้การแจ้งเตือนทั้งหมดสำหรับ MyVault ในการตั้งค่า > แอป > MyVault > การแจ้งเตือน
ตรวจสอบว่าแสดงบนหน้าจอเปิดอยู่สำหรับการแจ้งเตือนในการตั้งค่า > แอป > MyVault > การแจ้งเตือน > หมวดหมู่ > ช่องทางการแจ้งเตือนของ Signal API
ในแอป ให้เรียกใช้ขั้นตอนที่ส่งคำขอสัญญาณไปยังผู้ให้บริการข้อมูลเข้าสู่ระบบ คุณจะเห็นการแจ้งเตือนจาก MyVault บนหน้าจอ ซึ่งเป็นการยืนยันว่าผู้ให้บริการข้อมูลเข้าสู่ระบบได้รับคำขอแล้ว