Métadonnées de l'Appareil

Markdown

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.

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.
• Contrat API : dans deviceMetadata de 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. 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.