Method: vdc.proofUser

Punkt końcowy do weryfikacji użytkownika na potrzeby cyfrowych poświadczeń 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)

Metadane dotyczące żądania, wymagane we wszystkich żądaniach.
deviceReferenceId

string

Identyfikator odpowiadający urządzeniu i klucz tożsamości powiązany z urządzeniem. NIE jest to identyfikator urządzenia, co oznacza, że jeśli użytkownik ma 2 osobne dane logowania 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 ich korelowania.
proofingId

string

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

Przykład: UUID
evidence[]

object (ProofingEvidence)

Lista dowodów potrzebnych do potwierdzenia tożsamości użytkownika w przypadku cyfrowych danych uwierzytelniających.
Pole zbiorcze proofing_context. Kontekst korekty. W przypadku wstępnej korekty pozostaw to pole puste. proofing_context może mieć tylko jedną z tych wartości:
reverificationContext

object (ReverificationContext)

Kontekst weryfikacji ponownej.

Treść odpowiedzi

Potwierdzenie otrzymania prośby o weryfikację użytkownika na potrzeby cyfrowych danych logowania, które wskazuje, że weryfikacja jest obecnie przetwarzana.

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

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

object (ResponseMetadata)

Metadane dotyczące odpowiedzi, wymagane we wszystkich odpowiedziach.
proofingId

string

Nieprzezroczysty identyfikator reprezentujący weryfikację z określonym pakietem dowodów na konkretnym urządzeniu. Jest to ten sam identyfikator dowodu, 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. Typ wyliczeniowy wskazujący, w jaki sposób przedstawiane są dowody. evidence_type może mieć tylko jedną z tych wartości:
preAuthorizationCode

object (Evidence)

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

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. Typ wyliczeniowy wskazujący, w jaki sposób przedstawiane są dowody. presencetype może mieć tylko jedną z tych wartości:
encryptedData

object (EncryptedData)

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

string

Wartość dowodu zakodowana w formacie base64.
unencryptedInteger

integer

Wartość dowodu w postaci liczby całkowitej.

ReverificationContext

Kontekst wymagany do wywołania ponownej weryfikacji danych logowania.

Zapis JSON 
{
  "credentialId": string
}
Pola
credentialId

string

Identyfikator danych logowania, na których przeprowadzana jest ponowna weryfikacja.