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로 인코딩된 값입니다.