Gerätemetadaten

Markdown

Diese Fähigkeit gibt die Daten des Geräts zurück, mit dem der Benutzer die Aufnahme gemacht hat, zusammen mit den Ergebnissen der anderen vertraglich vereinbarten Produkte.

Was sie tut

Erfasst die Metadaten des in der Aufnahmesitzung verwendeten Geräts und die darauf erkannten Risikosignale (Details zu den Daten weiter unten).

Sie ist keine Validierung: Sie genehmigt oder lehnt den Prozess nie ab und lässt den Prozess nie fehlschlagen. Verwenden Sie die Daten in Ihren eigenen Risikoregeln oder internen Entscheidungs-Engines.

Eingaben

Es ist kein zusätzliches Feld erforderlich. Die Fähigkeit verwendet die Aufnahmesitzung, die der Prozess bereits hat.

• Web- & Native-Vertrag: aktiviert in einem für Ihr Konto vertraglich vereinbarten Ablauf. Der Prozess führt PROCESS_CAPACITY_DEVICE_METADATA in capacities auf.
• API-Vertrag: aktiviert im Recipe Ihres API-Schlüssels.

Metadaten hängen vom Unico SDK ab

Das Unico SDK erfasst die Metadaten während der Aufnahme. Eine API-Integration kann das Unico SDK verwenden oder nicht:

• API mit dem Unico SDK: die Metadaten werden wie gewohnt zurückgegeben.
• API ohne das Unico SDK: es gibt keine Metadaten, und die Antwort ist not_found.

Wenden Sie sich an Ihren Unico-Ansprechpartner, um sie zu aktivieren.

Mögliche Antworten

Das Ergebnis wird in einem deviceMetadata-Objekt geliefert:

• Web- & Native-Vertrag: in authenticationInfo.deviceMetadata von Prozess abrufen.
• API-Vertrag: in deviceMetadata von Get Process.

status	Bedeutung
found	Die Gerätemetadaten wurden gefunden. Die folgenden Felder sind mit dem gefüllt, was das Gerät erfasst hat.
not_found	Für diese Aufnahme gibt es keine Gerätemetadaten, zum Beispiel bei einem API-Prozess ohne das Unico SDK.
unavailable	Die Metadaten konnten in diesem Moment nicht abgerufen werden. Das Prozessergebnis ist nicht betroffen.

Wenn status den Wert found hat:

Feld	Typ	Beschreibung
deviceId	string	Gerätekennung.
platform	string	Plattform, von der die Aufnahme stammt, z. B. WEB, ANDROID, IOS.
ip	string	IP-Adresse des Geräts.
ipCountry	string	Land der IP-Adresse.
ipGeoCoordinates	object	Standort der IP-Adresse (lat, lng).
gpsCoordinates	object	Vom GPS des Geräts gemeldeter Standort (lat, lng).
osName	string	Name des Betriebssystems.
osVersion	string	Version des Betriebssystems.
browserName	string	Name des Browsers. Nur Web.
userAgent	string	User Agent des Browsers. Nur Web.
appStore	string	App Store, aus dem Ihre App installiert wurde. Nur natives SDK.
detectedSignals	array of strings	Gruppen von Risikosignalen, die auf dem Gerät erkannt wurden. Leer, wenn keine erkannt wurde.

Ein Feld, das das Gerät nicht erfasst hat, fehlt im Web- & Native-Vertrag und ist im API-Vertrag null.

detectedSignals listet nur die erkannten Gruppen auf. Eine Gruppe gilt als erkannt, wenn mindestens eines ihrer Signale gefunden wurde:

Gruppe	Bedeutung
origin_obfuscated	Der tatsächliche Ursprung des Zugriffs ist verschleiert, zum Beispiel durch Tor oder Anti-Fingerprinting-Tools.
untrusted_location	Der Standort kann gefälscht sein, zum Beispiel durch einen Proxy, ein VPN oder einen GPS-Spoofer.
environment_altered	Die Geräteumgebung ist verändert, zum Beispiel ein Emulator oder ein gerootetes bzw. gejailbreaktes Gerät.
app_manipulated	Die App wurde manipuliert, gehookt oder debuggt.
assisted_session	Möglicherweise steuert eine andere Person die Sitzung, zum Beispiel per Bildschirmfreigabe oder durch einen Bot.
payload_untrusted	Die vom Gerät gesendeten Daten wurden manipuliert.

Nicht jedes Signal existiert auf jeder Plattform, daher kann dasselbe Gerät im Web und im nativen SDK unterschiedliche Gruppen aufweisen.

Verfügbarkeit

Oberfläche	Unterstützt
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅

Gültige Kombinationen

Gerätemetadaten sind nicht Teil des vordefinierten flow-Katalogs unter Verfügbare Flows. Sie werden in einem für Ihr Konto vertraglich vereinbarten Ablauf (Web- & Native-Vertrag) oder im Recipe Ihres API-Schlüssels (API-Vertrag) aktiviert und können zusammen mit jedem anderen Unico-Produkt in Web- und SDK-Integrationen aktiviert werden.

Anwendungsfälle, die diese Fähigkeit nutzen

Sie kann jedem Unico-Anwendungsfall in Web- und SDK-Integrationen hinzugefügt werden.