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

필수 항목입니다. 기기 및 기기와 연결된 ID 키에 해당하는 ID입니다. 기기 ID가 아닙니다. 즉, 사용자가 동일한 기기에 두 개의 별도 사용자 인증 정보를 보유하는 경우 이 ID는 사용자 인증 정보 간에 다릅니다.

이 ID는 모든 요청에 제공되며 요청을 상호 연결하는 데 사용할 수 있습니다.
proofingId

string

필수 항목입니다. 특정 기기의 특정 증거 번들로 증명을 나타내는 불투명 식별자입니다.

예: UUID
evidence[]

object (ProofingEvidence)

필수 항목입니다. 디지털 사용자 인증 정보를 증명하는 데 필요한 증거 목록입니다.
통합 필드 proofing_context. 증명 컨텍스트입니다. 초기 증명의 경우 비어 있습니다. proofing_context는 다음 중 하나여야 합니다.
reverificationContext

object (ReverificationContext)

재확인 증명의 컨텍스트입니다.

응답 본문

디지털 사용자 인증 정보를 증명하는 요청에 대한 승인으로, 증명이 현재 처리 중임을 나타냅니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
필드
responseMetadata

object (ResponseMetadata)

필수 항목입니다. 모든 응답에 필요한 응답에 관한 메타데이터입니다.
proofingId

string

필수 항목입니다. 특정 기기의 특정 증거 번들로 증명을 나타내는 불투명 식별자입니다. 요청에서 전송된 것과 동일한 증명 ID입니다.

ProofingEvidence

단일 증거를 나타내는 객체입니다.

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. 필수 항목입니다. 증거가 표시되는 방식을 나타내는 oneof입니다. 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. 필수 항목입니다. 증거가 표시되는 방식을 나타내는 oneof입니다. presencetype은 다음 중 하나여야 합니다.
encryptedData

object (EncryptedData)

값을 복호화하는 데 필요한 암호화된 값과 암호화 메타데이터입니다.
unencryptedValue

string

증거의 base64로 인코딩된 값입니다.
unencryptedInteger

integer

증거의 정수 값입니다.

ReverificationContext

사용자 인증 정보의 재확인을 트리거하는 데 필요한 컨텍스트입니다.

JSON 표현 
{
  "credentialId": string
}
필드
credentialId

string

필수 항목입니다. 재확인이 실행되는 사용자 인증 정보 ID입니다.