Method: vdc.proofUser

Punkt końcowy do weryfikacji użytkownika na potrzeby cyfrowych danych uwierzytelniających przy użyciu listy dowodów określonej przez wystawcę i na konkretnym urządzeniu.

Żądanie HTTP

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
requestMetadata

object (RequestMetadata)

Wymagane. Metadane żądania, wymagane we wszystkich żądaniach.
deviceReferenceId

string

Wymagane. Identyfikator odpowiadający urządzeniu i kluczowi tożsamości powiązanemu z urządzeniem. NIE jest to identyfikator urządzenia, co oznacza, że jeśli użytkownik ma 2 osobne dane uwierzytelniające na tym samym urządzeniu, ten identyfikator będzie się różnić.

Ten identyfikator jest podawany we wszystkich żądaniach i może służyć do korelowania żądań.
proofingId

string

Wymagane. Nieprzezroczysty identyfikator reprezentujący weryfikację z określonym pakietem dowodów na konkretnym urządzeniu.

Przykład: UUID
evidence[]

object (ProofingEvidence)

Wymagane. Lista dowodów potrzebnych do weryfikacji użytkownika na potrzeby cyfrowych danych uwierzytelniających.
Pole zbiorcze proofing_context. Kontekst weryfikacji. Puste w przypadku wstępnej weryfikacji. proofing_context może mieć tylko jedną z tych wartości:
reverificationContext

object (ReverificationContext)

Kontekst weryfikacji ponownej.

Treść odpowiedzi

Potwierdzenie żądania weryfikacji użytkownika na potrzeby cyfrowych danych uwierzytelniających, które wskazuje, że weryfikacja jest w trakcie przetwarzania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Pola
responseMetadata

object (ResponseMetadata)

Wymagane. Metadane odpowiedzi, wymagane we wszystkich odpowiedziach.
proofingId

string

Wymagane. Nieprzezroczysty identyfikator reprezentujący weryfikację z określonym pakietem dowodów na konkretnym urządzeniu. Jest to ten sam identyfikator weryfikacji, który został wysłany w żądaniu.

ProofingEvidence

Obiekt reprezentujący pojedynczy dowód.

Zapis 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.
}
Pola
Pole zbiorcze evidence_type. Wymagane. Pole oneof wskazujące, jak przedstawiane są dowody. evidence_type może mieć tylko jedną z tych wartości:
preAuthorizationCode

object (Evidence)

Kod wstępnej autoryzacji wysłany przez wystawcę.

Dowody

Obiekt reprezentujący pojedynczy dowód.

Zapis 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.
}
Pola
Pole zbiorcze presencetype. Wymagane. Pole oneof wskazujące, jak przedstawiane są dowody. presencetype może mieć tylko jedną z tych wartości:
encryptedData

object (EncryptedData)

Zaszyfrowana wartość i metadane szyfrowania niezbędne do odszyfrowania wartości.
unencryptedValue

string

Wartość dowodu zakodowana w formacie base64.
unencryptedInteger

integer

Wartość całkowita dowodu.

ReverificationContext

Kontekst wymagany do wywołania ponownej weryfikacji danych uwierzytelniających.

Zapis JSON 
{
  "credentialId": string
}
Pola
credentialId

string

Wymagane. Identyfikator danych uwierzytelniających, w przypadku których przeprowadzana jest ponowna weryfikacja.