Method: vdc.proofUser

Конечная точка для подтверждения подлинности цифровых учетных данных пользователя с использованием указанного эмитентом списка доказательств и для конкретного устройства.

HTTP-запрос

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

Текст запроса

Тело запроса содержит данные следующей структуры:

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.
}
Поля
requestMetadata

object ( RequestMetadata )

Метаданные о запросе, необходимые для всех запросов.

deviceReferenceId

string

Идентификатор, соответствующий устройству, и ключ идентификации, связанный с устройством. Это НЕ идентификатор устройства, то есть, если у пользователя будут две разные учетные данные на одном устройстве, этот идентификатор будет отличаться для них.

Этот идентификатор указывается во всех запросах и может использоваться для сопоставления запросов.

proofingId

string

Непрозрачный идентификатор, представляющий собой проверку с использованием определенного набора доказательств для конкретного устройства.

Пример: UUID

evidence[]

object ( ProofingEvidence )

Список доказательств, необходимых для подтверждения личности пользователя при получении цифровых учетных данных.

Поле объединения proofing_context . Контекст проверки. Пустое для первоначальной проверки. proofing_context может принимать только одно из следующих значений:
reverificationContext

object ( ReverificationContext )

Контекст для проверки и подтверждения достоверности данных.

Ответный текст

Подтверждение запроса на проверку подлинности цифровых учетных данных пользователя, указывающее на то, что проверка в данный момент находится в процессе обработки.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Поля
responseMetadata

object ( ResponseMetadata )

Метаданные об ответе, обязательные для всех ответов.

proofingId

string

Непрозрачный идентификатор, представляющий собой проверку с конкретным набором доказательств для конкретного устройства. Это тот же идентификатор проверки, который был отправлен в запросе.

Проверка доказательств

Объект, представляющий собой единичный фрагмент доказательства.

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.
}
Поля
Поле объединения evidence_type . Тип данных, указывающий на способ представления доказательств. evidence_type может принимать только одно из следующих значений:
preAuthorizationCode

object ( Evidence )

Предварительный код авторизации отправляется эмитентом.

Доказательство

Объект, представляющий собой единичный фрагмент доказательства.

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.
}
Поля
presencetype поля объединения. Значение типа «один из», указывающее на способ представления доказательств. presencetype может принимать только одно из следующих значений:
encryptedData

object ( EncryptedData )

Зашифрованное значение и метаданные шифрования, необходимые для расшифровки этого значения.

unencryptedValue

string

Закодированное в base64 значение доказательства.

unencryptedInteger

integer

Целочисленная ценность доказательств.

Контекст повторной проверки

Контекст, необходимый для запуска повторной проверки учетных данных.

JSON-представление 
{
  "credentialId": string
}
Поля
credentialId

string

Идентификатор учетных данных, для которых выполняется повторная проверка.