Method: vdc.proofUser

Ein Endpunkt, um einen Nutzer mit einer vom Aussteller angegebenen Liste von Nachweisen für einen digitalen Berechtigungsnachweis und ein bestimmtes Gerät zu prüfen.

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
requestMetadata

object (RequestMetadata)

Erforderlich. Die Metadaten zur Anfrage, die in allen Anfragen erforderlich sind.
deviceReferenceId

string

Erforderlich. Die zum Gerät gehörende ID und der mit dem Gerät verknüpfte Identitätsschlüssel. Dies ist KEINE Geräte-ID. Wenn der Nutzer also zwei separate Berechtigungsnachweise auf demselben Gerät hat, unterscheidet sich diese ID zwischen ihnen.

Die ID wird bei allen Anfragen angegeben und kann dazu verwendet werden, Anfragen zu korrelieren.
proofingId

string

Erforderlich. Eine intransparente Kennung, die eine Prüfung mit einem speziellen Nachweisbündel für ein bestimmtes Gerät darstellt.

Beispiel: UUID
evidence[]

object (ProofingEvidence)

Erforderlich. Die Liste der Nachweise, die erforderlich sind, um einen Nutzer für einen digitalen Berechtigungsnachweis zu prüfen.
Union-Feld proofing_context. Der Kontext für die Prüfung. Für die erste Prüfung leer. Für proofing_context ist nur einer der folgenden Werte zulässig:
reverificationContext

object (ReverificationContext)

Der Kontext für die Prüfung zur erneuten Verifizierung.

Antworttext

Eine Bestätigung auf eine Anfrage zur Prüfung eines Nutzers für einen digitalen Berechtigungsnachweis, die über die Bearbeitung der Prüfung informiert.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Felder
responseMetadata

object (ResponseMetadata)

Erforderlich. Die Metadaten zur Antwort, die in allen Antworten erforderlich sind.
proofingId

string

Erforderlich. Die intransparente Kennung, die eine Prüfung mit einem speziellen Nachweisbündel für ein bestimmtes Gerät darstellt. Dies ist dieselbe Prüfungs-ID, die in der Anfrage gesendet wurde.

ProofingEvidence

Ein Objekt, das einen einzelnen Nachweis darstellt.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld evidence_type Erforderlich. Ein oneof, das angibt, wie der Nachweis vorgelegt wird. Für evidence_type ist nur einer der folgenden Werte zulässig:
preAuthorizationCode

object (Evidence)

Vorautorisierungscode, der vom Aussteller gesendet wurde.

Belege

Ein Objekt, das einen einzelnen Nachweis darstellt.

JSON-Darstellung 
{

  // 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.
}
Felder
Union-Feld presencetype Erforderlich. Ein oneof, das angibt, wie der Nachweis vorgelegt wird. Für presencetype ist nur einer der folgenden Werte zulässig:
encryptedData

object (EncryptedData)

Der verschlüsselte Wert und die Verschlüsselungsmetadaten, die zum Entschlüsseln des Werts erforderlich sind.
unencryptedValue

string

Der base64-codierte Wert des Nachweises.
unencryptedInteger

integer

Ganzzahlwert des Nachweises.

ReverificationContext

Der Kontext, der erforderlich ist, um die erneute Verifizierung für den Berechtigungsnachweis auszulösen.

JSON-Darstellung 
{
  "credentialId": string
}
Felder
credentialId

string

Erforderlich. Die Berechtigungsnachweis-ID, für die die erneute Verifizierung durchgeführt wird.