ตรวจสอบสิทธิ์ในอุปกรณ์รูปแบบต่างๆ

Credential Manager ช่วยลดความซับซ้อนในการตรวจสอบสิทธิ์ทั่วทั้งระบบนิเวศของ Android โดยมอบประสบการณ์การใช้งานที่สอดคล้องกันสำหรับผู้ใช้ และมีพื้นผิว API ที่รวมเป็นหนึ่งเดียวสำหรับนักพัฒนาแอปในการใช้พาสคีย์ รหัสผ่าน และกลไกการลงชื่อเข้าใช้แบบรวมศูนย์ เช่น ลงชื่อเข้าใช้ด้วย Google แม้ว่าอินเทอร์เฟซการเขียนโปรแกรมหลักจะยังคงสอดคล้องกันในทุกรูปแบบ แต่แต่ละรูปแบบก็มีข้อควรพิจารณาด้าน UI และ UX ที่ไม่เหมือนกัน การติดตั้งใช้งานที่ประสบความสำเร็จต้องอาศัยการปรับโฟลว์การตรวจสอบสิทธิ์ของแอปให้เข้ากับวิธีการป้อนข้อมูล ขนาดหน้าจอ และบริบทของผู้ใช้ของอุปกรณ์แต่ละเครื่อง

คู่มือนี้ให้ภาพรวมเกี่ยวกับวิธีติดตั้งใช้งาน Credential Manager ในรูปแบบต่างๆ ของ Android โดยเน้นข้อควรพิจารณาที่สำคัญและลิงก์ไปยังเอกสารฉบับละเอียด

อุปกรณ์เคลื่อนที่

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

Wear OS

อุปกรณ์ Wear OS มีลักษณะเด่นคือหน้าจอขนาดเล็กและการป้อนข้อมูลในอุปกรณ์ที่จำกัด การติดตั้งใช้งานพาสคีย์ของ Credential Manager มอบสภาพแวดล้อมที่ปลอดภัยให้ผู้ใช้ลงชื่อเข้าใช้แอป โดยไม่จำเป็นต้องใช้โทรศัพท์ที่จับคู่และเชื่อมต่ออยู่ และไม่ต้องจำรหัสผ่าน

API สำหรับ Wear OS เหมือนกับ API สำหรับอุปกรณ์เคลื่อนที่ คุณจึงนำการผสานรวมที่มีอยู่สำหรับอุปกรณ์เคลื่อนที่มาใช้ซ้ำได้ นอกจากพาสคีย์ การลงชื่อเข้าใช้ด้วย Google และรหัสผ่านด้วย Credential Manager แล้ว คุณยังใช้วิธีการตรวจสอบสิทธิ์อื่นๆ ได้ด้วย ซึ่งรวมถึงการแชร์โทเค็นของ Data Layer, OAuth หรือโซลูชันที่มีอยู่ คุณสามารถใช้วิธีการเหล่านี้เป็นข้อมูลสำรองในระหว่างที่เปลี่ยนผู้ใช้ไปใช้ Credential Manager หรือในกรณีของการแชร์โทเค็นของชั้นข้อมูล ก็สามารถใช้เป็นโซลูชันระยะยาวได้

การใช้ Credential Manager สำหรับ Wear OS มีข้อกำหนดดังนี้

• API ระดับต่ำสุด: minSdkVersion 33 ขึ้นไป
  • รวมถึงการรองรับรหัสผ่าน พาสคีย์ และลงชื่อเข้าใช้ด้วย Google
• เวอร์ชัน GMS: เหมือนกับที่กำหนดไว้สำหรับแอปบนอุปกรณ์เคลื่อนที่

อินเทอร์เฟซผู้ใช้ในอุปกรณ์ Wear OS มีลักษณะดังนี้

ดูคำแนะนำการติดตั้งใช้งานและโค้ดตัวอย่างโดยละเอียดได้จากแหล่งข้อมูลต่อไปนี้

• การตรวจสอบสิทธิ์ในอุปกรณ์ที่สวมใส่ได้: Credential Manager
• คำแนะนำการออกแบบ UI สำหรับ Wear OS
• ตัวอย่าง Credential Manager สำหรับ Wear

ข้อจำกัด

การใช้ Credential Manager ใน Wear OS มีข้อจำกัดดังนี้

• ไม่รองรับการสร้างพาสคีย์
• ไม่รองรับข้อมูลเกี่ยวกับการกู้คืนข้อมูลเข้าสู่ระบบ

Android XR

ใน Android XR (ซึ่งรวมถึงเทคโนโลยีความจริงเสมือนและความจริงเสริม) แอปจะแสดงผลในพื้นที่ 3 มิติ การป้อนข้อมูลของผู้ใช้จะแตกต่างจากการป้อนข้อมูลในรูปแบบอื่นๆ อย่างสิ้นเชิง โดยอาศัยการป้อนข้อมูลตามธรรมชาติ เช่น ท่าทางของมือ

การปรับ Credential Manager ให้เหมาะกับ XR หมายถึงการคิดใหม่เกี่ยวกับ UI การตรวจสอบสิทธิ์ (ไม่ว่าจะใช้พาสคีย์ รหัสผ่าน หรือวิธีการลงชื่อเข้าใช้แบบรวมศูนย์) สำหรับพื้นที่ 3 มิติ เช่น พรอมต์การตรวจสอบสิทธิ์จะปรากฏในแผงแบบลอย และผู้ใช้เลือกโดยใช้ท่าทางของมือ นอกจากนี้ คุณยังต้องพิจารณาข้อกำหนดเบื้องต้นด้านฮาร์ดแวร์หรือซอฟต์แวร์ที่เฉพาะเจาะจงสำหรับอุปกรณ์ XR เป้าหมายด้วย

ความท้าทายด้านการออกแบบที่สำคัญคือการสร้างประสบการณ์การตรวจสอบสิทธิ์ที่ใช้งานง่ายและปลอดภัยภายในสภาพแวดล้อม VR หรือ AR นอกจากนี้ คุณยังต้องพิจารณาถึงวิธีจัดการข้อมูลประจำตัวในสถานการณ์ XR ที่มีผู้ใช้หลายคนหนึ่งเครื่อง ซึ่งผู้ใช้หลายคนอาจใช้อุปกรณ์เครื่องเดียวกัน

การใช้ Credential Manager สำหรับ Android XR มีข้อกำหนดดังนี้

• API ระดับต่ำสุด: minSdkVersion 34 ขึ้นไป
• เวอร์ชัน GMS: เหมือนกับที่กำหนดไว้สำหรับแอปบนอุปกรณ์เคลื่อนที่
• โปรแกรมจำลอง:
  • อิมเมจระบบโปรแกรมจำลองเวอร์ชันต่ำสุด:
    • macOS: Google Play XR ARM 64 v8a System Image Revision 7
    • Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
  • โปรแกรมจำลองเวอร์ชันสูงกว่า 35.6.11 Stable

ประสบการณ์การลงชื่อเข้าใช้ใน XR อาจมีลักษณะดังนี้

โฟลว์ที่ XR ไม่รองรับ

Credential Manager ใน Android XR ไม่รองรับโฟลว์การตรวจสอบสิทธิ์ที่ต้องใช้อุปกรณ์อื่นในการสแกนคิวอาร์โค้ด คุณจะสังเกตเห็นข้อจำกัดนี้ได้ในระหว่างกระบวนการลงชื่อเข้าใช้ในชุดหูฟัง XR และเมื่อทดสอบด้วยโปรแกรมจำลอง

ดูข้อมูลเพิ่มเติมเกี่ยวกับ XR ได้ที่ Android XR

Android TV

อุปกรณ์ Android TV มักเป็นอุปกรณ์ส่วนกลางที่ดูจากระยะไกลและควบคุมผ่านรีโมตที่มีปุ่มควบคุมทิศทาง การป้อนชื่อผู้ใช้และรหัสผ่านในสภาพแวดล้อมนี้อาจเป็นเรื่องยากสำหรับผู้ใช้ Credential Manager ช่วยลดความซับซ้อนในการตรวจสอบสิทธิ์ใน Android TV ด้วยการรองรับการลงชื่อเข้าใช้ด้วย Google, รหัสผ่านที่บันทึกไว้ และพาสคีย์แบบข้ามอุปกรณ์ เนื่องจากมักมีโปรไฟล์ Google หลายโปรไฟล์ในทีวีที่ใช้ร่วมกัน Credential Manager จึงปรับให้เข้ากับการตั้งค่าส่วนกลางนี้ด้วยการดึงและแสดงข้อมูลเข้าสู่ระบบทั้งหมดที่ใช้ได้ในอุปกรณ์ แทนที่จะจำกัดตัวเลือกไว้เฉพาะบัญชีที่ใช้งานอยู่ในปัจจุบัน

ลักษณะส่วนกลางนี้ยังกำหนดวิธีจัดการพาสคีย์ด้วย เนื่องจากทีวีไม่มีปัจจัยความรู้เกี่ยวกับหน้าจอล็อก (LSKF) ส่วนบุคคล จึงไม่สามารถจัดเก็บหรือสร้างพาสคีย์ในทีวีได้โดยตรง แต่การตรวจสอบสิทธิ์ด้วยพาสคีย์จะใช้ประโยชน์จากโฟลว์แบบไฮบริดข้ามอุปกรณ์ โดยระบบจะแสดงคิวอาร์โค้ดในทีวี และผู้ใช้จะสแกนคิวอาร์โค้ดดังกล่าวด้วยอุปกรณ์เคลื่อนที่เพื่อทำการตรวจสอบสิทธิ์ด้วยข้อมูลไบโอเมตริกให้เสร็จสมบูรณ์

คุณสามารถใช้โฟลว์แบบไม่ต้องคลิกใน Google TV ได้หากตั้งค่า isAutoSelectAllowed = true แต่จะทำได้ก็ต่อเมื่อมีข้อมูลเข้าสู่ระบบที่ตรงกันเพียงรายการเดียวเท่านั้น Bottom Sheet ของทีวีแบบเนทีฟจะยังคงปรากฏขึ้นเพื่อแสดงการยืนยันบัญชีของผู้ใช้ หากผู้ใช้ไม่ยกเลิก ระบบจะส่งคืนข้อมูลเข้าสู่ระบบโดยอัตโนมัติโดยไม่ต้องคลิกจากระยะไกล หากมีข้อมูลเข้าสู่ระบบที่ตรงกันหลายรายการ ระบบจะไม่เลือกข้อมูลเข้าสู่ระบบโดยอัตโนมัติ แต่จะแจ้งให้ผู้ใช้เลือกแทน

หากแอปบนอุปกรณ์เคลื่อนที่และแอป TV ใช้ชื่อแพ็กเกจ Android และคีย์การลงชื่อเข้าใช้เดียวกันทุกประการ เครื่องมือจัดการรหัสผ่านบน Google จะจดจำแอปดังกล่าวเป็นข้อมูลประจำตัวของแอปเดียวกัน ด้วยเหตุนี้ ระบบจึงสามารถเสนอให้ใช้รหัสผ่านที่บันทึกไว้ในอุปกรณ์เคลื่อนที่บนทีวีได้โดยตรงโดยไม่ต้องกำหนดค่า Digital Asset Links (asset_statements) คุณต้องใช้ Digital Asset Links ก็ต่อเมื่อแชร์ข้อมูลเข้าสู่ระบบข้ามขอบเขต เช่น ระหว่างแอปกับเว็บไซต์ หรือระหว่างแอปที่มีชื่อแพ็กเกจต่างกัน

การใช้ Credential Manager สำหรับ Android TV มีข้อกำหนดดังนี้

• ระดับ API ขั้นต่ำ: Android 14 (ระดับ API 34, minSdkVersion 34) ขึ้นไป
• เวอร์ชัน GMS: 2026W30 ขึ้นไป
• ฮาร์ดแวร์สำหรับพาสคีย์: ต้องมีอุปกรณ์เคลื่อนที่รองที่มีกล้องและบลูทูธเพื่อสแกนคิวอาร์โค้ดและทำโฟลว์แบบไฮบริดของ FIDO ให้เสร็จสมบูรณ์

ข้อจำกัด

เนื่องจาก Android TV เป็นอุปกรณ์ส่วนกลาง การใช้ Credential Manager ในแพลตฟอร์มนี้จึงมีข้อจำกัดที่ตั้งใจไว้ดังต่อไปนี้เพื่อปกป้องความเป็นส่วนตัวของผู้ใช้และความปลอดภัย

• ไม่สามารถสร้างหรือจัดเก็บพาสคีย์ในเครื่อง: ไม่สามารถสร้างหรือจัดเก็บพาสคีย์ในทีวีได้โดยตรง เนื่องจากระบบไม่รองรับข้อมูลเข้าสู่ระบบในเครื่อง คุณจึงไม่ควรตั้งค่า preferImmediatelyAvailableCredentials เป็น true ในคำขอ เพราะการดำเนินการดังกล่าวจะกรองพาสคีย์แบบข้ามอุปกรณ์ออกและไม่ส่งคืนข้อมูลเข้าสู่ระบบ
• ไม่มีผู้ให้บริการข้อมูลเข้าสู่ระบบของบุคคลที่สาม: Android TV ไม่รองรับการป้อนข้อความอัตโนมัติ ดังนั้นเครื่องมือจัดการรหัสผ่านของบุคคลที่สามจึงไม่พร้อมใช้งานในแพลตฟอร์ม ผู้ใช้ต้องใช้เครื่องมือจัดการรหัสผ่านบน Google
• ไม่มีการกู้คืนข้อมูลเข้าสู่ระบบ: ระบบไม่รองรับการลงชื่อเข้าใช้อุปกรณ์ใหม่โดยอัตโนมัติโดยใช้ ข้อมูลเกี่ยวกับการกู้คืนข้อมูลเข้าสู่ระบบใน Android TV

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาสำหรับทีวีได้ที่ภาพรวมของ Android TV

Android Automotive OS

อุปกรณ์ Android Automotive OS (AAOS) เป็นระบบส่วนกลางที่ผสานรวมเข้ากับรถยนต์ การปรับ Credential Manager ให้เหมาะกับ AAOS ต้องรองรับการตรวจสอบสิทธิ์ที่ปลอดภัย (โดยปกติขณะจอดรถ) และรองรับโปรไฟล์ผู้ใช้หลายโปรไฟล์ในอุปกรณ์ที่ใช้ร่วมกัน

หากคุณนำแอปที่เหมาะกับหน้าจอขนาดใหญ่หรือแท็บเล็ตมาใช้ในรถยนต์ และแอปของคุณรองรับ Credential Manager และพาสคีย์ในอุปกรณ์เคลื่อนที่หรือแท็บเล็ตอยู่แล้ว แอปจะทำงานใน Android Automotive OS โดยไม่จำเป็นต้องเปลี่ยนแปลงโฟลว์การตรวจสอบสิทธิ์

การตรวจสอบสิทธิ์ใน Android Automotive OS รองรับวิธีการต่อไปนี้

• พาสคีย์ (โฟลว์แบบไฮบริดข้ามอุปกรณ์): ผู้ใช้สามารถตรวจสอบสิทธิ์ด้วยพาสคีย์ที่มีอยู่ผ่านโฟลว์แบบข้ามอุปกรณ์ ระบบจะแสดงคิวอาร์โค้ดบนหน้าจอรถยนต์เพื่อให้ผู้ใช้สแกนด้วยอุปกรณ์เคลื่อนที่ เนื่องจากการตรวจสอบสิทธิ์แบบไบโอเมตริกและการล็อกหน้าจอจะเกิดขึ้นในโทรศัพท์ของผู้ใช้ ผู้ใช้จึงไม่จำเป็นต้องกำหนดค่าการล็อกหน้าจอในจอแสดงผลของรถยนต์
• ลงชื่อเข้าใช้ด้วย Google: แสดงหน้าจอการลงชื่อเข้าใช้ด้วย Google แบบเนทีฟบนจอแสดงผลของรถยนต์โดยตรง
• รหัสผ่านที่บันทึกไว้: ผู้ใช้สามารถดึงรหัสผ่านที่บันทึกไว้จากเครื่องมือจัดการรหัสผ่านบน Google เพื่อลงชื่อเข้าใช้โดยไม่ต้องป้อนข้อมูลเข้าสู่ระบบในหน้าจอของรถยนต์ด้วยตนเอง

Android Automotive OS จะจัดการเซสชันและข้อมูลเข้าสู่ระบบต่อโปรไฟล์ โดยแยกข้อมูลเซสชันที่เฉพาะเจาะจงของผู้ใช้ระหว่างโปรไฟล์ (เช่น โปรไฟล์ ก, โปรไฟล์ ข หรือโปรไฟล์ผู้เข้าพัก)

การใช้ Credential Manager สำหรับ Android Automotive OS มีข้อกำหนดดังนี้

• ระดับ API ขั้นต่ำ: Android 9 (ระดับ API 28, minSdkVersion 28) ขึ้นไป การดึงพาสคีย์แบบข้ามอุปกรณ์ต้องใช้ Android 14 (ระดับ API 34) ขึ้นไป
• เวอร์ชัน GMS: เหมือนกับที่กำหนดไว้สำหรับแอปบนอุปกรณ์เคลื่อนที่

ข้อจำกัดในการทดสอบ

การทดสอบพาสคีย์ต้องใช้อุปกรณ์จริงที่ใช้บิลด์ Android Automotive OS เป็นพื้นผิวหลัก ดูวิธีการตั้งค่าได้ที่หัวข้อทดสอบโดยใช้ Android Automotive OS ใน Pixel Tablet คุณไม่สามารถใช้โปรแกรมจำลองในการทดสอบพาสคีย์ได้เนื่องจากโปรแกรมจำลองไม่รองรับบลูทูธพลังงานต่ำ (BLE) ซึ่งจำเป็นสำหรับโฟลว์แบบไฮบริดของ FIDO

ข้อจำกัดและโฟลว์ที่ไม่รองรับ

การใช้ Credential Manager ใน Android Automotive OS มีข้อจำกัดดังนี้

• ไม่สามารถจัดเก็บหรือดึงพาสคีย์ในเครื่อง: ระบบไม่รองรับการดึงพาสคีย์ในเครื่องโดยตรงเนื่องจากรถยนต์เป็นอุปกรณ์ส่วนกลาง การซิงค์พาสคีย์กับรถยนต์โดยตรงก่อให้เกิดความเสี่ยงด้านความปลอดภัย ดังนั้นคุณจึงต้องใช้พาสคีย์ผ่านโฟลว์แบบไฮบริดข้ามอุปกรณ์
• ไม่รองรับข้อมูลเข้าสู่ระบบที่พร้อมใช้งานทันที: หากแอปขอพาสคีย์และตั้งค่า preferImmediatelyAvailableCredentials เป็น true UI ของยานยนต์จะสิ้นสุดลงทันทีและแสดง NoCredentialException โปรดระบุ UX แบบสำรองที่เหมาะสมสำหรับสถานการณ์นี้
• ไม่มีผู้ให้บริการข้อมูลเข้าสู่ระบบของบุคคลที่สาม: Android Automotive OS ไม่รองรับเครื่องมือจัดการรหัสผ่านของบุคคลที่สาม ผู้ใช้ต้องใช้เครื่องมือจัดการรหัสผ่านบน Google หรือโฟลว์แบบไฮบริดข้ามอุปกรณ์เพื่อตรวจสอบสิทธิ์
• ไม่สามารถสร้างรหัสผ่านที่จัดเก็บไว้: API ไม่รองรับการสร้างและบันทึกรหัสผ่านที่จัดเก็บไว้ใหม่จากอินเทอร์เฟซของรถยนต์โดยตรง การสร้างข้อมูลเข้าสู่ระบบจำกัดไว้เฉพาะพาสคีย์ใหม่โดยใช้โฟลว์แบบไฮบริดของ FIDO

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาสำหรับ Automotive OS ได้ที่ภาพรวมของ Android Automotive OS

แหล่งข้อมูลเพิ่มเติม

• เกี่ยวกับ Credential Manager
• เกี่ยวกับการกู้คืนข้อมูลเข้าสู่ระบบ
• ภาพรวมของ Android TV
• ภาพรวมของ Android Automotive OS