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: die Aufnahme, die in der Unico-Journey erfolgt.
• API mit dem Unico SDK: die Aufnahme, die das Unico SDK in Ihrer App durchführt.

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.

Die Fähigkeit wird in einem für Ihr Konto vertraglich vereinbarten Ablauf aktiviert. Wenden Sie sich an Ihren Unico-Ansprechpartner, um sie zu aktivieren.

Mögliche Antworten

Das Ergebnis wird im Objekt authenticationInfo.deviceMetadata von Prozess abrufen geliefert.

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 fehlendes Feld bedeutet, dass das Gerät diese Daten nicht erfasst hat.

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

Erforderliche Integrationskomponenten
SDK Web or SDK

Gültige Kombinationen

Gerätemetadaten sind nicht Teil der vordefinierten Abläufe unter Verfügbare Flows. Sie können zusammen mit jedem anderen Unico-Produkt in Web- und SDK-Integrationen aktiviert werden, in einem für Ihr Konto vertraglich vereinbarten Ablauf.

Produkte, die diese Fähigkeit nutzen

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