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

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

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