Method: vdc.provisionCredential

사용자 인증 정보를 프로비저닝하는 엔드포인트입니다.

HTTP 요청

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

요청 본문

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

JSON 표현 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "credentialId": string,
  "proofingId": string,
  "deviceEncryptionKey": {
    object (DeviceEncryptionKey)
  }
}
필드
requestMetadata

object (RequestMetadata)

필수 항목입니다. 모든 요청에 필요한 요청에 관한 메타데이터입니다.
deviceReferenceId

string

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

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

string

필수 항목입니다. 기기에 프로비저닝된 특정 사용자 인증 정보를 나타내는 불투명 식별자입니다.

credentialId가 이미 있는 경우 새 사용자 인증 정보를 만드는 대신 이 메서드는 기존 사용자 인증 정보를 반환해야 합니다.

예: UUID
proofingId

string

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

증명은 승인됨 상태여야 합니다. 그렇지 않으면 잘못된 식별자 ErrorResponse가 반환되어야 합니다.
deviceEncryptionKey

object (DeviceEncryptionKey)

필수 항목입니다. 기기의 임시 암호화 키와 연결된 메타데이터가 포함된 객체입니다. 이 키는 값을 기기로 다시 암호화하는 데 사용됩니다. 이 객체는 온보딩 중에 샌드박스 환경에서 제공되지 않을 수 있으며, 이는 발급기관이 일반 텍스트 데이터를 반환해야 함을 나타냅니다. 프로덕션 환경에서는 항상 설정해야 합니다.

응답 본문

프로비저닝된 사용자 인증 정보가 포함된 응답입니다.

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

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

object (ResponseMetadata)

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

object (Credential)

필수 항목입니다. 프로비저닝된 사용자 인증 정보입니다.
credentialVersionId

string

필수 항목입니다. 프로비저닝된 사용자 인증 정보의 현재 버전입니다.

사용자 인증 정보

사용자 인증 정보 유형의 관련 ISO 표준에 따라 정의된 mdoc 기반 사용자 인증 정보입니다.

예를 들어 모바일 운전면허증의 경우 ISO/IEC 18013-5입니다. mDL mDoc 형식은 여기를 참고하세요.

JSON 표현 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string
  // End of list of possible types for union field presencetype.
}
필드
통합 필드 presencetype. 필수 항목입니다. 사용자 인증 정보가 표시되는 방식을 나타내는 oneof입니다. presencetype은 다음 중 하나여야 합니다.
encryptedData

object (EncryptedData)

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

string

사용자 인증 정보의 base64로 인코딩된 값입니다.