Method: vdc.proofUser

HTTP 요청
요청 본문
- JSON 표현
응답 본문
- JSON 표현
ProofingEvidence
- JSON 표현
증거
- JSON 표현
ReverificationContext
- JSON 표현

발급자 지정 증빙 목록과 특정 기기를 사용하여 디지털 사용자 인증 정보를 증명하는 엔드포인트입니다.

HTTP 요청

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

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,
  "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입니다.

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)` 발급자로부터 전송된 사전 승인 코드입니다.

통합 필드 evidence_type. 증거가 제시되는 방식을 나타내는 oneof입니다. evidence_type은 다음 중 하나여야 합니다.

preAuthorizationCode

object (Evidence)

발급자로부터 전송된 사전 승인 코드입니다.

증거

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

JSON 표현

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`. }

{

  // 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입니다.

credentialId