すべてのプロダクト
Search
ドキュメントセンター

Financial Intelligence Engine:ZOLOZ eKYC SaaS に関するよくある質問

最終更新日:Mar 17, 2025

ZOLOZ eKYC SaaS プロダクトに関するよくある質問のリストです。

全般

Real ID で現在サポートされているドキュメントの種類は何ですか?

サポートされているドキュメントの一覧を表示するには、[Real ID]については、サポートされているドキュメントの種類と返される OCR 結果

IDN Lite と IDN の違いは何ですか?

RealID に組み込まれている IDN は、IDN の一部の機能のみを含む合理化されたバージョンであるため、IDN Lite と呼ばれています。

IDN のすべての関数については、IDN API ドキュメントをご参照ください。

RealID IDN と IDN API は、以下の点で異なります。

項目

IDN Lite

IDN

機能

IDN の一部の機能。

IDN のすべての機能。

リスク検出

自動的に有効化されます。

ユーザーの使用状況と入力に応じてリスクを定義します。

取得期間

過去 30 日間

データベース全体の取得を含む、取得期間の構成をサポートします。

リスクの種類

偽造 ID:

  • 同じ顔、異なる ID 番号

  • 同じ ID 番号、異なる顔

重複 ID:

  • 同じ顔、異なる ID の種類

IDFAKE:

  • SameFaceDifferentIdNumber

  • SameFaceDifferentPerson

  • SameIdDifferentFace

  • SameIdDifferentPerson

  • SamePersonDifferentFace

  • SamePersonDifferentIdNumber

DUPLICATE:

  • SameFaceDifferentIdType

  • SameFaceDifferentUserId

BATCH_REGISTER:

  • SameFaceBackgroundDifferentFace

データソース

RealID によって収集されたユーザーデータのみをサポートします。

RealID およびその他の外部データによって収集されたデータをサポートします。

データベース管理

サポートされていません

データベースでの追加、削除、取得などの操作をサポートします。

取得速度

低速です。取得期間が制限されます。

高速です。より高度な検索エンジンを使用して取得速度を向上させています。

ローカル環境への通常のアクセスに影響を与えないように、ZOLOZ サービスを統合するには、どのドメイン名をホワイトリストに追加する必要がありますか?

ZOLOZ は本番環境のみを提供しています。目的に応じて異なるユーザーアカウントを使用できます。

環境ごとに、ZOLOZ ポータル Web サイト、ワイヤレス ゲートウェイドメイン名、基本 API URI、および Web SDK URL が異なるサービスエンドポイントを提供します。

サポートされている ZOLOZ ポータル Web サイト、ワイヤレス ゲートウェイドメイン名、および基本 API URI の詳細については、次の表をご参照ください。

環境

基本 API URI

ZOLOZ ポータルアドレス

ワイヤレス ゲートウェイドメイン名

シンガポール 本番

https://sg-production-api.zoloz.com

https://sg-production-portal.zoloz.com/

https://sg-production-zmgs.zoloz.com

香港 本番

https://hk-production-api.zoloz.net

https://hk-production-portal.zoloz.net/

https://hk-production-zmgs.zoloz.net

インドネシア 本番

https://id-production-api.zoloz.com/

https://id-production-portal.zoloz.com/

https://id-production-zmgs.zoloz.com

注:

  • フロントエンドまたはクライアント開発中に ZOLOZ が提供する SDK を使用する場合、ネットワーク環境を構成する必要はありません。

  • お客様がサーバーから ZOLOZ にリクエストを送信する場合は、環境関連の構成パラメーターが正しく構成されていることを確認する必要があります。

ZOLOZ Web SDK の URL はプロダクト固有です。同じ環境でも、プロダクトによって Web SDK の URL が異なります。

サポートされている Web SDK URL の詳細については、以下の表をご参照ください。

環境

プロダクト

WEB SDK URL

シンガポール 本番

RealId

https://sg-production-cdn.zoloz.com/page/zoloz-realid-fe/index.html

FaceCapture/Connect

https://sg-production-cdn.zoloz.com/page/zoloz-face-fe/index.html

IdRecognition

https://sg-production-cdn.zoloz.com/page/zoloz-doc-fe/index.html

香港 本番

RealId

https://hk-production-cdn.zoloz.net/page/realid-fe/index.html

FaceCapture/Connect

https://hk-production-cdn.zoloz.net/page/face-fe/index.html

IdRecognition

https://hk-production-cdn.zoloz.net/page/doc-fe/index.html

インドネシア 本番

FaceCapture/Connect

https://id-production-cdn.zoloz.com/page/face-fe/index.html

: ZOLOZ サービスにアクセスするためにすべての顧客がホワイトリストに含まれる必要があるわけではありません。ただし、組織が厳格なネットワーク セキュリティ標準に加入しており、すべての外部ネットワークが会社の指定ネットワークにアクセスする前にホワイトリストによって承認される必要がある場合は、それぞれの ZOLOZ ドメインをホワイトリスト フレームワークに登録することが不可欠になります。

プライバシー削除によって具体的にどのような種類のデータを削除できますか?

  • OCR 情報 - ドキュメント ID、名前など

  • 収集された身分証明書と顔写真データ。返される顔画像 (faceImg)、返される追加画像 (extraImages)、身分証明書の表面画像 (frontPageImg)、身分証明書の裏面画像 (backPageImg) などが含まれます。

その結果、IDN lite 関連データが削除され、IDN lite はプライバシー削除されたデータを再処理またはアクセスできなくなります。

ドキュメント画像収集の要件は何ですか?

ZOLOZ には、収集されたドキュメント画像のサイズと品質について一定の要件があります。これらの要件を遵守することで、ドキュメント画像収集の成功率を効果的に向上させることができます。

収集要件

詳細説明

フレーム内の完全なドキュメント

ドキュメントの 4 つの角と縁すべてが収集フレーム内にあることを確認してください。

鮮明なドキュメント画像

ドキュメント画像が鮮明で見やすく、ぼやけた領域がないことを確認してください。

適切な照明

収集環境で適切な照明を確保して、ドキュメントの情報が効果的に認識されるようにしてください。明るすぎる、または暗すぎる環境は検証結果に影響を与える可能性があります。

グレアの回避

ドキュメント画像のグレアはデータの処理と抽出を妨げる可能性があるため、照明や周囲光からの反射を避けてください。

障害物のないこと

ドキュメントに障害物がないこと、およびドキュメントのすべての情報が完全に表示されていることを確認してください。

傾きの回避

ドキュメントが水平方向と垂直方向の両方で完全に平らで、傾いていないことを確認してください。

適度な距離

ドキュメントの 4 つの縁をスキャン フレームに合わせます。遠すぎる、または近すぎる場合は、収集結果に影響を与える可能性があります。

適切な傾斜角度 (複数角度バージョンのみ)

ドキュメントの 4 つの縁を傾斜したスキャン フレームに合わせます。傾斜角度は一般に 30 度を超えないようにする必要があります。

eKYC 結果の解釈

Real ID で「保留中」の結果を受け取る理由は何ですか?

'保留中' の結果は、[Real ID]現在のトランザクションに潜在的なリスクがあると検出した場合。

「保留中」という結果が返される理由には、次のようなものがあります。

  • 偽の ID が検出されました

  • 撮影された自撮り写真の顔が ID 写真と一致しません

  • リスク チェックに失敗しました

ZOLOZ プロダクトがお客様の特定のニーズに合わせてカスタマイズされている場合は、他の理由が存在する可能性があることにご注意ください。詳細については、ZOLOZ のテクニカルサポートに連絡してください。

Real ID の「保留中」の結果は、Real ID からの最終的な応答ですか?

はい、そうです。Real ID は最終結果として「成功」、「保留中」、または「失敗」のいずれかを返します。

自分の側で「保留中」の結果を管理するにはどうすればよいですか?

アプリケーションを手動で確認し、トランザクションを承認するかどうかを決定することをお勧めします。確認中に問題が発生した場合は、ZOLOZ のテクニカル サポートにお問い合わせください。

Real ID でリスク管理結果の戻り値が空なのはなぜですか?

リスク管理結果の戻り値が空の場合、リスク管理ポリシー モジュールがトリガーされていないことを示しており、次のような理由が考えられます。

  • ドキュメント検証または顔検証に失敗しました。

  • 初期化に失敗しました。

  • ユーザーが本人確認をキャンセルしました。

偽造防止検出に失敗した場合、トランザクションが「失敗」ではなく「保留中」とフラグ付けされるのはなぜですか?

偽造防止検出の失敗により「保留中」とフラグ付けされたトランザクションは、すぐに「失敗」とはマークされません。偽造防止検出には一定の割合の誤検知がある可能性があるため、直接「失敗」とマークすると、正当なトランザクションが誤って傍受される可能性があります。たとえば、照明が不十分である場合やドキュメント情報が部分的にぼやけている場合、システムが正確な判断を下すことが難しくなる可能性があります。したがって、トランザクションは手動レビューできるように「保留中」とマークされます。このさらなる検証により、決定の精度が確保され、誤検知率を最小限に抑えることで顧客の利益が保護されます。

ZOLOZ SDK と API の使用

ZOLOZ SDK を更新する方法

プラットフォーム上の ZOLOZ SDK を更新するには、使用している特定の SDK に合わせて、次の一般的なガイドラインに従ってください。

  1. Android SDK の更新

  • Gradle 設定ファイルを開きます。Android プロジェクト内の app/build.gradle ファイルに移動します ( Android 統合を参照)。

  • 依存関係を更新する: ZOLOZ SDK が含まれている行を見つけ、新しいバージョン番号で更新します。例:

implementation 'com.zoloz.android.build:zolozkit:latest-version'

注:"latest-version" を更新したい実際のバージョン番号に置き換えてください。 プロダクトのエクスペリエンスとセキュリティを向上させるために、SDK の最新バージョンを使用することをお勧めします。 バージョンリリースノートについては、リリースノート

  • プロジェクトを同期する: build.gradle ファイルを編集した後、プロジェクトを同期して Gradle ファイルを更新する必要があります。

  1. iOS SDK の更新

  • SDK の依存関係を構成する

    • Podfile でプライベート仕様を構成する:

    • source "https://github.com/zoloz-pte-ltd/zoloz-demo-ios"
    • Podfile に SDK の依存関係を追加する:

    • #zolozkit changelog https://docs.zoloz.com/zoloz/saas/releasenotes/
      
      # #新機能とセキュリティの改善を含む最新バージョンを使用することをお勧めします。特定のバージョンに関する詳細情報が必要な場合は、変更ログを確認してください
      pod 'zolozkit'  #core modules
      pod 'zolozkit/ZolozNfcReader' #nfc reader module

注: コード「pod 'zolozkit/ZolozNfcReader'" は NFC 機能に対応しています。アクティブ化する必要がある場合は、ZOLOZ チームにご連絡ください。NFC 関数です。NFC 機能が不要な場合は、この 1 行のコードを省略できます。

  • Pod を更新する

    • 次のコマンドを実行して SDK を更新します。

pod update
  • エラーを処理する:

    • 更新プロセス中に次のエラーが発生した場合:

    • FAQ-1.png

    • 次のコマンドを使用してローカル リポジトリのインデックスを更新してから、もう一度更新を試みることができます。

pod install --repo-update

または

pod repo update
  • 更新完了。

  1. Web SDK の更新

Web SDK の更新については、更新は自動で行われ、コードベースを手動で変更する必要がないため、お客様側で操作を行う必要はありません。

顔キャプチャのセンサー アクセス許可が拒否された後、Web SDK で顔キャプチャ ページを開けないのはなぜですか?

Face Capture-Deeper が有効になると、ZOLOZ は電話のセンサー権限へのアクセスをリクエストします。 iOS システムの制限により、ユーザーが ZOLOZ へのセンサーアクセス権限を拒否した場合、Web SDK は顔キャプチャページを開くことができなくなります。 クライアントは、返されたコードに基づいて WebView を再起動するか、ユーザーにブラウザを再起動して再承認するように促すことができます。 特定のリターンコードについては、ZLZResponse をご覧ください。

Real ID が ID カードの表面のみをスキャンするように、本人確認プロセスをカスタマイズするにはどうすればよいですか?

どのドキュメント ページが必要かをカスタマイズします [Real ID] オプションのリクエストパラメータを設定することでスキャンを Real ID 初期化 API

間違った形式を使用すると、API がパラメーターを正しく処理しない場合があります。フィールド名として「pages」を指定し、スキャンとアップロードに必要なドキュメントのページ番号 (つまり、「1」、「2」、または両方) を指定してください。

リクエスト パラメーターの例を次に示します。

  • ドキュメントの表面のみをスキャンする場合: req.put("page", "1")

  • ドキュメントの両面 (つまり、表面と裏面) をスキャンする場合: req.put("page", "1,2")

ドキュメントに単一ページ スキャン機能を使用する場合は、まずアルゴリズムでサポートされている必要があることに注意してください。

Real ID、顔キャプチャ、および ID 認識に使用できる serviceLevel パラメーターの種類は何ですか?

ZOLOZ は、、、および を介してさまざまな本人確認サービスを提供しています。[Real ID]顔キャプチャID 認識。

異なる serviceLevel パラメーター値を使用して、API に必要なサービス レベルをカスタマイズします。これらのパラメーターもオプションです。

参考までに、サービス レベルのリストを次に示します。

フィールド名

プロダクト

説明

リファレンス

serviceLevel

Real ID

  • REALID0001 :

    ユーザーは ID の写真を手動で撮影するように求められます。

    瞬き検出を使用して、ZOLOZ サーバーは基本的ななりすましチェックと基本的な生体チェックを実行します。

  • REALID0002 :

    ID が自動的にスキャンされます。

    瞬き検出を使用して、ZOLOZ サーバーは高度ななりすましチェックと基本的な生体チェックを実行します。

  • REALID0003:

    ID は自動的にスキャンされます。

    2 つのランダムな複数操作検出を使用して、ZOLOZ サーバーは高度ななりすましチェックと生体チェックを実行します。

    注: このサービス レベルはネイティブ SDK でのみ使用できます。

  • REALID0004:

    ID は、斜めに保持されている場合でも自動的にスキャンされます。

    瞬き検出を使用して、ZOLOZ サーバーは基本的ななりすましチェックと基本的な生体チェックを実行します。

  • REALID0009:

    ID は自動的にスキャンされます。

    瞬き検出を使用して、ZOLOZ サーバーは高度ななりすましチェックと生体チェックを実行します。このサービス レベルでは、ネイティブ SDK 用に閉眼画像をキャプチャする機能が提供されます。.

  • REALID0011:

    ID は自動的にスキャンされます。

    瞬き検出を使用して、ZOLOZ サーバーは高度ななりすましチェックと生体チェックを実行します。このサービス レベルでは、Web SDK 用に閉眼画像をキャプチャする機能が提供されます。.

  • REALID0012:

    ID は自動的にスキャンされます。

    瞬き検出を使用して、ZOLOZ サーバーは基本的ななりすましチェックと生体チェックを実行します。

    注: このサービス レベルは Web SDK 専用です。

参照してくださいリアル ID API リファレンス: 初期化する

顔キャプチャ

  • FACECAPTURE0001:

    瞬き検出を使用せずに、基本的な生体チェックが実行されます。

  • FACECAPTURE0002:

    瞬き検出を使用して、中レベルの生体チェックが実行されます。

  • FACECAPTURE0003:

2 つのランダムな複数操作検出を使用して、

高レベルの生体チェックが実行されます。

  • 複数操作検出方法には、瞬き、口を開ける、頭を上に向ける、頭を下に向ける、頭を横に振る (左)、頭を横に振る (右) が含まれます。

  • FACECAPTURE0005:

    瞬き検出を使用して、完全な生体チェックが実行されます。このサービス レベルでは、ネイティブ SDK 用に閉眼画像をキャプチャする機能も提供されます。

  • FACECAPTURE0010:

ブリンク検出を使用すると、完全なライブネス チェックが

実行されます。このサービスレベルでは、

瞬き検出を使用して、完全な生体チェックが実行されます。このサービス レベルでは、

Web SDK 用に閉眼画像をキャプチャする機能も提供されます。

参照してください顔キャプチャ API リファレンス:

initialize を参照してください

ID 認識

  • IDRECOGNITION0002:

    デフォルト値。基本的ななりすましチェック。

  • IDRECOGNITION0003:

    ネイティブ SDK の懐中電灯なりすましチェック。

  • IDRECOGNITION0005:

    Web SDK の複数角度なりすましチェック。

    注: 現時点では、このサービス レベルは香港の身分証明書のみをサポートしています。

以下を参照してください:ID 認識 API リファレンス: 初期化

注: Real IDFace Capture は、productConfig にリストされているパラメーターを使用して、より柔軟な構成もサポートしています。以下のパラメーターが設定されている場合、serviceLevel および operationMode よりも優先されます。元の serviceLevel と operationMode は引き続き維持され、使用し続けても影響を受けません。

Real ID 関連の productConfig パラメーター:

フィールド名

データ型

最大長

説明

docUiType

String

20

オプション。このパラメーターは、ID 写真を撮影する方法を指します。値は次のとおりです。

  • 1: セルフキャプチャ、Web SDK のデフォルト値。ユーザーは手動で ID 写真を撮影する必要があり、基本的な偽造防止機能のみを備えています。

  • 2: ディープスキャン、ネイティブ SDK のデフォルト値であり、ネイティブ SDK 専用です。ZOLOZ SDK は ID 写真を自動的に位置合わせしてキャプチャし、印刷されたカラー画像の傍受などの高度な偽造防止機能を備えています。

  • 3: 自動スキャン、Web SDK 専用です。ZOLOZ SDK は ID 写真を自動的に位置合わせしてキャプチャし、基本的な偽造防止機能のみを備えています。

  • 4: トレーススキャン、ネイティブ SDK 専用です。ZOLOZ SDK は、ドキュメントがカメラの範囲内で検出されると、ID 写真を自動的にキャプチャします。ユーザー エクスペリエンスを向上させることができますが、基本的な偽造防止機能のみを備えています。

  • 5: 複数角度、Web SDK の HKID 専用です。ユーザーは異なる角度から 2 枚のドキュメント写真を撮影する必要があります。最初の写真では、カメラを ID ドキュメントに直接向け、その写真をキャプチャします。2 枚目は、ID ドキュメントをカメラに対して 30° 傾けて、その写真をキャプチャします。

spoofMode

String

10

オプション。このパラメーターは、ドキュメントの偽造防止レベルを指し、次のように定義されます。

  • CLOSED: すべてのアルゴリズムが適用されません。テスト フェーズでは、この偽造防止検出モードを使用することで、アルゴリズムとリスク管理ルールがテスト プロセスに影響を与えないようにすることができます。

  • STANDARD: デフォルト値。推奨される標準レベルが適用されます。

  • LOOSE: 予約値であり、現在は使用できません。

  • STRICT: 予約値であり、現在は使用できません。

livenessMode

String

10

オプション。顔の生体検知チェックの生体レベルを指定します。次の値がサポートされています。

  • CLOSED: すべてのアルゴリズムが適用されません。テスト フェーズでは、この生体検知モードを使用することで、アルゴリズムとリスク管理ルールがテスト プロセスに影響を与えないようにすることができます。

  • STANDARD: デフォルト値。推奨される標準レベルが適用されます。

  • LOOSE: 比較的緩いレベルが適用されます。低リスクのシナリオでは、この生体検知モードを使用できます。

  • STRICT: 比較的厳格なレベルが適用されます。高リスクのシナリオでは、この生体検知モードを使用できます。

antiInjectionMode

String

String

非推奨のフィールドであり、今後メンテナンスされません。API の互換性を確保するために、このフィールドは保持されます。オプション。インジェクション攻撃検出のインジェクション防止レベルを指定します。インジェクション攻撃検出は、ディープフェイク (つまり、顔交換写真またはビデオ) を使用したインジェクション攻撃を効果的に阻止できます。次の値がサポートされています。

  • CLOSED: デフォルト値。すべてのインジェクション防止アルゴリズムが適用されません。ビジネス シナリオでインジェクション攻撃検出が不要な場合は、有効にする必要はありません。

  • STANDARD: 推奨される標準レベルが適用されます。

  • LOOSE: 予約値であり、現在は使用できません。

  • STRICT: 予約値であり、現在は使用できません。

注: インジェクション攻撃検出を有効にすると、誤拒否率と実行時間がわずかに増加します。この機能を有効にする前に、ZOLOZ テクニカル サポート チームにお問い合わせください。

actionCheckItems

List<String>

オプション。検出されるユーザー操作。ユーザー エクスペリエンスを向上させるために、2 つ以上の操作を使用することはお勧めしません。次の値がサポートされています。

  • FACEBLINK: デフォルト値。ユーザーは瞬きする必要があります。

  • MOUTHOPEN: ユーザーは 1 回口を開ける必要があります。

  • HEADSHAKE: ユーザーは頭を横に振る必要があります。ユーザーが実行する左または右のヘッドシェイクが指定されます。

  • HEADLOWER: ユーザーは 1 回頭を下げる必要があります。

  • HEADRAISE: ユーザーは 1 回頭を上げる必要があります。

actionRandom

String

1

オプション。 で指定されたユーザー操作をランダムな順序で検出するかどうかを指定します。有効な値は次のとおりです。actionCheckItems は検出されるランダムな順序です。有効な値は次のとおりです。

  • Y: ランダム

  • N: デフォルト値。ランダムではありません。操作検出は actionCheckItems の順序に従って実行されます。

actionFrame

List<String>

オプション。このパラメーターは、他のフレーム画像のキャプチャを指し、次のように定義されます。

  • EYECLOSE: この値を設定すると、瞬き検出方法中に収集された閉眼フレームが返されます。

riskMode

String

10

オプション。このパラメーターは、RealID の多次元リスク管理ルール検証を指します。不審なトランザクションを傍受するために使用されます。値は次のとおりです。

  • CLOSED: すべてのアルゴリズムが適用されません。テスト フェーズでは、このリスク検出モードを使用することで、アルゴリズムとリスク管理ルールがテスト プロセスに影響を与えないようにすることができます。

  • STANDARD: デフォルト値。推奨される標準レベルが適用されます。

  • LOOSE: 比較的緩いレベルが適用されます。低リスクのシナリオでは、このリスク検出モードを使用できます。

  • STRICT: 比較的厳格なレベルが適用されます。高リスクのシナリオでは、このリスク検出モードを使用できます。

idnThreshold

Integer

非推奨のフィールドです。省略可能です。デフォルトのしきい値は 3 です。このパラメーターは、1 人のユーザーが異なる ID ドキュメントを使用するトランザクション、または 1 つの ID ドキュメントが異なるユーザーによって使用されるトランザクションをチェックするために使用されます。このようなトランザクション (異なる userId からの) の数がしきい値を超えると、現在のトランザクションはインターセプトされます。

0 より大きい整数がサポートされています。

詳細は、Real ID API リファレンスを参照してください: 初期化

顔キャプチャ関連の productConfig パラメーター:

フィールド名

データ型

最大長

説明

livenessMode

String

10

オプション。顔の生体検知チェックの生体レベルを指定します。次の値がサポートされています。

  • CLOSED: すべてのアルゴリズムが適用されません。テスト フェーズでは、この生体検知モードを使用することで、アルゴリズムとリスク管理ルールがテスト プロセスに影響を与えないようにすることができます。

  • STANDARD: デフォルト値。推奨される標準レベルが適用されます。

  • LOOSE: 比較的緩いレベルが適用されます。低リスクのシナリオでは、この生体検知モードを使用できます。

  • STRICT: 比較的厳格なレベルが適用されます。高リスクのシナリオでは、この生体検知モードを使用できます。

antiInjectionMode

String

10

非推奨のフィールドであり、今後メンテナンスされません。API の互換性を確保するために、このフィールドは保持されます。オプション。インジェクション攻撃検出のインジェクション防止レベルを指定します。インジェクション攻撃検出は、ディープフェイク (つまり、顔交換写真またはビデオ) を使用したインジェクション攻撃を効果的に阻止できます。次の値がサポートされています。

  • CLOSED: デフォルト値。すべてのインジェクション防止アルゴリズムが適用されません。ビジネス シナリオでインジェクション攻撃検出が不要な場合は、有効にする必要はありません。

  • STANDARD: 推奨される標準レベルが適用されます。

  • LOOSE: 予約値であり、現在は使用できません。

  • STRICT: 予約値であり、現在は使用できません。

注: インジェクション攻撃検出を有効にすると、誤拒否率と実行時間がわずかに増加します。この機能を有効にする前に、ZOLOZ テクニカル サポート チームにお問い合わせください。

actionCheckItems

List<String>

オプション。検出されるユーザー操作。ユーザー エクスペリエンスを向上させるために、2 つ以上の操作を使用することはお勧めしません。次の値がサポートされています。

  • FACEBLINK: デフォルト値。ユーザーは瞬きする必要があります。

  • MOUTHOPEN: ユーザーは 1 回口を開ける必要があります。

  • HEADSHAKE: ユーザーは頭を横に振る必要があります。左または右のヘッドシェイクがユーザーに指定されます。

  • HEADLOWER: ユーザーは 1 回頭を下げる必要があります。

  • HEADRAISE: ユーザーは 1 回頭を上げる必要があります。

actionRandom

String

1

オプション。 で指定されたユーザー操作をランダムな順序で検出するかどうかを指定します。有効な値は次のとおりです。actionCheckItems は検出されるためにランダムな順序になっています。有効な値は次のとおりです。

  • Y: ランダム

  • N: デフォルト値。ランダムではありません。操作検出は actionCheckItems の順序に従って実行されます。

actionFrame

List<String>

オプション。このパラメーターは、他のフレーム画像のキャプチャを指し、次のように定義されます。

  • EYECLOSE: この値を設定すると、瞬き検出方法中に収集された閉眼フレームが返されます。

詳細については、顔キャプチャ初期化する API リファレンスを参照してください:

Web SDK はどのような種類の UI 構成モードをサポートしていますか?

2 種類の UI 構成モードがサポートされています。

  • ページ ジャンプ: 別のページにリダイレクトします

  • HTML <iframe> タグ: 現在のページ内にページを埋め込みます

Web SDK を使用するための要件は何ですか?

Web SDK を使用するには、次の要件を満たす必要があります。

  • サポートされている最小 OS バージョン: Android 5 以降、iOS 11 以降

  • サポートされているブラウザー:

    • iOS: Safari。iOS 14.3 以降では、Chrome、Firefox、Microsoft Edge、および WKWebView がすべてサポートされています。

    • Android: Chrome 60 以降と Firefox 58 以降を使用することをお勧めします。Android の他のブラウザーでは、Web SDK のサポートはデバイスによって異なります。

上記のブラウザーは現在公式にサポートされています。市場で入手可能なさまざまなブラウザーを考慮して、適宜見直しと更新を行います。

必要な権限: ネットワークとカメラのアクセス許可。

セキュリティを確保するために、「メディアキャプチャ」には HTTPS デプロイメントが必要です。

テスト環境でデバッグするために、対応する Web SDK の URL を変更する必要がありますか?

変更は必要ありません。

アプリから Web SDK にアクセスするときにキャプチャ機能を開けない/使用できないのはなぜですか?

一部のデバイス モデル/システムでこの問題が発生する可能性があります。

Web SDK はアプリの WebView コンテナーで開く必要があり、WebView のカーネルはデバイス システムにバインドされています。一部のモデル/システムでは、キャプチャ機能に WebView の制限がある場合があり、その結果、ユーザーはキャプチャ機能を正常に開いたり使用したりすることができません。

次のことをお勧めします。

  • アクセスする前にモバイル ブラウザーに切り替えます。

  • ネイティブ SDK 統合モードを使用して、アプリのキャプチャ機能に安定してアクセスします。

ネイティブ SDK で顔ガイド ページのタイトル バーを非表示にするにはどうすればよいですか?

Android SDK の場合、次のソリューションがサポートされています。

  • 添付ファイル ui.json をプロジェクト アセット ディレクトリに配置して、タイトル バーを非表示にします。

    UI.JSON

iOS SDK の場合、次のソリューションがサポートされています。

  • 顔ガイド ページの URL に「hiddenTitleBar」パラメーターを追加し、「hiddenTitleBar」の値を「true」に設定します (デフォルトは「false」)。例: http://url-to-face-guide-page.html?hiddenTitleBar=true

注:顔認証ガイドページのタイトルバーを非表示にすると、ZOLOZ の戻るボタンも非表示になります。この場合、H5 ページにカスタムの戻るボタンを追加し、必要なイベントを実装する必要があります。詳細については、「Real ID のセルフィーガイダンスページをカスタマイズする」に記載されている詳細な統合手順をご確認ください。

Postman のデバッグ インターフェイスを使用できますか?

いいえ、Postman は現在サポートされていません。

データ セキュリティを確保するために、アクセス サンプル コードをデバッグに使用してください。 ZOLOZ 統合例はこちらを参照してください。

API 呼び出しエラー

エラー

考えられる理由

ソリューション

SIGNATURE_INVALID

抽出された署名文字列が、検証対象のコンテンツ文字列と一致しません。

ZOLOZ のサンプル デモで正しい構成をご確認の上、API 認証情報を準備して使用するをご参照ください。

ACCESS_DENIED

アカウントには、現時点でこの特定の API へのアクセス権がありません。

へのアクセスのみ[Real ID]API はデフォルトで有効になっています。ID 認識や顔比較などの他のプロダクト API については、追加のアクセスをリクエストする必要があります。

他のプロダクト API を呼び出すためのアクセス権を有効にするには、ZOLOZ のテクニカル サポートにお問い合わせください。

PRODUCT_QUOTA_LIMIT

API 呼び出しのテスト クォータ制限に達した可能性があります。

ケースを処理するには、ZOLOZ のテクニカル スタッフにお問い合わせください。

sg-sandbox 環境、clientID、使用したメールアドレスなどのサンドボックス環境情報を提供する必要があります。

HIGH_RISK

リスク管理エンジンがトリガーされた可能性があります。

サンドボックス環境でテストする際に高リスクとして検出されないようにするには、リスク管理を無効にします。これを行うには、初期化 API のリクエストパラメータ operationMode を異なる値に設定するか、デモ アプリで対応する リスク レベル を選択します。

詳細は次のとおりです。

  • Velocity 機能を無効にするには、initialize API で「STANDARD_VC_CLOSED」を使用します。または、デモ アプリで「標準リスク レベル 1」を選択します。

  • IDN 機能を無効にするには、initialize API で「STANDARD_IDN_CLOSED」を使用します。または、デモ アプリで「標準リスク レベル 2」を選択します。

  • Velocity 機能と IDN 機能の両方を無効にするには、initialize API で「STANDARD_VC_IDN_CLOSED」を使用します。または、デモ アプリで「標準リスク レベル 3」を選択します。

デモ アプリは次のようになります。

image.png

と の定義は次のとおりです。IDN および ベロシティ:

  • IDN: ID ネットワーク チェックによって偽造攻撃リスクが検出されたことを示します。たとえば、複数の ID に関連付けられた顔が検出された場合、または複数の顔に関連付けられた ID が検出された場合などです。詳細については、を参照してください。

  • Velocity: Velocity チェックによって偽造攻撃リスクが検出されたことを示します。たとえば、過去一定期間における同じユーザー (userId、ID 番号、または deviceId によって識別される) による攻撃 (偽造 ID または生体攻撃など) の試行回数が特定のしきい値に達した場合、Velocity チェックでは、クールダウン期間が経過するまでユーザーがさらに送信することを許可しません。

MERCHANT_NOT_FOUND

clientID、エンドポイント/URL、ZOLOZ 公開鍵、または加盟店秘密鍵に関してエラーが発生した可能性があります。

次の各構成が正しいことを確認してください。

  1. 環境が正しいことを確認します。サービス エンドポイントについて を参照してください。

** ポータル環境はエンドポイント/URL 環境と一致している必要があることに注意してください。

  1. clientID のスペルが正しいことを確認します。

  2. それでもエラーが発生する場合は、API キー (つまり、ZOLOZ 公開鍵または加盟店秘密鍵) の構成を確認してください。API キー (ZOLOZ 公開鍵または加盟店秘密鍵) の構成を確認します。

** この構成ミスは通常、MERCHANT_NOT_FOUND エラーではなく INVALID_SIGNATURE エラーになります。

PARAM_MISSING

必須のリクエスト パラメーターがありません。

ドキュメントに従って正しいリクエストパラメータ値を使用していることを確認してください。ドキュメント

オプションのリクエスト パラメーターが渡された場合、パラメーター値を空にすることはできません。

SYSTEM_ERROR

2 つの理由が考えられます。

  1. リクエスト パラメーター値がサポートされていません

  2. システム例外がトリガーされました。

  1. ZOLOZ API リファレンス に従って、正しいリクエスト パラメーター値を使用していることを確認してください。オプションのリクエスト パラメーターに空の文字列値を指定することはできません。

  2. それでもこの問題を解決できない場合は、システム エラーのリクエストとレスポンス情報を ZOLOZ のテクニカル サポートに提供してください。

ZOLOZ ポータル

ログイン エラーが発生し、ZOLOZ ポータルにアクセスできない場合はどうすればよいですか?

ブラウザーの開発者ツールを使用してページのエラー メッセージを確認し、ログイン エラーを特定します。その後、エラーのリクエストとレスポンス情報を ZOLOZ のテクニカル サポートに送信して、さらに調査してください。

開発者ツールにアクセスする方法は次のとおりです。

  1. Web ブラウザーで ZOLOZ ポータルを開き、ログインを試みます。

  2. ログイン エラーが発生した場合、「システム エラー」ポップアップが表示されます。

  3. 開発者ツール パネルを開きます。ほとんどの Web ブラウザーでは、次の方法でアクセスできます。

    a. ページを右クリックし、ドロップダウン メニューから [検証] または [要素の検証] をクリックします

    b. キーボード ショートカット Ctrl + Shift + I (Windows) または Cmd + Opt + I (Mac) を使用します

    c. Chrome ユーザーの場合は、アドレス バーの右上のメニュー > その他のツール > 開発者ツールをクリックすることもできます

  1. 開発者ツール パネルで、[ネットワーク] タブをクリックします。Web ページが行ったネットワーク リクエストとレスポンスのリストがここに表示されます。

image.png

  1. 「名前」テーブルで、「ログイン」というタイトルのリクエストを見つけます。[ヘッダー] タブをクリックすると、POST リクエストとして表示されます。

image.png

「ログイン」リクエストが表示されない場合は、別のログインを試行してエラーを発生させてください。

  1. 次の情報を ZOLOZ のテクニカル サポートに送信してください。

    a. 全般

    b. レスポンス ヘッダー

    c. リクエスト ヘッダー

image.png

a. 「レスポンス」タブのコード情報

image.png

クライアント側

クライアント統合プロンプト Z7011

考えられる理由:

リクエスト パラメーターとして initialize API に渡された metaInfo が正しくありません。

ドキュメントにあるサンプルの metaInfo を使用していないことを確認してください。

正しい metaInfo にアクセスする方法は次のとおりです。

  1. ネイティブ デモをローカルで実行します

image.png

  1. サーバーが正常に起動したら、「ZOLOZ SaaS の例」ツールで構成します

image.png

  1. 構成が完了したら、[ZOLOZ を開始] をクリックして、サーバーが Request オブジェクトを介して metaInfo コンテンツを受信できるようにします

  2. initialize API をもう一度呼び出します

アルゴリズム関連

ドキュメントの表示がぼやけている場合はどうすればよいですか?

ドキュメントが次の場合、ぼやけていると表示されます。

  • ぼやけている

  • 反射している

  • 異物によってブロックされている

  • または、ドキュメントの情報が完全に識別できない場合

キャプチャがぼやけている場合は、通常の光条件下で再キャプチャしてください。再キャプチャ中は、識別と比較のプロセスに影響を与える可能性のある障害物、反射、その他の問題を避けてください。

改ざんが検出された場合はどうすればよいですか?

ドキュメントで情報または顔の改ざんが検出されると、改ざんがプロンプト表示されます。

手動レビューを開始して、不正が発生したかどうかを判断してください。

手動レビューで引き続き通常のドキュメントと見なされる場合は、ZOLOZ のテクニカル サポートに連絡してさらに調査してください。

素材チェックに失敗した場合はどうすればよいですか?

素材チェックの失敗は、次の場合にプロンプト表示されます。

  • 印刷の問題がある

  • 偽造素材が検出された

まず、印刷または偽造素材の検出が原因で障害が発生したかどうかを確認してください。

アルゴリズムが印刷エラーを特定した場合は、通常の光条件下でドキュメントを再キャプチャしてください。それでも繰り返し入力に失敗する場合は、ZOLOZ のテクニカル サポートにお問い合わせください。

顔認識に失敗した場合はどうすればよいですか?

顔認識の失敗は、次の場合に発生します。

    <
  • 照明が明るすぎる、または暗すぎる

  • 背景がまだらであるか、ぼやけている

  • 背景に境界線状のオブジェクトがある

顔検証を開始する場合は、明るく鮮明な背景で実施してください。それでも繰り返し入力に失敗する場合は、ZOLOZ のテクニカル サポートにお問い合わせください。