Method: vdc.proofUser

Một điểm cuối để chứng minh người dùng có thông tin xác thực kỹ thuật số, bằng cách sử dụng danh sách bằng chứng do nhà phát hành chỉ định và cho một thiết bị cụ thể.

Yêu cầu HTTP

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

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,
  "proofingId": string,
  "evidence": [
    {
      object (ProofingEvidence)
    }
  ],

  // Union field proofing_context can be only one of the following:
  "reverificationContext": {
    object (ReverificationContext)
  }
  // End of list of possible types for union field proofing_context.
}
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.
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ể.

Ví dụ: UUID
evidence[]

object (ProofingEvidence)

Bắt buộc. Danh sách bằng chứng cần thiết để xác minh người dùng cho một thông tin xác thực kỹ thuật số.
Trường nhóm proofing_context. Bối cảnh để hiệu đính. Để trống đối với quy trình hiệu đính ban đầu. proofing_context chỉ có thể là một trong những trạng thái sau:
reverificationContext

object (ReverificationContext)

Bối cảnh để xác minh lại.

Nội dung phản hồi

Một thông báo xác nhận cho yêu cầu chứng minh người dùng bằng thông tin xác thực kỹ thuật số, cho biết rằng yêu cầu chứng minh hiện đang được xử lý.

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)
  },
  "proofingId": 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.
proofingId

string

Bắt buộc. Giá trị nhận dạng không công khai đạ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ể. Đây là mã nhận dạng bằng chứng giống với mã nhận dạng đã được gửi trong yêu cầu.

ProofingEvidence

Một đối tượng đại diện cho một bằng chứng duy nhất.

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

  // Union field evidence_type can be only one of the following:
  "preAuthorizationCode": {
    object (Evidence)
  }
  // End of list of possible types for union field evidence_type.
}
Trường
Trường nhóm evidence_type. Bắt buộc. Một oneof cho biết cách bằng chứng được trình bày. evidence_type chỉ có thể là một trong những trạng thái sau:
preAuthorizationCode

object (Evidence)

Mã uỷ quyền trước do tổ chức phát hành gửi.

Bằng chứng

Một đối tượng đại diện cho một bằng chứng duy nhất.

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

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string,
  "unencryptedInteger": integer
  // End of list of possible types for union field presencetype.
}
Trường
Trường nhóm presencetype. Bắt buộc. Một oneof cho biết cách bằng chứng đượ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 bằng chứng.
unencryptedInteger

integer

Giá trị số nguyên của bằng chứng.

ReverificationContext

Bối cảnh cần thiết để kích hoạt quy trình xác minh lại cho thông tin đăng nhập.

Biểu diễn dưới dạng JSON 
{
  "credentialId": string
}
Trường
credentialId

string

Bắt buộc. Mã nhận dạng thông tin đăng nhập mà quy trình xác minh lại được thực hiện.