รักษาข้อมูลเข้าสู่ระบบให้สอดคล้องกับผู้ให้บริการข้อมูลเข้าสู่ระบบ

เมื่อผู้ใช้สร้างพาสคีย์ เซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้องจะบันทึกรายละเอียดบางอย่างไว้ ส่วนผู้ให้บริการข้อมูลเข้าสู่ระบบ เช่น เครื่องมือจัดการรหัสผ่านบน Google จะบันทึกรายละเอียดอื่นๆ ดังนี้

  • เซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้องจะบันทึกข้อมูลเข้าสู่ระบบคีย์สาธารณะ
  • ผู้ให้บริการข้อมูลเข้าสู่ระบบจะบันทึกชื่อผู้ใช้ ชื่อที่แสดง คีย์ส่วนตัว และข้อมูลเมตาอื่นๆ ที่เกี่ยวข้อง ข้อมูลเมตานี้ช่วยให้ผู้ใช้ระบุและเลือกพาสคีย์ที่จำเป็นในระหว่างการลงชื่อเข้าใช้

ความไม่สอดคล้องกันที่อาจเกิดขึ้นระหว่างข้อมูลที่บันทึกไว้ในเซิร์ฟเวอร์ของฝ่ายที่信賴กับผู้ให้บริการข้อมูลเข้าสู่ระบบอาจส่งผลให้ผู้ใช้ได้รับประสบการณ์ที่ไม่ดี ปัญหาอาจเกิดขึ้นในสถานการณ์ต่อไปนี้

  • ระบบลบข้อมูลเข้าสู่ระบบในเซิร์ฟเวอร์ของฝ่ายที่เกี่ยวข้อง แต่ไม่ได้ลบในผู้ให้บริการข้อมูลเข้าสู่ระบบ ซึ่งส่งผลให้ผู้ให้บริการข้อมูลเข้าสู่ระบบแสดงข้อมูลเข้าสู่ระบบที่ลบไปแล้วแก่ผู้ใช้
  • มีการอัปเดตชื่อผู้ใช้หรือชื่อที่แสดงในเซิร์ฟเวอร์ของฝ่ายที่เชื่อถือ แต่ไม่ได้อัปเดตในผู้ให้บริการข้อมูลเข้าสู่ระบบ ซึ่งส่งผลให้ผู้ให้บริการข้อมูลเข้าสู่ระบบแสดงรายละเอียดที่ล้าสมัย

Signal API ของ Credential Manager ช่วยให้ฝ่ายที่เกี่ยวข้องสื่อสารกับผู้ให้บริการข้อมูลเข้าสู่ระบบเพื่อลบข้อมูลเข้าสู่ระบบและอัปเดตข้อมูลเมตาของผู้ใช้ เช่น ชื่อผู้ใช้และชื่อที่แสดง คำขอที่รองรับมี 3 ประเภทสำหรับสถานการณ์ที่แตกต่างกัน ดังนี้

  • SignalUnknownCredentialRequest

    • ระบุว่าข้อมูลเข้าสู่ระบบที่เฉพาะเจาะจงใช้งานไม่ได้อีกต่อไป และควรซ่อนหรือนำออกจากผู้ให้บริการข้อมูลเข้าสู่ระบบ
  • SignalAllAcceptedCredentialIdsRequest

    • แสดงรายการรหัสข้อมูลเข้าสู่ระบบที่ยอมรับแก่ผู้ให้บริการข้อมูลเข้าสู่ระบบ
  • SignalCurrentUserDetailsRequest

    • อัปเดตรายละเอียดข้อมูลเมตาของผู้ใช้

ความเข้ากันได้ของเวอร์ชัน

Signal API พร้อมใช้งานในอุปกรณ์ที่ใช้ Android 15 ขึ้นไป และพร้อมใช้งานตั้งแต่เวอร์ชัน 1.6.0-beta03 ของไลบรารี androidx.credentials เป็นต้นไป

การใช้งาน

หากต้องการใช้ Signal API ให้ทำตามขั้นตอนต่อไปนี้

  1. เพิ่มทรัพยากร Dependency ของ Credential Manager ลงในโปรเจ็กต์

    Kotlin

    dependencies {
        implementation("androidx.credentials:credentials:1.7.0-alpha02")
    }

    Groovy

    dependencies {
        implementation "androidx.credentials:credentials:1.7.0-alpha02"
    }

  2. เรียก Signal API

    หากต้องการส่งคำขอสัญญาณไปยังผู้ให้บริการข้อมูลเข้าสู่ระบบ ให้ใช้คำขอสัญญาณที่รองรับ คำขอสัญญาณแต่ละประเภทต้องใช้คำขอ JSON ดังที่แสดงในตัวอย่างต่อไปนี้

    • ข้อมูลเข้าสู่ระบบที่ไม่รู้จัก (SignalUnknownCredentialRequest)

      ใช้ SignalUnknownCredentialRequest เพื่อส่งสัญญาณว่าฝ่ายที่เชื่อถือไม่รู้จักรหัสข้อมูลเข้าสู่ระบบ เมื่อผู้ให้บริการข้อมูลเข้าสู่ระบบได้รับสัญญาณนี้ ระบบจะซ่อนหรือลบข้อมูลเข้าสู่ระบบ

      การใช้งาน

      ส่งสัญญาณนี้หลังจากพิจารณาแล้วว่าฝ่ายที่อาศัยไม่รู้จักรหัสข้อมูลเข้าสู่ระบบเท่านั้น เช่น เมื่อลบข้อมูลเข้าสู่ระบบออกจากเซิร์ฟเวอร์ ความล้มเหลวในการยืนยันการยืนยันพาสคีย์อื่นๆ เช่น ชาเลนจ์ที่หมดอายุหรือข้อผิดพลาดเกี่ยวกับลายเซ็น ไม่ได้เป็นเหตุผลที่เพียงพอในการส่งสัญญาณนี้ การส่งสัญญาณนี้สำหรับรหัสข้อมูลเข้าสู่ระบบที่รู้จักอาจทำให้ผู้ให้บริการข้อมูลเข้าสู่ระบบซ่อนหรือนำข้อมูลเข้าสู่ระบบที่ถูกต้องออก

      พารามิเตอร์ JSON ที่จำเป็นสำหรับคำขอนี้คือ rpId และ credentialId ดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้าง JSON ได้ที่ตัวเลือก signalUnknownCredential

      credentialManager.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 ได้ที่ตัวเลือก signalAllAcceptedCredential

      credentialManager.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 ได้ที่ตัวเลือก signalCurrentUserDetails

      credentialManager.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 ให้ทำตามขั้นตอนต่อไปนี้

  1. ติดตั้งตัวอย่างผู้ให้บริการเอกสารสิทธิ์ชื่อ MyVault

  2. เปิดใช้ MyVault เป็นผู้ให้บริการข้อมูลเข้าสู่ระบบในการตั้งค่า > รหัสผ่าน พาสคีย์ และบัญชี > บริการที่ต้องการ

    เมนู &quot;บริการที่ต้องการ&quot; ในการตั้งค่า Android ซึ่งแสดง MyVault ที่เปิดใช้เป็นผู้ให้บริการข้อมูลเข้าสู่ระบบ

  3. เปิดใช้การแจ้งเตือนทั้งหมดสำหรับ MyVault ในการตั้งค่า > แอป > MyVault > การแจ้งเตือน

    เมนูการแจ้งเตือนสำหรับแอป MyVault ซึ่งแสดงการแจ้งเตือนทั้งหมดที่เปิดใช้

  4. ตรวจสอบว่าแสดงบนหน้าจอเปิดอยู่สำหรับการแจ้งเตือนในการตั้งค่า > แอป > MyVault > การแจ้งเตือน > หมวดหมู่ > ช่องทางการแจ้งเตือนของ Signal API

    การตั้งค่าช่องทางการแจ้งเตือน Signal API สำหรับ MyVault ซึ่งแสดงตัวเลือก &quot;แสดงป๊อปอัปบนหน้าจอ&quot; ที่เปิดใช้อยู่

  5. ในแอป ให้เรียกใช้ขั้นตอนที่ส่งคำขอสัญญาณไปยังผู้ให้บริการข้อมูลเข้าสู่ระบบ คุณจะเห็นการแจ้งเตือนจาก MyVault บนหน้าจอ ซึ่งเป็นการยืนยันว่าผู้ให้บริการข้อมูลเข้าสู่ระบบได้รับคำขอแล้ว