---
title: Métadonnées de l'Appareil
description: Capacité qui renvoie les métadonnées de l'appareil utilisé lors de la capture, telles que la plateforme, l'IP, la localisation et les signaux de risque détectés sur celui-ci.
canonical: https://developer.unico.io/fr/dual-api/capabilities/device-metadata
locale: fr
generated_by: markdown-export
---

Cette capacité renvoie les données de l'appareil depuis lequel l'utilisateur a effectué la capture, en même temps que les résultats des autres produits contractés.

### Ce qu'elle fait

Collecte les métadonnées de l'appareil utilisé lors de la session de capture et les signaux de risque détectés sur celui-ci (détail des données ci-dessous).

Ce n'est pas une validation : elle n'approuve ni ne rejette jamais le processus, et ne fait jamais échouer le processus. Utilisez les données dans vos propres règles de risque ou moteurs de décision internes.

### Entrées

Aucun champ supplémentaire n'est nécessaire. La capacité utilise la session de capture dont le processus dispose déjà.

- **Contrat Web & Native :** activée dans un flux contracté pour votre compte. Le processus liste `PROCESS_CAPACITY_DEVICE_METADATA` dans `capacities`.
- **Contrat API :** activée dans la Recipe de votre clé API.

> **Avertissement: Les métadonnées dépendent du SDK Unico**
>
> C'est le SDK Unico qui collecte les métadonnées, pendant la capture. Une intégration API peut utiliser ou non le SDK Unico :
>
> - **API avec le SDK Unico :** les métadonnées sont renvoyées normalement.
> - **API sans le SDK Unico :** il n'y a pas de métadonnées, et la réponse est `not_found`.

Contactez votre interlocuteur Unico pour l'activer.

### Réponses possibles

Le résultat est renvoyé dans un objet `deviceMetadata` :

- **Contrat Web & Native :** dans `authenticationInfo.deviceMetadata` de [Get Process](/dual-api/developers/api-reference/web-sdk/get-process).
- **Contrat API :** dans `deviceMetadata` de [Get Process](/dual-api/developers/api-reference/api/get-process).

| `status` | Signification |
|---|---|
| `found` | Les métadonnées de l'appareil ont été trouvées. Les champs ci-dessous sont remplis avec ce que l'appareil a collecté. |
| `not_found` | Il n'y a pas de métadonnées d'appareil pour cette capture, par exemple un processus API sans le SDK Unico. |
| `unavailable` | Les métadonnées n'ont pas pu être récupérées à ce moment-là. Le résultat du processus n'est pas affecté. |

Lorsque `status` vaut `found` :

| Champ | Type | Description |
|---|---|---|
| `deviceId` | string | Identifiant de l'appareil. |
| `platform` | string | Plateforme d'où provient la capture, par exemple `WEB`, `ANDROID`, `IOS`. |
| `ip` | string | Adresse IP de l'appareil. |
| `ipCountry` | string | Pays de l'adresse IP. |
| `ipGeoCoordinates` | object | Localisation de l'adresse IP (`lat`, `lng`). |
| `gpsCoordinates` | object | Localisation indiquée par le GPS de l'appareil (`lat`, `lng`). |
| `osName` | string | Nom du système d'exploitation. |
| `osVersion` | string | Version du système d'exploitation. |
| `browserName` | string | Nom du navigateur. Web uniquement. |
| `userAgent` | string | User agent du navigateur. Web uniquement. |
| `appStore` | string | Magasin d'applications depuis lequel votre application a été installée. SDK natif uniquement. |
| `detectedSignals` | array of strings | Groupes de signaux de risque détectés sur l'appareil. Vide lorsqu'aucun n'a été détecté. |

Un champ que l'appareil n'a pas collecté est absent dans le contrat Web & Native et vaut `null` dans le contrat API.

`detectedSignals` ne liste que les groupes détectés. Un groupe est détecté lorsqu'au moins un de ses signaux a été trouvé :

| Groupe | Signification |
|---|---|
| `origin_obfuscated` | L'origine réelle de l'accès est masquée, par exemple par Tor ou des outils anti-fingerprinting. |
| `untrusted_location` | La localisation peut être fausse, par exemple à cause d'un proxy, d'un VPN ou d'un GPS spoofer. |
| `environment_altered` | L'environnement de l'appareil est altéré, par exemple un émulateur ou un appareil rooté ou jailbreaké. |
| `app_manipulated` | L'application a été altérée, interceptée (hooking) ou déboguée. |
| `assisted_session` | Une autre personne peut piloter la session, par exemple via un partage d'écran ou un bot. |
| `payload_untrusted` | Les données envoyées par l'appareil ont été altérées. |

Tous les signaux n'existent pas sur toutes les plateformes, de sorte qu'un même appareil peut présenter des groupes différents sur le web et sur le SDK natif.

### Disponibilité

| Surface | Prise en charge |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ✅ |
| **Web** (iFrame, Redirect) | ✅ |

### Combinaisons valides

Les Métadonnées de l'Appareil ne font pas partie du catalogue de `flow` précomposés de [Flux disponibles](/dual-api/capabilities/available-flows). Elles sont activées dans un flux contracté pour votre compte (contrat Web & Native) ou dans la Recipe de votre clé API (contrat API), et peuvent être activées avec n'importe quel autre produit Unico dans les intégrations Web et SDK.

### Cas d'usage utilisant cette capacité

Elle peut être ajoutée à n'importe quel cas d'usage Unico dans les intégrations Web et SDK.