Monitoring-Datenerfassung

Optionale Implementierung

Monitoring-Datenerfassung ist optional. Wenn Sie sie verwenden, ist nur der prepareSelfieCamera-Aufruf betroffen — jeder andere Schritt im Aufnahmeablauf (Initialisierung, Callbacks, Ergebnisverarbeitung) bleibt unverändert.

Benötigen Sie die Kamera überhaupt nicht?

Diese Seite behandelt setSilentInfo, das nur in Verbindung mit einem prepareSelfieCamera/prepareDocumentCamera-Aufruf wirksam wird. Wenn Sie eine stille Validierung wünschen, ohne jemals eine Kamerasitzung zu öffnen (z. B. bei einem Login-Bildschirm), verwenden Sie stattdessen initializeSDK + startSilentValidation — siehe Stille Revalidierung. Beide können auf derselben Seite verwendet werden.

Fügen Sie einer Aufnahmesitzung Benutzer- und Ablaufmetadaten hinzu, damit sie in Monitoring- und Observability-Tools auf Seite von Unico korreliert werden können und damit das Backend sie beim Ergebnis der Stillen Revalidierung für diese Transaktion berücksichtigen kann. Wenn die Daten angegeben werden, werden sie zusammen mit der Aufnahme weitergeleitet und ändern nicht das Aufnahmeverhalten des SDK — sie wirken sich jedoch auf die Antwort der Prozesserstellung aus: siehe silentAuth.result unter Stille Revalidierung.

setSilentInfo parameters

Parameter	Typ	Erforderlich	Beschreibung
`externalUserId`	`String`	✅	Benutzerkennung in Ihrem System. Wird vor der Übertragung automatisch mit SHA-256 gehasht — wird niemals im Klartext gesendet.
`useCase`	`String`	—	Kennung für den ausgeführten Ablauf oder Kontext (z. B. `"account_opening"`, `"password_recovery"`). Wird im Klartext übertragen.

Implementation

Rufen Sie setSilentInfo auf der erstellten Kamera-Instanz auf, bevor Sie prepareSelfieCamera aufrufen. Alles andere im Aufnahmeablauf bleibt gleich.

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