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)

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

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ó hai 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 hai 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 để tương quan các yêu cầu.
proofingId

string

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ể.

Ví dụ: UUID
evidence[]

object (ProofingEvidence)

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 đ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)

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

Giá trị nhận dạng không công khai đại diện cho một quy trình xác 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 bằng chứ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. 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. 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

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.