SEONAction utilisateurStable

Collect device session (SEON)

Collecte, dans une expérience utilisateur hébergée, une session SEON Device Intelligence chiffrée qui peut enrichir une évaluation antifraude ultérieure.

Parcours utilisateur

Collecter une session appareil (SEON)

Session appareil

Statut de collecte

Date de collecte

Vue d’ensemble

Ce node ouvre une action utilisateur qui charge SEON Device Intelligence dans le navigateur et produit une session chiffrée représentant les signaux disponibles sur l’appareil, le réseau et, selon la configuration, le comportement ou la géolocalisation.

La session est destinée à être transmise à une évaluation antifraude ; elle ne constitue pas elle-même une décision.
La collecte n’est déclenchée qu’après une action explicite de l’utilisateur sur le bouton présenté dans le parcours.
Le parcours peut être configuré pour continuer sans session lorsque Device Intelligence est indisponible.

Scénario type

Pendant un checkout, l’acheteur lance le contrôle appareil. La session obtenue est transmise avec la commande, l’adresse IP et le contexte acheteur à Assess fraud (SEON). SEON peut alors tenir compte des signaux appareil dans sa décision.

Prise en main

La configuration recommandée consiste à conserver les réglages de collecte par défaut, à adapter les textes présentés et à relier la session au node d’évaluation.

Configuration minimale

Sélectionner une configuration SEON active.
Définir un titre et une description compréhensibles dans la langue du parcours.
Conserver allow_degraded = true lorsque l’appareil n’est pas un signal obligatoire.

Collecte renforcée

Activer la géolocalisation seulement lorsque sa finalité est justifiée.
Adapter behavioral_targets aux champs réellement présents.
Définir un texte de consentement ou d’information adapté à votre cadre juridique.

Exemple de configuration

Paramètre	Binding	Rôle
`extension_config_id`	`seon_config_id`	Configuration et région SEON
`title`	`Vérification de sécurité`	Titre visible par l’utilisateur
`description`	`Nous analysons cet appareil pour prévenir la fraude.`	Finalité de la collecte
`allow_degraded`	`true`	Autorise la poursuite sans session

À retenir Reliez toujours device_session au node qui consomme réellement le signal. Une session collectée mais non transmise à Assess fraud (SEON) n’améliore pas l’évaluation.

Exemple de processus

Checkout

Collecter une session appareil (SEON)

Évaluer le risque de fraude (SEON)

Approved

Review required

Declined

Poursuivre

Revue manuelle

Bloquer

Collecter les signaux appareil pendant le checkout, puis transmettre la session à l’évaluation antifraude et traiter la décision obtenue.

Paramètres 10

Présentation et configuration

Configuration SEON et textes affichés à l’utilisateur.

extension_config_idRequisref(extension_config:seon)

Configuration SEON active. Sa région de traitement est reprise pour initialiser Device Intelligence.

titleOptionnelstring

Titre présenté à l’utilisateur au-dessus de l’action de collecte. Valeur par défaut : Secure device check.

descriptionOptionnelstring

Texte expliquant pourquoi les signaux appareil sont collectés. Adaptez-le au contexte du parcours et à votre politique de transparence.

consent_textOptionnelstring

Texte complémentaire affiché à l’utilisateur, par exemple une information sur la finalité de la collecte ou un renvoi vers votre politique de confidentialité.

Signaux collectés

Choix des signaux supplémentaires demandés au navigateur.

geolocation_enabledOptionnelboolean

Autorise Device Intelligence à demander l’accès à la géolocalisation du navigateur. Désactivé par défaut. Activez-le uniquement lorsque ce signal est utile et couvert par votre politique de consentement.

behavioral_monitoring_enabledOptionnelboolean

Active la collecte de signaux comportementaux sur les éléments ciblés de la page. Activé par défaut.

behavioral_targetsOptionnelstring

Sélecteurs CSS des éléments suivis pour les signaux comportementaux. La valeur par défaut couvre input, textarea, select et button. À modifier seulement si la structure de votre page l’exige.

Résilience

Ajustez ces paramètres uniquement lorsque les contraintes réseau ou la politique de blocage du parcours le nécessitent.

network_timeout_msOptionnelinteger

Temps maximal accordé aux opérations réseau de Device Intelligence, entre 250 et 10 000 ms. Valeur par défaut : 2 000 ms.

field_timeout_msOptionnelinteger

Temps maximal accordé à la collecte des signaux d’un champ, entre 250 et 10 000 ms. Valeur par défaut : 2 000 ms.

allow_degradedOptionnelboolean

Détermine si l’utilisateur peut poursuivre lorsque la collecte est indisponible ou échoue. Activé par défaut.

Valeur	Comportement
`true`	Le parcours peut continuer avec `collection_status = unavailable` ou `failed`, sans `device_session`.
`false`	L’échec est bloquant et doit être résolu avant de poursuivre l’action utilisateur.

Sorties 4

Résultat de collecte

Sorties à transmettre au reste du processus.

device_sessionOptionnelstring

Session chiffrée produite par SEON lorsque la collecte réussit. Reliez-la à l’entrée device_session de Assess fraud (SEON).

collection_statusenum

Résultat de la tentative de collecte.

Valeur	Signification
`collected`	La session appareil a été collectée et `device_session` est disponible.
`unavailable`	Le SDK Device Intelligence n’a pas pu être chargé ou initialisé.
`failed`	Le SDK était disponible, mais la collecte de la session a échoué.

collected_atOptionneldatetime

Date et heure de la collecte réussie. Cette sortie est absente lorsque la session n’a pas été obtenue.

Diagnostic

Disponible uniquement lorsque la collecte est indisponible ou échoue.

error_messageOptionnelstring

Message décrivant l’indisponibilité ou l’échec de collecte. Utilisez-le pour le diagnostic ; ne l’affichez pas nécessairement tel quel à l’utilisateur final.

Comportement

Préparer l’action utilisateur

Le node reprend la région de la configuration SEON et prépare les textes, timeouts et options de collecte.

Charger Device Intelligence

Le navigateur charge et initialise le SDK SEON. Une indisponibilité produit collection_status = unavailable.

Déclencher la collecte

L’utilisateur lance explicitement le contrôle. Le bouton permet également de rafraîchir une session déjà collectée.

Retourner le résultat

Une collecte réussie produit device_session, collection_status = collected et collected_at. Un échec produit failed et un message de diagnostic.

Appliquer la politique de dégradation

Avec allow_degraded = true, le parcours peut continuer sans session. Sinon, l’échec reste bloquant.

Limites et responsabilités

Le node collecte une session appareil ; il ne calcule aucun score et ne prend aucune décision antifraude.
La collecte nécessite un navigateur capable de charger le SDK SEON et une interaction de l’utilisateur.
Activer la géolocalisation peut déclencher une demande d’autorisation du navigateur.
Une exécution dégradée ne produit pas de device_session : l’évaluation suivante disposera de moins de signaux.
Vous restez responsable de l’information des utilisateurs, du consentement éventuel et de la conformité de la collecte à votre contexte.

Résolution des problèmes

`collection_status = unavailable`

Le SDK n’a pas pu être chargé ou initialisé. Vérifiez l’accès réseau au domaine SEON, les politiques CSP du parcours et la configuration provider.

`collection_status = failed`

La collecte a démarré mais n’a pas produit de session. Consultez error_message, vérifiez les timeouts et permettez éventuellement une nouvelle tentative.

Le parcours reste bloqué

Vérifiez allow_degraded. Avec la valeur false, toute indisponibilité ou tout échec doit être corrigé avant de poursuivre.