---
title: Gerätemetadaten
description: Fähigkeit, die die Metadaten des bei der Aufnahme verwendeten Geräts zurückgibt, etwa Plattform, IP, Standort und die darauf erkannten Risikosignale.
canonical: https://developer.unico.io/de/capabilities/device-metadata
locale: de
generated_by: markdown-export
---

# Gerätemetadaten

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](/de/developers/api-reference/get-process) 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](/de/developers/start/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.

Zuletzt aktualisiert am **28. Okt. 2026**