Method: vdc.proofUser

Point de terminaison pour vérifier le justificatif numérique d'un utilisateur à l'aide d'une liste de preuves spécifiée par l'émetteur et pour un appareil spécifique.

Requête HTTP

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

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
requestMetadata

object (RequestMetadata)

Obligatoire. Métadonnées concernant la requête, obligatoires dans toutes les requêtes.
deviceReferenceId

string

Obligatoire. ID correspondant à l'appareil et à la clé d'identité associée à l'appareil. Il ne s'agit PAS d'un ID d'appareil. Par conséquent, si l'utilisateur possède deux identifiants distincts sur le même appareil, cet ID sera différent pour chacun d'eux.

Cet identifiant est fourni dans toutes les requêtes et peut être utilisé pour corréler des requêtes.
proofingId

string

Obligatoire. Identifiant opaque représentant une confirmation d'identité, avec un ensemble spécifique de preuves, pour un appareil spécifique.

Exemple : UUID
evidence[]

object (ProofingEvidence)

Obligatoire. Liste des preuves nécessaires pour vérifier le justificatif numérique d'un utilisateur.
Champ d'union proofing_context. Contexte de la confirmation d'identité. Vide pour la confirmation d'identité initiale. proofing_context ne peut être qu'un des éléments suivants :
reverificationContext

object (ReverificationContext)

Contexte de la confirmation d'identité pour la revérification.

Corps de la réponse

Accusé de réception d'une requête de vérification de l'identité d'un utilisateur pour un justificatif numérique, qui indique que la confirmation d'identité est en cours de traitement.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Champs
responseMetadata

object (ResponseMetadata)

Obligatoire. Métadonnées concernant la réponse, obligatoires dans toutes les réponses.
proofingId

string

Obligatoire. Identifiant opaque représentant une confirmation d'identité, avec un ensemble spécifique de preuves, pour un appareil spécifique. Il s'agit du même ID de preuve que celui envoyé dans la requête.

ProofingEvidence

Objet représentant un unique élément de preuve.

Représentation 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.
}
Champs
Champ d'union evidence_type. Obligatoire. Oneof indiquant la manière dont la preuve est présentée. evidence_type ne peut être qu'un des éléments suivants :
preAuthorizationCode

object (Evidence)

Code de pré-autorisation envoyé par l'émetteur.

Preuves

Objet représentant un unique élément de preuve.

Représentation 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.
}
Champs
Champ d'union presencetype. Obligatoire. Oneof indiquant la manière dont la preuve est présentée. presencetype ne peut être qu'un des éléments suivants :
encryptedData

object (EncryptedData)

Valeur chiffrée et métadonnées de chiffrement nécessaires pour déchiffrer la valeur.
unencryptedValue

string

Valeur de la preuve encodée en base64.
unencryptedInteger

integer

Valeur entière de la preuve.

ReverificationContext

Contexte requis pour déclencher la revérification du justificatif.

Représentation JSON 
{
  "credentialId": string
}
Champs
credentialId

string

Obligatoire. ID du justificatif sur lequel la revérification est effectuée.