モニタリングデータ収集

オプション実装

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

そもそもカメラが不要な場合は?

このページでは、prepareSelfieCamera/prepareDocumentCamera の呼び出しと組み合わせた場合にのみ効果を持つ setSilentInfo について説明します。カメラセッションを一切開かずにサイレント検証を行いたい場合（ログイン画面など）は、代わりに initializeSDK + startSilentValidation を使用してください — 詳細はサイレント再検証を参照してください。どちらも同じページで使用できます。

キャプチャセッションにユーザーとフローのメタデータを添付することで、Unico 側の監視・オブザーバビリティツールで相関付けることができるだけでなく、バックエンドがこの取引のサイレント再検証の結果にそのメタデータを反映できるようになります。提供された場合、データはキャプチャと一緒に転送され、SDK のキャプチャ動作は変更されません — ただし、Create Process のレスポンスには影響します。詳細はサイレント再検証の silentAuth.result を参照してください。

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);