Tính năng Xác minh bằng Google Wallet hỗ trợ ba phương thức tích hợp, trong đó có hai phương thức trực tuyến (dành cho ứng dụng và trang web Android) và một phương thức trực tiếp (dành cho máy đọc thẻ lân cận và thiết bị đầu cuối tại điểm bán hàng). Chọn lộ trình để bắt đầu.
Ba cách tích hợp
Bên tin cậy (RP)
Dành cho người bán, doanh nghiệp hoặc nhà phát triển ứng dụng cá nhân xác minh người dùng trực tiếp cho trang web hoặc ứng dụng Android của riêng họ.
Người đăng ký xác minh (VR)
Dành cho nhà cung cấp, đơn vị tổng hợp hoặc nền tảng IDV xác minh người dùng thay mặt cho nhiều doanh nghiệp hạ nguồn (RP cuối).
Xác minh trực tiếp
Đối với thiết bị đầu cuối tại điểm bán hàng, thiết bị đọc tại địa điểm hoặc ứng dụng xác minh trên thiết bị di động xác minh mDL khi không có mạng – hoạt động mà không cần Google đưa vào danh sách cho phép nếu thiết bị đầu cuối của bạn hỗ trợ truy xuất mdoc theo tiêu chuẩn ISO/IEC 18013-5 (giấy tờ tuỳ thân điện tử hiện không được hỗ trợ trực tiếp).
So sánh các đường dẫn trực tuyến: Bên phụ thuộc so với Cơ quan đăng ký của bên xác minh
| Tỷ lệ | Bên tin cậy (RP) | Người đăng ký xác minh (VR) |
|---|---|---|
| Người ký yêu cầu | Google ký chứng chỉ của bạn (bạn gửi CSR) | Bạn điều hành CA của riêng mình (CA gốc trong môi trường hộp cát + môi trường thực tế) và ký chứng chỉ lá cho RP cuối |
| Thông tin đăng nhập hộp cát | Khoá và siêu dữ liệu thử nghiệm hộp cát dùng chung của Google (bắt đầu thử nghiệm ngay lập tức) | Chứng chỉ do CA gốc trong Hộp cát của riêng bạn ký, sau khi Google tin tưởng chứng chỉ đó |
| Trường hợp bạn nên liên hệ với Google | Ở bước cuối cùng (Bước 5), sau khi hoàn tất quy trình kiểm thử trong hộp cát | Ở bước đầu tiên (Bước 1), hãy đăng ký CA gốc cho môi trường thử nghiệm và môi trường thực tế |
Hướng dẫn tích hợp trực tuyến
Chọn lộ trình tích hợp trực tuyến để làm theo các Bước từ 1 đến 5 theo thứ tự. Bạn có thể hoàn tất Bước 1 và 2 (thiết lập hộp cát và mã nhận dạng thử nghiệm) song song trong khi nhóm kỹ thuật của bạn xây dựng Bước 3.
Bên Relying Party (Trực tiếp)
Thiết lập hộp cát
Bạn không cần phải điền vào biểu mẫu tiếp nhận hoặc chờ phê duyệt để bắt đầu thử nghiệm. Yêu cầu đưa Tài khoản Google thử nghiệm của bạn vào danh sách cho phép của hộp cát, chuyển thiết bị Android thử nghiệm sang chế độ hộp cát, đồng thời tải khoá thử nghiệm hộp cát dùng chung của Google và chứng chỉ Utopia Sandbox xuống.
Tạo mã nhận dạng thử nghiệm trong hộp cát
Sử dụng một thiết bị Android thứ hai chạy Trình mô phỏng hộ chiếu điện tử Utopia để cấp giấy tờ tuỳ thân điện tử mô phỏng vào Google Wallet trên thiết bị hộp cát của bạn.
Tích hợp với tư cách là Bên Relying Party
Làm theo 4 bước triển khai trong hướng dẫn tích hợp Bên phụ thuộc:
- Bước 3.A – Định dạng và ký yêu cầu: Tạo truy vấn JSON OpenID4VP và ký JWS trên máy chủ của bạn.
- Bước 3.B – Kích hoạt API: Gọi Android
CredentialManagerhoặc Webnavigator.credentials.get(). - Bước 3.C – Giải mã và xác thực phản hồi: Giải mã JWE và xác minh chuỗi chứng chỉ IACA cũng như MSO trên máy chủ của bạn.
- Bước 3.D (Không bắt buộc) – Thêm bằng chứng không tiết lộ tri thức: Xác minh vị từ về độ tuổi mà không cần nhận ngày sinh của người dùng.
Kiểm thử toàn bộ quá trình tích hợp
Xuất trình giấy tờ tuỳ thân điện tử thử nghiệm của Utopia cho dịch vụ của bạn, xác minh mọi mục trong danh sách kiểm tra toàn diện (bao gồm cả việc xác thực issuerAuth dựa trên chứng chỉ Hộp cát của Utopia) và quay video minh hoạ.
Phát trực tiếp với tư cách là Bên Relying Party
Gửi Biểu mẫu tham gia dành cho bên tin cậy cùng với CSR chính thức, tài sản thương hiệu và video về quy trình toàn diện trong hộp cát (chính thức chấp nhận Điều khoản dịch vụ dành cho bên tin cậy). Sau khi phê duyệt (thường mất từ 3 đến 5 ngày làm việc), Google sẽ trả lại chứng chỉ sản xuất đã ký và gw_rp_metadata_bytes duy nhất của bạn.
Nhà đăng ký xác minh (Trang web tổng hợp)
Gửi CA gốc và thiết lập hộp cát
Trước tiên, hãy gửi Biểu mẫu tiếp nhận thông tin đăng ký của đơn vị xác minh cùng với Chứng chỉ CA gốc cho môi trường hộp cát và môi trường thực tế (chấp nhận Điều khoản dịch vụ của đơn vị xác minh) để Google có thể tin tưởng CA gốc cho môi trường hộp cát của bạn. Đồng thời, hãy đưa Tài khoản Google thử nghiệm của bạn vào danh sách cho phép và chuyển thiết bị Android thử nghiệm sang chế độ hộp cát.
Tạo mã nhận dạng thử nghiệm trong hộp cát
Sử dụng một thiết bị Android thứ hai chạy Trình mô phỏng hộ chiếu điện tử Utopia để cấp giấy tờ tuỳ thân điện tử mô phỏng vào Google Wallet trên thiết bị hộp cát của bạn.
Tích hợp với tư cách là Nhà đăng ký xác minh
Làm theo 5 bước triển khai trong hướng dẫn tích hợp Verifier Registrar:
- Bước 3.A — Định cấu hình siêu dữ liệu CA và CBOR: Thiết lập hồ sơ chứng chỉ X.509 (OID
1.3.6.1.4.1.11129.10.1) và giản đồ siêu dữ liệu CBOR. - Bước 3.B – Định dạng và ký yêu cầu: Tạo truy vấn JSON OpenID4VP và ký JWS bằng chứng chỉ lá End-RP.
- Bước 3.C – Kích hoạt API: Gọi Android
CredentialManagerhoặc Webnavigator.credentials.get(). - Bước 3.D – Giải mã và xác thực phản hồi: Giải mã JWE và xác minh chuỗi chứng chỉ IACA cũng như MSO trên máy chủ của bạn.
- Bước 3.E (Không bắt buộc) – Thêm bằng chứng không tiết lộ tri thức: Xác minh các vị từ về độ tuổi mà không cần nhận ngày sinh của người dùng.
Kiểm thử toàn bộ quá trình tích hợp
Sau khi Google thông báo rằng CA gốc trong Hộp cát của bạn là đáng tin cậy, hãy ký một chứng chỉ End-RP thử nghiệm, tin tưởng chứng chỉ Hộp cát Utopia trên máy chủ của bạn, thử nghiệm bằng giấy tờ tuỳ thân điện tử thử nghiệm Utopia và quay video minh hoạ cho cả quy trình do bên xác minh lưu trữ và quy trình do người bán lưu trữ.
Bắt đầu hoạt động với tư cách là Tổ chức đăng ký xác minh và tham gia vào các Bên phụ thuộc cuối
Gửi video E2E để xem xét. Google phê duyệt video của bạn và đồng thời tin tưởng CA gốc chính thức của bạn. Sau đó, đăng ký từng ứng dụng khách hạ nguồn bằng Biểu mẫu đăng ký ứng dụng khách của tổ chức đăng ký xác minh và cấp chứng chỉ lá có Tên riêng biệt duy nhất trên toàn cầu.
Những điều bạn cần chuẩn bị trước khi bắt đầu
- Máy chủ tạo yêu cầu và xác thực phản hồi. Tạo yêu cầu đầy đủ trên máy chủ của bạn, ngay cả đối với ứng dụng Android.
- Hai thiết bị Android để kiểm thử: một thiết bị chạy trình mô phỏng hộ chiếu điện tử và thiết bị còn lại lưu giữ giấy tờ tuỳ thân thử nghiệm trong Google Wallet. Sử dụng thiết bị kiểm thử chuyên dụng, vì việc chuyển sang hộp cát sẽ xoá dữ liệu Wallet chính thức của thiết bị.
- Tài khoản Google có đuôi@gmail.com để dùng trong Google Wallet khi bạn thử nghiệm.
- Thành phần hiển thị cho màn hình xin phép: tên hiển thị, biểu trưng (xem Nguyên tắc sử dụng thương hiệu), URL chính sách quyền riêng tư và URL Điều khoản dịch vụ.