Giới thiệu về việc lưu trữ thông tin xác thực kỹ thuật số

API Trình quản lý thông tin xác thực cho người sở hữu cho phép ứng dụng Android của người sở hữu (còn gọi là "ví") quản lý và xuất trình thông tin xác thực kỹ thuật số cho bên xác minh.

Hình ảnh minh hoạ giao diện người dùng thông tin xác thực kỹ thuật số trong Trình quản lý thông tin xác thực
Hình 1. Giao diện người dùng của bộ chọn thông tin xác thực kỹ thuật số.

Định dạng thông tin xác thực

Thông tin xác thực có thể được lưu trữ trong các ứng dụng lưu trữ thông tin xác thực ở nhiều định dạng thông tin xác thực. Các định dạng này là thông số kỹ thuật về cách trình bày thông tin xác thực và mỗi định dạng chứa thông tin sau về thông tin xác thực:

  • Loại: Danh mục, chẳng hạn như bằng đại học hoặc giấy phép lái xe.
  • Thuộc tính: Các thuộc tính như họ và tên.
  • Mã hoá: Cách thông tin xác thực được cấu trúc, ví dụ: SD-JWT hoặc mdoc

  • Tính hợp lệ: Phương thức xác minh tính xác thực của thông tin xác thực bằng mật mã.

Mỗi định dạng thông tin xác thực có cách mã hoá và xác thực hơi khác nhau, nhưng về mặt chức năng thì giống nhau.

Sổ đăng ký hỗ trợ hai định dạng:

Trình xác minh có thể gửi yêu cầu OpenID4VP cho SD-JWT và mdoc khi sử dụng Trình quản lý thông tin xác thực. Lựa chọn này thay đổi tuỳ theo trường hợp sử dụng và lựa chọn ngành.

Đăng ký siêu dữ liệu thông tin xác thực

Trình quản lý thông tin xác thực không lưu trữ trực tiếp thông tin xác thực của chủ sở hữu mà lưu trữ siêu dữ liệu của thông tin xác thực. Trước tiên, ứng dụng lưu trữ phải đăng ký siêu dữ liệu thông tin xác thực với Trình quản lý thông tin xác thực bằng RegistryManager. Quy trình đăng ký này tạo ra một bản ghi trong sổ đăng ký, phục vụ hai mục đích chính:

  • So khớp: Siêu dữ liệu thông tin xác thực đã đăng ký được dùng để so khớp với các yêu cầu của trình xác minh trong tương lai.
  • Hiển thị: Các phần tử trên giao diện người dùng tuỳ chỉnh sẽ xuất hiện cho người dùng trên giao diện bộ chọn thông tin xác thực.

Sử dụng lớp OpenId4VpRegistry để đăng ký thông tin xác thực kỹ thuật số, vì lớp này hỗ trợ cả định dạng thông tin xác thực mdoc và SD-JWT. Bên xác minh sẽ gửi yêu cầu OpenID4VP để yêu cầu các thông tin xác thực này.

Phương thức cấp thông tin xác thực

Bạn có thể kích hoạt việc cấp thông tin xác thực theo hai cách:

  • Quy trình do tổ chức phát hành bắt đầu: người dùng kích hoạt yêu cầu phát hành VDC từ một ứng dụng hoặc trang web của tổ chức phát hành. Ví dụ: một trang web có thể cung cấp cho người dùng lựa chọn "Thêm hộ chiếu vào ví". Tổ chức phát hành gọi API phát hành của Trình quản lý thông tin xác thực để gửi yêu cầu Đề nghị cấp thông tin xác thực OpenID4VCI. Để xử lý các yêu cầu như vậy, trước tiên, người lưu giữ phải tích hợp với Trình quản lý thông tin xác thực để đăng ký siêu dữ liệu của mình. Trình quản lý thông tin xác thực sẽ hiển thị các lựa chọn phù hợp để người dùng chọn. Sau khi người dùng chọn một ứng dụng của bên lưu giữ, ứng dụng đó sẽ được gọi và có thể tiếp tục thực hiện các bước cần thiết để hoàn tất quy trình phát hành.
  • Quy trình do chủ sở hữu bắt đầu: người dùng yêu cầu thêm VDC từ ứng dụng của chủ sở hữu. Ví dụ: một chủ sở hữu có thể cung cấp nút "Thêm hộ chiếu của bạn". Trong trường hợp này, người sở hữu sẽ duy trì danh sách và siêu dữ liệu của tổ chức phát hành được hỗ trợ. Ứng dụng không cần tích hợp với Trình quản lý thông tin xác thực Android để hoàn tất chức năng này.