Method: vdc.proofUser

Yayıncı tarafından belirtilen bir kanıt listesi ve belirli bir cihaz kullanılarak kullanıcının dijital kimlik bilgisi için kanıtlandığı bir uç nokta.

HTTP isteği

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

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "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.
}
Alanlar
requestMetadata

object (RequestMetadata)

Zorunlu. İstekle ilgili meta veriler. Tüm isteklerde gereklidir.

deviceReferenceId

string

Zorunlu. Cihaza karşılık gelen kimlik ve cihazla ilişkili kimlik anahtarı. Bu, bir cihaz kimliği DEĞİLDİR. Yani kullanıcının aynı cihazda iki ayrı kimlik bilgisi varsa bu kimlik, kimlik bilgileri arasında farklılık gösterir.

Bu kimlik tüm isteklerde sağlanır ve istekleri ilişkilendirmek için kullanılabilir.

proofingId

string

Zorunlu. Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir doğrulama işlemini temsil eden opak tanımlayıcı.

Ör: UUID

evidence[]

object (ProofingEvidence)

Zorunlu. Kullanıcının dijital kimlik bilgilerini kanıtlamak için gereken kanıtların listesi.

proofing_context birleşik alanı. Düzeltme bağlamı. İlk düzeltme için boş bırakın. proofing_context aşağıdakilerden yalnızca biri olabilir:
reverificationContext

object (ReverificationContext)

Yeniden doğrulama düzeltme bağlamı.

Yanıt metni

Kullanıcının dijital kimlik belgesi için kimlik doğrulama isteğinin alındığını ve kimlik doğrulama işleminin devam ettiğini belirten bir onay.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Alanlar
responseMetadata

object (ResponseMetadata)

Zorunlu. Yanıtla ilgili meta veriler. Tüm yanıtlarda gereklidir.

proofingId

string

Zorunlu. Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir kanıtlamayı temsil eden opak tanımlayıcı. Bu, istekte gönderilen kimlik belgesiyle aynıdır.

ProofingEvidence

Tek bir kanıtı temsil eden nesne.

JSON gösterimi
{

  // 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.
}
Alanlar
evidence_type birleşik alanı. Zorunlu. Kanıtın nasıl sunulduğunu belirten bir oneof. evidence_type aşağıdakilerden yalnızca biri olabilir:
preAuthorizationCode

object (Evidence)

Kart sağlayıcı tarafından gönderilen ön yetkilendirme kodu.

Kanıt

Tek bir kanıtı temsil eden nesne.

JSON gösterimi
{

  // 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.
}
Alanlar
presencetype birleşik alanı. Zorunlu. Kanıtın nasıl sunulduğunu belirten bir oneof. presencetype aşağıdakilerden yalnızca biri olabilir:
encryptedData

object (EncryptedData)

Şifrelenmiş değer ve değeri çözmek için gerekli şifreleme meta verileri.

unencryptedValue

string

Kanıtın base64 kodlu değeri.

unencryptedInteger

integer

Kanıtın tam sayı değeri.

ReverificationContext

Kimlik bilgisinin yeniden doğrulanmasını tetiklemek için gereken bağlam.

JSON gösterimi
{
  "credentialId": string
}
Alanlar
credentialId

string

Zorunlu. Yeniden doğrulamanın yapıldığı kimlik bilgisi.