Method: vdc.proofUser

Es un extremo para probar un usuario para una credencial digital, usando una lista de evidencias especificada por el emisor y para un dispositivo específico.

Solicitud HTTP

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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.
}
Campos
requestMetadata

object (RequestMetadata)

Son los metadatos sobre la solicitud, que se requieren en todas las solicitudes.
deviceReferenceId

string

Es el ID que corresponde al dispositivo y la clave de identidad asociada a él. NO es un ID de dispositivo, lo que significa que, si el usuario tuviera dos credenciales separadas en el mismo dispositivo, este ID sería diferente entre ellas.

Este ID se proporciona en todas las solicitudes y se puede usar para correlacionarlas.
proofingId

string

Es un identificador opaco que representa una verificación con un paquete específico de evidencia para un dispositivo específico.

Ejemplo: UUID
evidence[]

object (ProofingEvidence)

Es la lista de pruebas necesarias para verificar la identidad de un usuario para una credencial digital.
Campo de unión proofing_context. Es el contexto para la revisión. Está vacío para la revisión inicial. proofing_context puede ser solo uno de los parámetros siguientes:
reverificationContext

object (ReverificationContext)

Es el contexto para la prueba de reverificación.

Cuerpo de la respuesta

Es una confirmación de una solicitud para verificar la identidad de un usuario para una credencial digital, que indica que la verificación ya se está procesando.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Campos
responseMetadata

object (ResponseMetadata)

Son los metadatos sobre la respuesta, que se requieren en todas las respuestas.
proofingId

string

Es el identificador opaco que representa una prueba con un paquete específico de evidencia para un dispositivo específico. Es el mismo ID de prueba que se envió en la solicitud.

ProofingEvidence

Es un objeto que representa una sola evidencia.

Representación 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.
}
Campos
Campo de unión evidence_type. Es un campo oneof que indica cómo se presenta la evidencia. evidence_type puede ser solo uno de los parámetros siguientes:
preAuthorizationCode

object (Evidence)

Es el código de autorización previa que envía la entidad emisora.

Evidencia

Es un objeto que representa una sola evidencia.

Representación 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.
}
Campos
Campo de unión presencetype. Es un campo oneof que indica cómo se presenta la evidencia. presencetype puede ser solo uno de los parámetros siguientes:
encryptedData

object (EncryptedData)

Es el valor encriptado y los metadatos de encriptación necesarios para desencriptar el valor.
unencryptedValue

string

Es el valor de la evidencia codificado en Base64.
unencryptedInteger

integer

Es el valor entero de la evidencia.

ReverificationContext

Es el contexto necesario para activar la nueva verificación de la credencial.

Representación JSON 
{
  "credentialId": string
}
Campos
credentialId

string

Es el ID de la credencial en la que se realiza la reverificación.