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)

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

string

L'ID corrispondente al dispositivo e la chiave di identità associata al dispositivo. Non si tratta di un ID dispositivo, il che significa che se l'utente avesse due credenziali separate sullo stesso dispositivo, questo ID sarebbe diverso.

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

string

Un identificatore opaco che rappresenta una verifica con un bundle specifico di prove per un dispositivo specifico.

Esempio: UUID
evidence[]

object (ProofingEvidence)

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

object (ReverificationContext)

Il contesto per la verifica della riprova.

Corpo della risposta

Una conferma di una richiesta di verifica dell'identità di un utente per una credenziale digitale, che indica che la verifica è in corso.

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)

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

string

L'identificatore opaco che rappresenta una verifica con un bundle specifico di prove per un dispositivo specifico. Si tratta dello stesso ID prova 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. Un valore oneof che indica come vengono presentate le prove. evidence_type può essere solo uno dei seguenti tipi:
preAuthorizationCode

object (Evidence)

Codice di preautorizzazione 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. Un valore 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 crittografia necessari per decriptarlo.
unencryptedValue

string

Il valore con codifica Base64 della prova.
unencryptedInteger

integer

Valore intero della prova.

ReverificationContext

Il contesto necessario per attivare la nuova verifica della credenziale.

Rappresentazione JSON 
{
  "credentialId": string
}
Campi
credentialId

string

L'ID credenziale su cui viene eseguita la nuova verifica.