---
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/dual-api/capabilities/device-metadata
locale: de
generated_by: markdown-export
---

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.

> **Warnung: 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](/dual-api/developers/api-reference/web-sdk/get-process).
- **API-Vertrag:** in `deviceMetadata` von [Get Process](/dual-api/developers/api-reference/api/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](/dual-api/capabilities/available-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.