Credential Manager Holder API ช่วยให้แอปผู้ถือ (หรือที่เรียกว่า "Wallet") ของ Android จัดการและแสดงข้อมูลเข้าสู่ระบบดิจิทัลต่อผู้ตรวจสอบได้
รูปแบบข้อมูลเข้าสู่ระบบ
คุณสามารถจัดเก็บข้อมูลเข้าสู่ระบบไว้ในแอปผู้ถือในรูปแบบข้อมูลเข้าสู่ระบบที่แตกต่างกันได้ รูปแบบเหล่านี้เป็นข้อกำหนดเฉพาะสำหรับวิธีแสดงข้อมูลเข้าสู่ระบบ และแต่ละรูปแบบจะมีข้อมูลต่อไปนี้เกี่ยวกับข้อมูลเข้าสู่ระบบ
- ประเภท: หมวดหมู่ เช่น ปริญญาจากมหาวิทยาลัยหรือใบขับขี่
- พร็อพเพอร์ตี้: แอตทริบิวต์ เช่น ชื่อและนามสกุล
การเข้ารหัส: วิธีจัดโครงสร้างข้อมูลเข้าสู่ระบบ เช่น SD-JWT หรือ mdoc
ความถูกต้อง: วิธีการยืนยันความถูกต้องของข้อมูลเข้าสู่ระบบด้วยการเข้ารหัส
รูปแบบข้อมูลเข้าสู่ระบบแต่ละรูปแบบจะเข้ารหัสและตรวจสอบความถูกต้องแตกต่างกันเล็กน้อย แต่ในเชิงฟังก์ชันแล้วจะเหมือนกัน
รีจิสทรีรองรับ 2 รูปแบบ ได้แก่
- SD-JWT: เป็นไปตามข้อกำหนดข้อมูลเข้าสู่ระบบที่ตรวจสอบได้ตาม SD-JWT ของ IETF (SD-JWT VC)
- เอกสารบนอุปกรณ์เคลื่อนที่หรือ mdoc: เป็นไปตามข้อกำหนด ISO/IEC 18013-5:2021
ผู้ตรวจสอบสามารถส่งคำขอ OpenID4VP สำหรับ SD-JWT และ mdoc ได้เมื่อใช้ Credential Manager ตัวเลือกจะแตกต่างกันไปตามกรณีการใช้งานและตัวเลือกอุตสาหกรรม
การลงทะเบียนข้อมูลเมตาของข้อมูลเข้าสู่ระบบ
Credential Manager ไม่ได้จัดเก็บข้อมูลเข้าสู่ระบบของผู้ถือโดยตรง แต่จะจัดเก็บข้อมูลเมตาของข้อมูลเข้าสู่ระบบ แอปผู้ถือต้องลงทะเบียนข้อมูลเมตาของข้อมูลเข้าสู่ระบบกับ Credential Manager ก่อนโดยใช้ RegistryManager กระบวนการจดทะเบียนนี้จะสร้างบันทึกรีจิสทรีซึ่งมีวัตถุประสงค์หลัก 2 ประการ ได้แก่
- การจับคู่: ระบบจะใช้ข้อมูลเมตาของข้อมูลเข้าสู่ระบบที่ลงทะเบียนไว้เพื่อจับคู่กับคำขอของผู้ตรวจสอบในอนาคต
- การแสดงผล: องค์ประกอบ UI ที่ปรับแต่งจะแสดงต่อผู้ใช้ในอินเทอร์เฟซตัวเลือกข้อมูลเข้าสู่ระบบ
ใช้คลาส OpenId4VpRegistry เพื่อลงทะเบียนข้อมูลเข้าสู่ระบบดิจิทัล เนื่องจากคลาสนี้รองรับทั้งรูปแบบข้อมูลเข้าสู่ระบบ mdoc และ SD-JWT ผู้ตรวจสอบจะส่งคำขอ OpenID4VP เพื่อขอข้อมูลเข้าสู่ระบบเหล่านี้
วิธีการออกข้อมูลเข้าสู่ระบบ
การออกข้อมูลเข้าสู่ระบบสามารถทริกเกอร์ได้ 2 วิธีดังนี้
- ขั้นตอนที่ผู้ออกบัตรเป็นผู้เริ่ม: ผู้ใช้เรียกใช้คำขอให้ออก VDC จากแอปพลิเคชันหรือเว็บไซต์ของผู้ออกบัตร เช่น เว็บไซต์อาจเสนอตัวเลือก "เพิ่มหนังสือเดินทางลงใน Wallet" ให้แก่ผู้ใช้ ผู้ออกจะเรียกใช้ API การออกข้อมูลเข้าสู่ระบบของ Credential Manager เพื่อส่งคำขอข้อเสนอข้อมูลเข้าสู่ระบบ OpenID4VCI หากต้องการจัดการคำขอดังกล่าว ผู้ถือต้องผสานรวมกับ Credential Manager ก่อนเพื่อลงทะเบียนข้อมูลเมตา Credential Manager จะแสดงตัวเลือกที่เกี่ยวข้องให้ผู้ใช้เลือก หลังจากผู้ใช้เลือกตัวเลือกผู้ถือแล้ว ระบบจะเรียกใช้แอปพลิเคชันผู้ถือและดำเนินการตามขั้นตอนที่จำเป็นเพื่อดำเนินการออกให้เสร็จสมบูรณ์
- ขั้นตอนที่เริ่มต้นโดยผู้ถือบัตร: ผู้ใช้ส่งคำขอเพิ่ม VDC จากแอปพลิเคชันของผู้ถือบัตร เช่น ผู้ถืออาจเสนอให้มีปุ่ม "เพิ่มหนังสือเดินทาง" ในกรณีนี้ ผู้ถือจะเก็บรักษารายชื่อผู้ออกบัตรและข้อมูลเมตาที่รองรับไว้ โดยไม่จำเป็นต้องผสานรวมกับ Android Credential Manager เพื่อดำเนินการฟังก์ชันนี้ให้เสร็จสมบูรณ์