Method: vdc.proofUser

ปลายทางเพื่อพิสูจน์ตัวตนของผู้ใช้สำหรับข้อมูลเข้าสู่ระบบดิจิทัล โดยใช้รายการหลักฐานที่ผู้ออกใบรับรองระบุ และสำหรับอุปกรณ์ที่เฉพาะเจาะจง

คำขอ HTTP

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

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง 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.
}
ช่อง
requestMetadata

object (RequestMetadata)

ข้อมูลเมตาเกี่ยวกับคำขอ ซึ่งจำเป็นในคำขอทั้งหมด
deviceReferenceId

string

รหัสที่สอดคล้องกับอุปกรณ์และคีย์ข้อมูลประจำตัวที่เชื่อมโยงกับอุปกรณ์ นี่ไม่ใช่รหัสอุปกรณ์ ซึ่งหมายความว่าหากผู้ใช้มีข้อมูลเข้าสู่ระบบ 2 ชุดแยกกันในอุปกรณ์เดียวกัน รหัสนี้จะแตกต่างกัน

รหัสนี้จะระบุในคำขอทั้งหมด และใช้เพื่อเชื่อมโยงคำขอได้
proofingId

string

ตัวระบุที่ไม่โปร่งใสซึ่งแสดงการพิสูจน์ด้วยชุดหลักฐานที่เฉพาะเจาะจงสำหรับอุปกรณ์ที่เฉพาะเจาะจง

เช่น UUID
evidence[]

object (ProofingEvidence)

รายการหลักฐานที่จำเป็นในการพิสูจน์ตัวตนของผู้ใช้สำหรับข้อมูลเข้าสู่ระบบดิจิทัล
ฟิลด์ Union proofing_context บริบทสำหรับการพิสูจน์ เว้นว่างไว้สำหรับการพิสูจน์อักษรครั้งแรก proofing_context ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
reverificationContext

object (ReverificationContext)

บริบทสำหรับการพิสูจน์การยืนยันอีกครั้ง

เนื้อหาการตอบกลับ

การรับทราบคำขอพิสูจน์ตัวตนของผู้ใช้สำหรับเอกสารรับรองดิจิทัล ซึ่งระบุว่าขณะนี้ระบบกำลังดำเนินการพิสูจน์ตัวตน

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
ช่อง
responseMetadata

object (ResponseMetadata)

ข้อมูลเมตาเกี่ยวกับคำตอบ ซึ่งจำเป็นต้องมีในคำตอบทั้งหมด
proofingId

string

ตัวระบุทึบแสงที่แสดงการพิสูจน์ด้วยชุดหลักฐานที่เฉพาะเจาะจงสำหรับอุปกรณ์ที่เฉพาะเจาะจง ซึ่งเป็นรหัสหลักฐานเดียวกันกับที่ส่งในคำขอ

ProofingEvidence

ออบเจ็กต์ที่แสดงหลักฐานชิ้นเดียว

การแสดง 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.
}
ช่อง
ฟิลด์ Union evidence_type oneof ที่ระบุวิธีนำเสนอหลักฐาน evidence_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
preAuthorizationCode

object (Evidence)

รหัสการให้สิทธิ์ล่วงหน้าที่ส่งจากผู้ออกบัตร

หลักฐาน

ออบเจ็กต์ที่แสดงหลักฐานชิ้นเดียว

การแสดง 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.
}
ช่อง
ฟิลด์ Union presencetype oneof ที่ระบุวิธีนำเสนอหลักฐาน presencetype ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
encryptedData

object (EncryptedData)

ค่าที่เข้ารหัสและข้อมูลเมตาการเข้ารหัสที่จำเป็นต่อการถอดรหัสค่า
unencryptedValue

string

ค่าที่เข้ารหัส Base64 ของหลักฐาน
unencryptedInteger

integer

ค่าจำนวนเต็มของหลักฐาน

ReverificationContext

บริบทที่จำเป็นต่อการเรียกใช้การยืนยันอีกครั้งสำหรับข้อมูลเข้าสู่ระบบ

การแสดง JSON 
{
  "credentialId": string
}
ช่อง
credentialId

string

รหัสข้อมูลเข้าสู่ระบบที่ใช้ในการยืนยันอีกครั้ง