Method: vdc.provisionCredential

Một điểm cuối để cung cấp thông tin xác thực.

Yêu cầu HTTP

POST https://example.issuer.com/api/v1/vdc/provisionCredential

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "credentialId": string,
  "proofingId": string,
  "deviceEncryptionKey": {
    object (DeviceEncryptionKey)
  }
}
Trường
requestMetadata

object (RequestMetadata)

Bắt buộc. Siêu dữ liệu về yêu cầu, bắt buộc trong tất cả các yêu cầu.
deviceReferenceId

string

Bắt buộc. Mã nhận dạng tương ứng với thiết bị và khoá nhận dạng được liên kết với thiết bị. Đây KHÔNG phải là mã nhận dạng thiết bị, tức là nếu người dùng có 2 thông tin đăng nhập riêng biệt trên cùng một thiết bị, thì mã nhận dạng này sẽ khác nhau giữa 2 thông tin đăng nhập đó.

Mã nhận dạng này được cung cấp trong tất cả các yêu cầu và có thể dùng để liên kết các yêu cầu.
credentialId

string

Bắt buộc. Giá trị nhận dạng mờ đại diện cho một thông tin đăng nhập cụ thể được cung cấp cho một thiết bị.

Nếu credentialId đã tồn tại, thay vì tạo một thông tin đăng nhập mới, phương thức này sẽ trả về thông tin đăng nhập hiện có.

Ví dụ: UUID
proofingId

string

Bắt buộc. Giá trị nhận dạng mờ đại diện cho một quy trình chứng minh bằng một gói bằng chứng cụ thể cho một thiết bị cụ thể.

Bản hiệu đính phải ở trạng thái Đã phê duyệt. Nếu không, bạn nên trả về một ErrorResponse giá trị nhận dạng không hợp lệ.
deviceEncryptionKey

object (DeviceEncryptionKey)

Bắt buộc. Một đối tượng chứa khoá mã hoá tạm thời của thiết bị và siêu dữ liệu liên quan. Khoá này được dùng để mã hoá một giá trị trở lại thiết bị. Đối tượng này có thể không được cung cấp trong môi trường hộp cát trong quá trình tham gia, cho biết nhà phát hành phải trả về dữ liệu văn bản thuần tuý. Bạn phải luôn đặt giá trị này trong môi trường thực tế.

Nội dung phản hồi

Phản hồi chứa thông tin xác thực được cung cấp.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "credential": {
    object (Credential)
  },
  "credentialVersionId": string
}
Trường
responseMetadata

object (ResponseMetadata)

Bắt buộc. Siêu dữ liệu về phản hồi, bắt buộc trong tất cả các phản hồi.
credential

object (Credential)

Bắt buộc. Thông tin xác thực được cấp.
credentialVersionId

string

Bắt buộc. Phiên bản hiện tại của thông tin đăng nhập đã được cấp phép.

Thông tin xác thực

Thông tin đăng nhập dựa trên mdoc, theo định nghĩa của tiêu chuẩn ISO có liên quan cho loại thông tin đăng nhập.

Ví dụ: đối với giấy phép lái xe di động, đây sẽ là ISO/IEC 18013-5. Hãy xem nội dung này để biết định dạng mDL mDoc.

Biểu diễn dưới dạng JSON 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string
  // End of list of possible types for union field presencetype.
}
Trường
Trường nhóm presencetype. Bắt buộc. Một trong những cách cho biết cách thông tin đăng nhập đang được trình bày. presencetype chỉ có thể là một trong những trạng thái sau:
encryptedData

object (EncryptedData)

Giá trị đã mã hoá và siêu dữ liệu mã hoá cần thiết để giải mã giá trị.
unencryptedValue

string

Giá trị được mã hoá base64 của thông tin đăng nhập.