モニタリングデータ収集

オプション実装

モニタリングデータ収集はオプションです。採用する場合、prepareSelfieCamera 呼び出しのみが影響を受けます — キャプチャフローの他のすべてのステップ（初期化、コールバック、結果処理）は変更されません。

キャプチャセッションにユーザーとフローのメタデータを添付することで、Unico 側の監視・オブザーバビリティツールで相関付けることができます。提供された場合、データはキャプチャと一緒に転送されます — SDK のキャプチャ動作や API レスポンスは変更されません。

setSilentInfo parameters

パラメータ	型	必須	説明
externalUserId	String	✅	あなたのシステムにおけるユーザー識別子。送信前に SHA-256 で自動的にハッシュ化されます — 平文では送信されません。
useCase	String	—	実行中のフローまたはコンテキストの識別子（例: "account_opening"、"password_recovery"）。平文で送信されます。

Implementation

prepareSelfieCamera を呼び出す前に、ビルド済みカメラインスタンスに対して setSilentInfo を呼び出します。キャプチャフローの他のすべての処理は同じままです。

import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);