Method: vdc.provisionCredential

Kimlik bilgisi sağlamak için kullanılan bir uç nokta.

HTTP isteği

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

İstek metni

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

JSON gösterimi 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "credentialId": string,
  "proofingId": string,
  "deviceEncryptionKey": {
    object (DeviceEncryptionKey)
  }
}
Alanlar
requestMetadata

object (RequestMetadata)

İstekle ilgili meta veriler (tüm isteklerde gereklidir).
deviceReferenceId

string

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 bilgileri arasında farklılık gösterir.

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

string

Bir cihaza sağlanan belirli bir kimlik bilgisini temsil eden opak tanımlayıcı.

credentialId zaten varsa bu yöntem yeni bir kimlik bilgisi oluşturmak yerine mevcut kimlik bilgisini döndürmelidir.

Ör: UUID
proofingId

string

Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir kanıtlamayı temsil eden opak tanımlayıcı.

Onay, Onaylandı durumunda olmalıdır. Aksi takdirde, geçersiz tanımlayıcı ErrorResponse döndürülmelidir.
deviceEncryptionKey

object (DeviceEncryptionKey)

Cihazın kısa ömürlü şifreleme anahtarını ve ilişkili meta verileri içeren bir nesne. Bu anahtar, bir değeri cihaza geri şifrelemek için kullanılır. Bu nesne, oryantasyon sırasında korumalı alan ortamında sağlanmayabilir. Bu durumda, veren tarafın düz metin verileri döndürmesi gerekir. Bu değer her zaman üretim ortamında ayarlanmalıdır.

Yanıt metni

Sağlanan kimlik bilgilerini içeren bir yanıt.

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

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

object (ResponseMetadata)

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

object (Credential)

Sağlanan kimlik bilgisi.
credentialVersionId

string

Temel hazırlığı yapılmış kimlik bilgisinin mevcut sürümü.

Kimlik bilgisi

Kimlik bilgisi türüyle ilgili ISO standardında tanımlandığı şekilde, mdoc tabanlı kimlik bilgisi.

Örneğin, mobil sürücü belgesi için bu standart ISO/IEC 18013-5'tir. mDL mDoc biçimi için buraya bakın.

JSON gösterimi 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string
  // End of list of possible types for union field presencetype.
}
Alanlar
presencetype birleşik alanı. Kimlik bilgisinin 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

Kimlik bilgisinin Base64 kodlu değeri.