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

# Métadonnées de l'Appareil

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à.

- **Web :** la capture effectuée dans le parcours Unico.
- **API avec le SDK Unico :** la capture effectuée par le SDK Unico dans votre application.

> **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`.

La capacité est activée dans un flux contracté pour votre compte. Contactez votre interlocuteur Unico pour l'activer.

### Réponses possibles

Le résultat est renvoyé dans l'objet `authenticationInfo.deviceMetadata` de [Récupérer un processus](/fr/developers/api-reference/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 absent signifie que l'appareil n'a pas collecté cette donnée.

`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é

| Composants d'intégration requis |
| --- |
| SDK  Web or SDK |

### Combinaisons valides

Les Métadonnées de l'Appareil ne font pas partie des flux précomposés de [Flux disponibles](/fr/developers/start/flows). Elles peuvent être activées avec n'importe quel autre produit Unico dans les intégrations Web et SDK, dans un flux contracté pour votre compte.

### Produits utilisant cette capacité

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

Dernière mise à jour le **28 oct. 2026**