HumanID 복호화

HumanID 암호 해독

일치하는 실제 얼굴을 제시하여 신원 데이터를 복구합니다.

menu_bookAPI 참조: HumanID 복호화expand_more

공식 가이드: docs.verifik.co/functions/decrypt-zelfproof (요청 및 응답 필드, 선택적 비밀번호 및 검증자 키, 호출 예시) 관련된: ZelfProof 생성, QR ZelfProof 생성, ZelfProof 미리보기.

Base URL https://api.verifik.co. Send JSON with Content-Type: application/json and Authorization: Bearer <access token> (same JWT as this demo after sign in).

POST /v2/human-id/decrypt

얼굴 이미지를 증거와 비교한 다음 일치가 성공하면 일반적으로 서명된 데이터 봉투 내에 해독된 공개 필드 및 관련 페이로드(예: 얼굴 자르기 및 난이도)를 반환합니다.

헤더	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수	요청	설명
faceBase64	예	원시 base64의 얼굴 이미지(이 데모는 다른 생체인식 데모와 동일한 형식을 사용합니다)
os	예	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, IOS 또는 ANDROID(데모에서는 DESKTOP 사용)
zelfProof	예	붙여넣기 또는 이 형식의 QR 이미지 추출에서 얻은 HumanID 문자열
password	아니요	증명이 비밀번호로 생성된 경우에만
verifierKey	아니요	검증자 키를 사용하여 증명이 생성된 경우

await fetch("https://api.verifik.co/v2/human-id/decrypt", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    faceBase64: "<base64>",
    os: "DESKTOP",
    zelfProof: "<human id string>",
  }),
});

POST /v2/human-id/preview-zelf-id-qr

사용자가 HumanID QR의 PNG 또는 JPEG를 제공할 때 사용합니다. API는 QR 페이로드를 읽고, 문자열 미리보기와 동일한 종류의 미리보기를 실행하고, 해독에 전달할 수 있는 zelfProof를 반환합니다. 선택적 verifierKey는 증명이 생성될 때 적용됩니다. 암호 해독과 동일한 JSON 헤더입니다.

매개변수	요청	설명
zelfProofQRCode	예	데이터 URL(data:image/png;base64,...) 또는 API에서 허용하는 다른 형식의 이미지(이 데모는 파일에서 데이터 URL을 구축합니다)
verifierKey	아니요	증명에서 검증자 키를 사용할 때 암호 해독과 동일한 의미

await fetch("https://api.verifik.co/v2/human-id/preview-zelf-id-qr", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    zelfProofQRCode: "data:image/png;base64,<...>",
  }),
});

Decrypt는 @humanauthn/api-client의 decryptHumanId를 사용합니다. QR 업로드에서는 PreviewZelfIdQr을 먼저 사용한 다음 반환된 증명 문자열로 암호를 해독합니다.
성공 응답은 Verifik 패턴, 즉 데이터 개체(그리고 종종 프로젝트에 서명이 활성화될 때 서명)를 따릅니다.
얼굴 이미지 없이 교정본을 검사하려면 Preview HumanID 데모(previewHumanId) 또는 위에 링크된 Preview ZelfProof 가이드를 엽니다.

menu_book

docs.verifik.co 공식 가이드

POST

ZelfProof 암호 해독

실제 얼굴과 일치시켜 증명 내의 신원 페이로드를 잠금 해제하세요. 증명이 생성되었을 때 선택적인 비밀번호를 하나의 비밀번호로 다룹니다.

POST

ZelfProof 생성

공개 필드와 얼굴 캡처를 저장하거나 공유할 수 있는 새로운 HumanID 문자열로 암호화하세요.

POST

ZelfProof 미리보기

얼굴 이미지를 전송하지 않고 공개 메타데이터와 암호 해독 전에 필요한 사항을 검사하세요. Preview HumanID 데모는 현재 API와 동일한 아이디어를 따릅니다.

POST