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 ( |
| Alanlar | |
|---|---|
requestMetadata |
İstekle ilgili meta veriler (tüm isteklerde gereklidir). |
deviceReferenceId |
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. |
proofingId |
Belirli bir cihaz için belirli bir kanıt paketiyle yapılan bir kanıtlamayı temsil eden opak tanımlayıcı. Ör: UUID |
evidence[] |
Kullanıcının dijital kimlik bilgisi için kanıtlanması gereken kanıtların listesi. |
proofing_context birleşik alanı. Düzeltme bağlamı. İlk inceleme için boş bırakın. proofing_context aşağıdakilerden yalnızca biri olabilir: |
|
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 onay.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
|---|
{
"responseMetadata": {
object ( |
| Alanlar | |
|---|---|
responseMetadata |
Yanıtla ilgili meta veriler. Tüm yanıtlarda gereklidir. |
proofingId |
Belirli bir cihaz için belirli bir kanıt paketiyle yapılan incelemeyi 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 |
| Alanlar | |
|---|---|
evidence_type birleşik alanı. Kanıtın nasıl sunulduğunu belirten bir oneof. evidence_type aşağıdakilerden yalnızca biri olabilir: |
|
preAuthorizationCode |
Kartı veren kuruluş tarafından gönderilen ön yetkilendirme kodu. |
Kanıt
Tek bir kanıtı temsil eden nesne.
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
presencetype birleşik alanı. Kanıtın nasıl sunulduğunu belirten bir oneof. presencetype aşağıdakilerden yalnızca biri olabilir: |
|
encryptedData |
Şifrelenmiş değer ve değeri çözmek için gerekli şifreleme meta verileri. |
unencryptedValue |
Kanıtın base64 kodlu değeri. |
unencryptedInteger |
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 |
Yeniden doğrulamanın yapıldığı kimlik bilgisi kimliği. |