Method: vdc.proofUser

Un endpoint per verificare l'identità di un utente per una credenziale digitale, utilizzando un elenco di prove specificato dall'emittente e per un dispositivo specifico.

Richiesta HTTP

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
requestMetadata

object (RequestMetadata)

Obbligatorio. I metadati relativi alla richiesta, obbligatori in tutte le richieste.
deviceReferenceId

string

Obbligatorio. L'ID che corrisponde al dispositivo e alla chiave di identità associata al dispositivo. Questo NON è un ID dispositivo, il che significa che se l'utente avesse due credenziali separate sullo stesso dispositivo, questo ID sarebbe diverso tra loro.

Questo ID viene fornito in tutte le richieste e può essere utilizzato per correlare le richieste.
proofingId

string

Obbligatorio. Un identificatore opaco che rappresenta una verifica dell'identità con un bundle specifico di prove, per un dispositivo specifico.

Esempio: UUID
evidence[]

object (ProofingEvidence)

Obbligatorio. L'elenco delle prove necessarie per verificare l'identità di un utente per una credenziale digitale.
Campo unione proofing_context. Il contesto per la verifica dell'identità. Vuoto per la verifica dell'identità iniziale. proofing_context può essere solo uno dei seguenti tipi:
reverificationContext

object (ReverificationContext)

Il contesto per la verifica dell'identità di riverifica.

Corpo della risposta

Un riconoscimento di una richiesta di verifica dell'identità di un utente per una credenziale digitale, che indica che la verifica dell'identità è in fase di elaborazione.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Campi
responseMetadata

object (ResponseMetadata)

Obbligatorio. I metadati relativi alla risposta, obbligatori in tutte le risposte.
proofingId

string

Obbligatorio. L'identificatore opaco che rappresenta una verifica dell'identità con un bundle specifico di prove, per un dispositivo specifico. Si tratta dello stesso ID di verifica dell'identità inviato nella richiesta.

ProofingEvidence

Un oggetto che rappresenta una singola prova.

Rappresentazione 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.
}
Campi
Campo unione evidence_type. Obbligatorio. Un oneof che indica come vengono presentate le prove. evidence_type può essere solo uno dei seguenti tipi:
preAuthorizationCode

object (Evidence)

Codice di pre-autorizzazione inviato dall'emittente.

Prove

Un oggetto che rappresenta una singola prova.

Rappresentazione 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.
}
Campi
Campo unione presencetype. Obbligatorio. Un oneof che indica come vengono presentate le prove. presencetype può essere solo uno dei seguenti tipi:
encryptedData

object (EncryptedData)

Il valore criptato e i metadati di criptaggio necessari per decriptare il valore.
unencryptedValue

string

Il valore con codifica Base64 della prova.
unencryptedInteger

integer

Valore intero della prova.

ReverificationContext

Il contesto necessario per attivare la riverifica per la credenziale.

Rappresentazione JSON 
{
  "credentialId": string
}
Campi
credentialId

string

Obbligatorio. L'ID credenziale su cui viene eseguita la riverifica.