Method: vdc.proofUser

Endpoint untuk membuktikan pengguna untuk kredensial digital, menggunakan daftar bukti yang ditentukan penerbit, dan untuk perangkat tertentu.

Permintaan HTTP

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

Isi Permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
requestMetadata

object (RequestMetadata)

Wajib. Metadata tentang permintaan, yang diperlukan dalam semua permintaan.
deviceReferenceId

string

Wajib. ID yang sesuai dengan perangkat dan kunci identitas yang terkait dengan perangkat. Ini BUKAN ID perangkat, yang berarti jika pengguna memiliki dua kredensial terpisah di perangkat yang sama, ID ini akan berbeda di antara keduanya.

ID ini diberikan dalam semua permintaan, dan dapat digunakan untuk mengorelasikan permintaan.
proofingId

string

Wajib. ID buram yang mewakili pembuktian dengan paket bukti tertentu, untuk perangkat tertentu.

Contoh: UUID
evidence[]

object (ProofingEvidence)

Wajib. Daftar bukti yang diperlukan untuk membuktikan pengguna untuk kredensial digital.
Kolom union proofing_context. Konteks untuk pembuktian. Kosong untuk pembuktian awal. proofing_context hanya dapat berupa salah satu dari berikut:
reverificationContext

object (ReverificationContext)

Konteks untuk pembuktian verifikasi ulang.

Isi respons

Pengakuan atas permintaan untuk membuktikan pengguna untuk kredensial digital, yang menunjukkan bahwa pembuktian kini sedang diproses.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Kolom
responseMetadata

object (ResponseMetadata)

Wajib. Metadata tentang respons, yang diperlukan dalam semua respons.
proofingId

string

Wajib. ID buram yang mewakili pembuktian dengan paket bukti tertentu, untuk perangkat tertentu. Ini adalah ID pembuktian yang sama yang dikirim dalam permintaan.

ProofingEvidence

Objek yang mewakili satu bukti.

Representasi 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.
}
Kolom
Kolom union evidence_type. Wajib. Oneof yang menunjukkan cara bukti disajikan. evidence_type hanya dapat berupa salah satu dari berikut:
preAuthorizationCode

object (Evidence)

Kode pra-otorisasi yang dikirim dari penerbit.

Bukti

Objek yang mewakili satu bukti.

Representasi 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.
}
Kolom
Kolom union presencetype. Wajib. Oneof yang menunjukkan cara bukti disajikan. presencetype hanya dapat berupa salah satu dari berikut:
encryptedData

object (EncryptedData)

Nilai terenkripsi dan metadata enkripsi yang diperlukan untuk mendekripsi nilai.
unencryptedValue

string

Nilai bukti yang dienkode base64.
unencryptedInteger

integer

Nilai bilangan bulat dari bukti.

ReverificationContext

Konteks yang diperlukan untuk memicu verifikasi ulang untuk kredensial.

Representasi JSON 
{
  "credentialId": string
}
Kolom
credentialId

string

Wajib. ID kredensial yang digunakan untuk melakukan verifikasi ulang.