HumanID復号

HumanID を復号化する

一致する生きた顔を提示して ID データを復元します。

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	はい	ペーストからの HumanID 文字列、またはこのフォームでの 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,<...>",
  }),
});

復号化では、@humanauthn/api-client からの decryptHumanId が使用されます。 QR アップロードでは、まずプレビューZelfIdQr を使用し、次に返された証明文字列を使用して復号化します。
成功の応答は Verifik パターンに従います: データオブジェクト (プロジェクトで署名が有効になっている場合は、多くの場合署名)。
顔画像のないプルーフを検査するには、Preview HumanID デモ (previewHumanId) または上にリンクされている Preview ZelfProof ガイドを開きます。

menu_book

docs.verifik.co の公式ガイド

POST

ZelfProof を復号化する

証明内の ID ペイロードを生きている顔と照合することで、そのペイロードのロックを解除します。プルーフが作成された場合のオプションのパスワードをカバーします。

POST

ZelfProof を作成する

公開フィールドを暗号化し、保存または共有できる新しい HumanID 文字列に顔をキャプチャします。

POST

ZelfProof をプレビューする

顔画像を送信せずに、公開メタデータと復号化する前に必要なものを検査します。 Preview HumanID デモは、現在の API と同じ考え方に従っています。

POST