> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Empreinte d'appareil et risque IP : API KYC

> Didit détecte appareils dupliqués, réseaux de fraude, VPN, proxies, Tor, écarts de localisation et empreintes d'appareil suspectes pendant la vérification KYC.

L'Analyse de l'appareil et de l'IP de Didit associe l'empreinte de l'appareil, la récupération d'appareils dupliqués, l'intelligence IP et les contrôles de géolocalisation au sein du flux de vérification. Elle permet de détecter lorsqu'un même appareil physique tente d'accéder à plusieurs comptes, même si l'utilisateur change de session, vide le stockage du navigateur, ouvre une fenêtre de navigation privée ou alterne ses informations réseau.

Prompt d'intégration pour l'Analyse de l'appareil et de l'IP
        Copier le prompt dans le presse-papiers



      
      

\<pre>

\````# Goal
Integrate Didit Device & IP Analysis (device fingerprinting + IP intelligence + geolocation) into your app.

\# Delivery mode
IP Analysis is **session-only**. The Web/Mobile SDK collects the device fingerprint and IP during the hosted flow — there is no standalone /v3/ip-analysis/ endpoint. It runs automatically on every session and does not require a workflow feature toggle for the basic signal set.

\# Steps
1\. (Optional) In the Business Console enable strict-mode rules for IP / device — e.g. "decline on VPN", "review on duplicate device", "decline on country mismatch with document".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user — the SDK collects fingerprint + IP in-band.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

curl (create session):
\```bash
curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-123",
"callback": "https://yourapp.com/post-kyc"
}'
\```

\# Decision surface
The result lands under `ip_analyses[]` on the decision payload (one entry per IP/device collection point in the workflow). Each entry carries the resolved geo, ASN, VPN / proxy / Tor flags, device fingerprint id, duplicate-device matches, and the warnings array.

\# Status enum (per ip_analyses[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.LOCATION)
Heads-up: IP Analysis emits warnings under the **LOCATION** bucket (not "IP_ANALYSIS"). Risk codes include:
VPN_DETECTED, PROXY_DETECTED, TOR_DETECTED, DATACENTER_IP, HIGH_RISK_COUNTRY, LOCATION_MISMATCH_WITH_DOCUMENT, DUPLICATED_DEVICE, POSSIBLE_DUPLICATED_DEVICE, IMPOSSIBLE_TRAVEL, DEVICE_FINGERPRINT_BLOCKLISTED, DEVICE_LINKED_TO_LIVENESS_ATTACK, DEVICE_MODEL_INCONSISTENT.
Full catalogue: /core-technology/ip-analysis/warnings-ip-analysis.

\# Failure modes to handle
\- ip_analyses[] empty — the user blocked the SDK fingerprinting script (privacy extensions, content blockers). Decide whether to fail-closed or fall back to soft signals.
\- VPN_DETECTED / PROXY_DETECTED / TOR_DETECTED — treat per your fraud policy (decline, manual review, additional liveness step).
\- DUPLICATED_DEVICE — same device previously enrolled under a different vendor_data; merge accounts or block per policy.
\- LOCATION_MISMATCH_WITH_DOCUMENT — the IP country does not match the document's issuing country; route to review.

\# See also
\- Canonical schema: /reference/data-models#ip-analysis
\- Per-feature report: /core-technology/ip-analysis/report-ip-analysis
\- Risk catalogue: /core-technology/ip-analysis/warnings-ip-analysis
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Coller dans

Cette fonctionnalité est conçue pour les décisions de prévention de la fraude où les faux positifs sont coûteux. Les correspondances exactes d'appareils dupliqués utilisent des identifiants persistants stables. Les correspondances d'appareils récupérés s'appuient sur le vecteur de signaux d'empreinte v2 et des critères stricts de haute confiance, ce qui permet à Didit de signaler les réutilisations suspectes sans fusionner de manière trop agressive des utilisateurs distincts.Dans la leçon de l'Academy consacrée à la lecture d'un résultat de vérification, le chapitre à 9:49 détaille les signaux de l'analyse de l'appareil et de l'IP.[Analyse de l'appareil et de l'IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Vue d'ensemble de l'Analyse de l'appareil et de l'IP de Didit montrant la géolocalisation, l'empreinte d'appareil, l'intelligence d'appareil et la détection de VPN](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=a2fbbbdd3d6fed3d759e54f362bf4762)![Schéma d'architecture de l'Analyse de l'appareil et de l'IP de Didit recoupant l'IP, l'empreinte d'appareil et la localisation déclarée](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis-how-it-works.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=3519ad9ad50091a00db5e09d5197fdfe)## Comment cela fonctionneL'Analyse de l'appareil et de l'IP s'exécute automatiquement lors de la session de vérification et relie le contexte de l'appareil, du réseau et de l'identité en une seule surface de risque.**1. Capture de l'empreinte de l'appareil**Le client de vérification transmet un payload d'empreinte v2 préservant la confidentialité comportant des signaux provenant d'appareils web ou mobiles :| Donnée | Description |
| - | - |
| **Identifiant d'appareil persistant** | Identifiant de première partie utilisé pour la détection exacte du même appareil lorsque les données de stockage sont conservées. |
| **Hash composite** | Hash stable de signaux regroupés utilisé pour les contrôles déterministes de doublons avec des garde-fous contre les collisions. |
| **Vecteur de signaux** | Attributs de l'appareil et du navigateur/de l'application vectorisés pour une récupération à haute confiance. |
| **Contexte de la plateforme** | Signaux du navigateur, de l'OS, de l'application, du matériel, de WebGL/canvas, des médias, de la locale, du fuseau horaire et d'intégrité mobile lorsqu'ils sont disponibles. |**2. Analyse de l'IP et de la connexion**Didit enrichit les données de connexion observées avec des informations sur le risque réseau :- Géolocalisation de l'IP par pays, région, ville et coordonnées
- Détection de VPN, proxy, Tor, centre de données et réseau privé
- Contrôles de l'IP attendue lorsque vous fournissez une IP autorisée pour la session
- Contrôles de la liste de blocage d'IP configurée dans votre application**3. Correspondance de doublons et de récupération**Didit vérifie si la session actuelle correspond à des sessions antérieures associées à un autre `vendor_data` :| Contrôle | Objectif |
| - | - |
| **IP dupliquée** | Détecte la même adresse IP partagée par différents utilisateurs. |
| **Empreinte d'appareil dupliquée** | Détecte la réutilisation exacte de la même identité persistante d'appareil. |
| **Appareil récupéré** | Détecte une récupération d'empreinte v2 à haute confiance lorsque l'identifiant persistant a changé. |
| **Garde-fou contre les collisions** | Ignore les hashes mutualisés de faible qualité au lieu de fusionner des appareils distincts. |**4. Recoupements de localisation**L'Analyse de l'appareil et de l'IP compare le contexte de localisation à des points de référence fiables :- Pays du document et coordonnées de l'adresse
- Adresse IP attendue pour la session
- Pays et ville de l'IP
- Distance et direction entre l'adresse et la localisation de l'IP**5. Action et génération de rapports**Vous pouvez configurer chaque catégorie de risque de manière indépendante et exploiter le résultat dans chaque canal de sortie de Didit :| Canal | Description |
| - | - |
| **Actions de workflow** | Approuver, examiner ou refuser en cas de VPN/proxy, d'incohérence de localisation, d'IP dupliquée, d'appareil dupliqué exact et d'appareil récupéré. |
| **Tableau de bord** | Examinez les avertissements, les sessions correspondantes, les informations sur l'appareil et les détails du réseau dans la console Didit. |
| **Webhooks et API** | Recevez des avertissements structurés et des correspondances dans les payloads de décision. |
| **Rapports** | Exportez les détails de l'Analyse de l'appareil et de l'IP dans les rapports PDF de vérification. |## Modèle de correspondanceL'Analyse de l'appareil et de l'IP sépare les correspondances exactes des correspondances récupérées afin que vous puissiez ajuster votre réponse face à la fraude en toute sécurité :| Couche | Ce qu'il détecte | Comportement vis-à-vis des faux positifs |
| - | - | - |
| **Identifiant persistant exact** | La même identité d'appareil de première partie apparaît dans la session d'un autre utilisateur. | Signal le plus fort. Utilisé pour `DUPLICATED_DEVICE_FINGERPRINT`. |
| **Hash composite** | Le même hash d'appareil déterministe apparaît dans la session d'un autre utilisateur. | Protégé par une détection de collision afin d'ignorer les pools courants de WebView ou de navigateurs. |
| **Appareil récupéré v2** | L'identifiant persistant a changé, mais des signaux détaillés de l'appareil correspondent à un appareil antérieur avec un niveau de confiance élevé. | Prudent. Utilisé pour `DEVICE_RECOVERED_HIGH_CONFIDENCE` uniquement après validation de critères stricts. |
| **Réutilisation d'IP** | La même adresse IP apparaît chez plusieurs utilisateurs. | Contextuel. Utile pour les réseaux de fraude, mais des bureaux partagés, des foyers ou des opérateurs mobiles peuvent être légitimes. |La correspondance d'appareils récupérés repose sur un index de récupération vectorielle dédié. Si cet index n'est pas disponible, Didit maintient les vérifications de doublons exacts sans émettre de candidats approximatifs à la récupération.Dans **Networks**, Didit met également en évidence la réutilisation de proxies résidentiels lorsque les mêmes informations d'intelligence IP associées à une adresse IP qui n'est pas celle d'un centre de données apparaissent pour plusieurs utilisateurs ou entreprises distincts. Le graphe affiche le signal de risque agrégé, le nombre de sujets concernés, le type de connexion, ainsi que le contexte du FAI et de l'ASN ; il n'expose pas l'adresse IP brute ni les données de profil d'une autre organisation.## Schémas de fraude détectésL'Analyse de l'appareil et de l'IP aide à identifier et réduire :- La création de comptes multiples et de comptes en double
- Les tentatives de contournement du KYC utilisant le même appareil pour différentes identités
- Les réseaux de fraude coordonnant de nombreux comptes à partir d'appareils ou d'infrastructures partagés
- L'abus de bonus, de parrainages, de promotions et d'essais gratuits
- L'onboarding d'identités synthétiques depuis des appareils récurrents
- Les schémas d'onboarding de mules financières
- Le risque de piratage de compte depuis des appareils inconnus ou à haut risque
- Le bourrage d'identifiants et les tentatives d'inscription automatisées
- Les tests de cartes, l'abus de rétrofacturation et l'abus de remboursement reposant sur des schémas récurrents d'appareils/réseaux
- L'évasion par VPN, proxy, Tor, centre de données et proxy résidentiel
- L'altération d'appareil, l'utilisation d'émulateurs, le risque de jailbreak/root et le clonage d'applications lorsque les signaux mobiles sont disponibles
- L'usurpation de localisation et les incohérences entre le document, l'IP, le fuseau horaire, l'opérateur et le contexte de l'appareil
- Les tentatives de vérification menées par des bots à l'aide de navigateurs headless ou de clients scriptés## Fonctionnalités clés#### Empreinte d'appareil et récupération- **Détection exacte des appareils en double** : détectez l'identité d'un même appareil à travers différentes sessions associées à des valeurs `vendor_data` distinctes.
- **Récupération à haute confiance** : rétablissez les relations probables d'un même appareil lorsque le stockage change ou que la navigation privée modifie l'identifiant persistant.
- **Protection contre les collisions** : évitez de regrouper des utilisateurs sans lien lorsqu'un hash d'appareil semble trop courant sur de nombreux identifiants persistants distincts.
- **Couverture web et mobile** : utilisez les signaux des navigateurs web et les signaux mobiles natifs, y compris les champs liés à l'intégrité lorsqu'ils sont disponibles.#### Renseignements sur l'IP et le réseau- **Détection de VPN et proxy** : identifiez les connexions masquées ou anonymisées.
- **Détection de Tor et centres de données** : signalez les infrastructures à haut risque.
- **Réutilisation de proxy résidentiel** : détectez l'utilisation répétée d'un même réseau d'apparence résidentielle par des entités distinctes sans exposer la valeur brute de l'IP dans le graphe Networks.
- **Listes de blocage d'IP** : refusez automatiquement lorsqu'une IP apparaît dans la liste de blocage de votre application.
- **Contrôle de l'IP attendue** : comparez l'IP observée à une IP attendue fournie lors de la création de la session.#### Géolocalisation et comparaison de documents- **Détection de discordance de pays** : comparez le pays du document et le pays de l'IP.
- **Géorepérage** : n'acceptez que les sessions provenant de pays autorisés — avec des exceptions par État/région pour des pays comme les États-Unis — en fonction de la géolocalisation de l'IP.
- **Vérifications de la distance de l'adresse** : comparez les coordonnées de l'adresse du document et la géolocalisation de l'IP.
- **Contexte de correspondance des sessions** : renvoyez les sessions correspondantes avec les détails de l'appareil et de la localisation pour l'examen par vos équipes.## Configurer les actionsUtilisez les paramètres de workflow pour choisir l'action associée à chaque risque. Les clients prudents configurent souvent `recovered_device_action` sur `REVIEW` dans un premier temps, inspectent les avertissements liés aux appareils récupérés pendant quelques semaines, puis ne passent à `DECLINE` qu'après avoir confirmé le profil local de faux positifs.| Paramètre | Action de départ recommandée | Raison |
| - | - | - |
| `vpn_detection_action` | `REVIEW` ou `DECLINE` | Dépend de l'autorisation ou non de l'utilisation d'un VPN dans votre produit. |
| `ip_mismatch_action` | `REVIEW` | Une discordance de localisation est un contexte déterminant mais peut être légitime. |
| `duplicated_ip_action` | `REVIEW` | Les réseaux partagés peuvent générer des faux positifs. |
| `duplicated_device_action` | `REVIEW` ou `DECLINE` | La réutilisation exacte du même appareil par plusieurs utilisateurs est un signal de fraude fort. |
| `recovered_device_action` | `REVIEW` | La récupération à haute confiance est délibérément prudente, mais doit être surveillée avant d'activer le refus automatique. |
| `ip_geofencing_action` | `DECLINE` | Le géorepérage traduit généralement une règle juridictionnelle stricte ; utilisez `REVIEW` si vous préférez un tri manuel des localisations restreintes. |Consultez les [avertissements d'Analyse de l'appareil et de l'IP](https://docs.didit.me/fr/core-technology/ip-analysis/warnings-ip-analysis.md) pour tous les tags de risque et les [configurations des fonctionnalités de workflow](https://docs.didit.me/fr/management-api/workflows/feature-configs.md#analyse-de-l’appareil-et-de-l’ip) pour les champs de l'API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.