Rapport d'analyse de l'appareil et de l'IP

Vue d’ensemble

L’analyse de l’appareil et de l’IP établit le profil de chaque session par géolocalisation IP, empreinte d’appareil, navigateur/système d’exploitation et type de réseau. La géolocalisation, l’enrichissement des risques réseau, la mise en correspondance d’appareils et les vérifications d’intégrité de l’appareil à distance s’exécutent de manière asynchrone pendant que l’utilisateur effectue la vérification. Les observations sur l’appareil et l’IP restent disponibles pendant que l’analyse est en cours ; les champs de géolocalisation peuvent être vides jusqu’à la réception des résultats, ou lorsque l’adresse n’est pas publique. Si votre workflow utilise ces vérifications pour déterminer l’issue ou sélectionner une étape ultérieure, la session reste In Progress jusqu’à ce que les résultats requis soient disponibles. Si l’analyse requise reste indisponible après un nombre limité de tentatives, la session passe à In Review pour une décision manuelle. Les échecs d’enrichissement facultatifs n’empêchent pas la finalisation, et les décisions manuelles prévalent toujours. Elle produit :

Un bloc de géolocalisation IP (pays, État, ville, latitude/longitude, fuseau horaire) déduit de l’IP publique.
Des indicateurs de risque réseau — is_vpn_or_tor et is_data_center — pour détecter les tentatives de dissimulation (VPN, nœuds de sortie Tor, hébergeurs, anonymiseurs).
Des calculs de distance entre documents — la distance à vol d’oiseau en km entre l’emplacement de l’IP, l’emplacement du document d’identité et l’emplacement du justificatif de domicile.
Des correspondances entre sessions — lorsque la même adresse IP ou identité d’appareil apparaît sur différentes sessions appartenant à des utilisateurs distincts (regroupés par vendor_data).
Une récupération d’empreinte d’appareil — un signal de récupération avec un niveau de confiance élevé qui lie les sessions même après que l’utilisateur a vidé son stockage, est passé en mode navigation privée ou a réinstallé l’application.

Capture d'écran du rapport d'analyse d'appareil et d'IP de Didit avec géolocalisation, empreinte d'appareil et indicateurs de risque

Où elle apparaît dans les réponses d’API

L’endpoint de décision renvoie l’analyse de l’appareil et de l’IP sous la forme du tableau ip_analyses[] dans GET /v3/session/{sessionId}/decision/. Les entrées sont des observations Location dédupliquées, identifiées par (node_id, ip_address, device_fingerprint) — un même nœud peut générer plusieurs entrées lorsque l’IP ou l’appareil de l’utilisateur change en cours de session.

GET /v3/session/{sessionId}/decision/
  ──▶ { "ip_analyses": [ { status, node_id, ip_address, ip, id_document, poa_document, warnings, matches, … }, … ] }

La structure ci-dessous reflète le schéma canonique — voir Modèles de données.

Schéma

Consultez Analyse de l’appareil et de l’IP dans la référence des modèles de données pour le schéma canonique.

interface IPAnalysisV3 {
  status: 'Not Finished' | 'Approved' | 'Declined' | 'In Review' | 'Resub Requested';
  node_id: string | null;

  // Device
  device_brand: string | null;
  device_model: string | null;
  browser_family: string | null;
  os_family: string | null;
  platform: 'mobile' | 'tablet' | 'desktop' | null;
  device_fingerprint: string | null;

  // IP geolocation
  ip_country: string | null;
  ip_country_code: string | null;           // ISO 3166-1 alpha-2
  ip_state: string | null;
  ip_city: string | null;
  latitude: number | null;
  longitude: number | null;
  ip_address: string;
  isp: string | null;
  organization: string | null;
  is_vpn_or_tor: boolean;
  is_data_center: boolean;
  time_zone: string | null;
  time_zone_offset: string | null;

  // Distance blocks — each carries its own location + distances to the other two
  ip: {
    location: { latitude: number; longitude: number } | null;
    distance_from_id_document: number | null;   // km
    distance_from_poa_document: number | null;  // km
  };
  id_document: {
    location: { latitude: number; longitude: number } | null;
    distance_from_ip: number | null;
    distance_from_poa_document: number | null;
  };
  poa_document: {
    location: { latitude: number; longitude: number } | null;
    distance_from_ip: number | null;
    distance_from_id_document: number | null;
  };

  warnings: Warning[];          // see Data Models — Warning object

  // Cross-session matches — up to 5 IP matches + 5 device matches
  matches: IPAnalysisMatch[];
}

interface IPAnalysisMatch {
  session_id: string;                       // matching session UUID
  session_number: number;
  vendor_data: string | null;
  verification_date: string | null;         // "YYYY-MM-DDTHH:MM:SSZ"
  match_type: 'ip_address' | 'device_fingerprint';
  match_source: 'ip_address' | 'persistent_id' | 'legacy_fp' | 'recovered_high';
  matched_value: string | null;             // shared IP, device identifier, or recovered device UUID
  status: string;                           // lifecycle status of the matching session
  is_blocklisted: boolean;                  // currently always false
  api_service: string | null;               // standalone API service; null for workflow sessions
  source: 'session';
  device_info: {
    device_brand: string | null;
    device_model: string | null;
    browser_family: string | null;
    os_family: string | null;
    platform: string | null;
    device_fingerprint: string | null;
  };
  location_info: {
    ip_address: string | null;
    ip_country: string | null;
    ip_country_code: string | null;
    ip_state: string | null;
    ip_city: string | null;
    is_vpn_or_tor: boolean;
    is_data_center: boolean;
  };
  confidence: number;                       // 0–1, = 1 - P(false positive)
  match_mode: 'deterministic' | 'probabilistic' | 'co_occurrence';

  // Present only when match_source = 'recovered_high'
  recovery_similarity?: number;             // cosine similarity, 4 decimals
  tls_ja4_corroborated?: boolean;           // TLS JA4 fingerprints of both observations agree
  recovery_gate_reason?: string;            // e.g. 'hardware_root_match'
}

Sémantique des correspondances

match_source indique la manière dont la correspondance a été établie, et confidence évalue la probabilité qu’elle soit erronée (confidence = 1 - P(false positive)) :

`match_source`	Signification	`confidence`	`match_mode`
`ip_address`	IP partagée — colocalisation réseau, jamais une affirmation d’identité d’appareil.	`0.0`	`co_occurrence`
`persistent_id`	Identifiant d’appareil persistant stocké exact.	`1.0`	`deterministic`
`legacy_fp`	Hachage d’empreinte d’appareil hérité `didit-fp-*`.	`0.5`	`probabilistic`
`recovered_high`	Résultat de récupération approximative d’empreinte avec un niveau de confiance élevé après des contrôles stricts et bloquants.	`1.0` si ancré dans le matériel, sinon `< 1.0`, augmenté lorsque TLS JA4 et le pays de l’IP concordent de manière indépendante	`deterministic` ou `probabilistic`

Les candidats de récupération à plus faible niveau de confiance apparaissent uniquement sous forme d’avertissements de risque — jamais dans matches[]. Les correspondances IP et les correspondances d’appareil sont limitées à 5 chacune, de sorte que le tableau contient au maximum 10 entrées.

Valeurs de statut

Les statuts sont des valeurs FeatureStatusChoices au niveau de la fonctionnalité. Chaque avertissement déclenché correspond à l’action configurée pour celui-ci sur le nœud du workflow ; l’action la plus stricte l’emporte.

Valeur	Signification
`Not Finished`	Le nœud d’analyse IP ne s’est pas terminé pour cette session (par défaut).
`Approved`	Aucun avertissement ne s’est déclenché, ou chaque avertissement déclenché est configuré sur Aucune action.
`In Review`	Au moins un avertissement déclenché est configuré sur Examen (voir les avertissements).
`Declined`	Un avertissement de liste de blocage s’est déclenché (`IP_ADDRESS_IN_BLOCKLIST` ou `DEVICE_FINGERPRINT_IN_BLOCKLIST` — entraînant toujours un refus), ou un avertissement configurable est défini sur Refuser pour votre workflow.
`Resub Requested`	Un réviseur a demandé la resoumission de cette étape.

Des règles de statut personnalisées configurées sur le nœud d’analyse IP peuvent également ajuster le statut résultant.

Détection de VPN, proxy et Tor

is_vpn_or_tor et is_data_center sont des indicateurs booléens indépendants renvoyés pour chaque session. Lorsque is_vpn_or_tor vaut true, Didit émet également l’avertissement PRIVATE_NETWORK_DETECTED afin que votre équipe puisse agir en conséquence via la configuration du workflow. Le trafic provenant uniquement d’un centre de données (sans VPN/Tor) définit is_data_center=true sans déclencher d’avertissement automatique — utilisez-le comme signal supplémentaire dans votre propre notation.

Exemples

Approuvé

{
  "ip_analyses": [
    {
      "status": "Approved",
      "node_id": "ip-1",
      "device_brand": "Apple",
      "device_model": "iPhone",
      "browser_family": "Mobile Safari",
      "os_family": "iOS",
      "platform": "mobile",
      "device_fingerprint": "didit-fp-8d2c7a91f4b3e042",
      "ip_country": "Spain",
      "ip_country_code": "ES",
      "ip_state": "Barcelona",
      "ip_city": "Barcelona",
      "latitude": 41.4022,
      "longitude": 2.1407,
      "ip_address": "83.50.226.71",
      "isp": "Telefonica",
      "organization": "Telefonica de Espana",
      "is_vpn_or_tor": false,
      "is_data_center": false,
      "time_zone": "Europe/Madrid",
      "time_zone_offset": "+0100",
      "ip": {
        "location": { "latitude": 41.4022, "longitude": 2.1407 },
        "distance_from_id_document": 23.4,
        "distance_from_poa_document": 12.3
      },
      "id_document": {
        "location": { "latitude": 41.2706, "longitude": 1.9770 },
        "distance_from_ip": 23.4,
        "distance_from_poa_document": 18.7
      },
      "poa_document": {
        "location": { "latitude": 41.3128, "longitude": 2.0540 },
        "distance_from_ip": 12.3,
        "distance_from_id_document": 18.7
      },
      "warnings": [],
      "matches": []
    }
  ]
}

Refusé — détection dans la liste de blocage IP + VPN + appareil en double

{
  "ip_analyses": [
    {
      "status": "Declined",
      "node_id": "ip-1",
      "device_brand": null,
      "device_model": null,
      "browser_family": "Chrome",
      "os_family": "Linux",
      "platform": "desktop",
      "device_fingerprint": "didit-fp-a13c0d22e8b94471",
      "ip_country": "Netherlands",
      "ip_country_code": "NL",
      "ip_state": "North Holland",
      "ip_city": "Amsterdam",
      "latitude": 52.3676,
      "longitude": 4.9041,
      "ip_address": "45.61.20.5",
      "isp": "Example Hosting",
      "organization": "Example Hosting BV",
      "is_vpn_or_tor": true,
      "is_data_center": true,
      "time_zone": "Europe/Amsterdam",
      "time_zone_offset": "+0100",
      "ip": {
        "location": { "latitude": 52.3676, "longitude": 4.9041 },
        "distance_from_id_document": 1834.2,
        "distance_from_poa_document": 1822.5
      },
      "id_document": {
        "location": { "latitude": 40.4168, "longitude": -3.7038 },
        "distance_from_ip": 1834.2,
        "distance_from_poa_document": 14.0
      },
      "poa_document": {
        "location": { "latitude": 40.5070, "longitude": -3.6720 },
        "distance_from_ip": 1822.5,
        "distance_from_id_document": 14.0
      },
      "warnings": [
        {
          "feature": "LOCATION",
          "risk": "IP_ADDRESS_IN_BLOCKLIST",
          "additional_data": { "ip_address": "45.61.20.5" },
          "log_type": "error",
          "short_description": "IP address in blocklist",
          "long_description": "The IP address used for this session was found in the application's IP blocklist, indicating a known suspicious or forbidden origin.",
          "node_id": "ip-1"
        },
        {
          "feature": "LOCATION",
          "risk": "PRIVATE_NETWORK_DETECTED",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "Private network (VPN/Tor) detected",
          "long_description": "The system detected that the user tried to use a private network (VPN/TOR) to complete the verification process.",
          "node_id": "ip-1"
        },
        {
          "feature": "LOCATION",
          "risk": "COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP",
          "additional_data": { "document_country_code": "ESP", "ip_country_code": "NLD" },
          "log_type": "warning",
          "short_description": "Document country does not match IP country",
          "long_description": "The country from the document does not match the country from the IP address, suggesting a potential mismatch between the document and the user's location.",
          "node_id": "ip-1"
        },
        {
          "feature": "LOCATION",
          "risk": "DUPLICATED_DEVICE_FINGERPRINT",
          "additional_data": {
            "duplicated_session_id": "11111111-2222-3333-4444-555555555555",
            "duplicated_session_number": 1042,
            "api_service": null,
            "match_source": "persistent_id"
          },
          "log_type": "warning",
          "short_description": "Duplicated device fingerprint from another session",
          "long_description": "The same device fingerprint was detected in another session with a different vendor_data, which may indicate multiple identities verified from the same device.",
          "node_id": "ip-1"
        }
      ],
      "matches": [
        {
          "session_id": "11111111-2222-3333-4444-555555555555",
          "session_number": 1042,
          "vendor_data": "user-other",
          "verification_date": "2026-05-28T14:03:21Z",
          "match_type": "device_fingerprint",
          "match_source": "persistent_id",
          "matched_value": "pid_9f1c2b7a8d3e4f50",
          "status": "Declined",
          "is_blocklisted": false,
          "api_service": null,
          "source": "session",
          "device_info": {
            "device_brand": null,
            "device_model": null,
            "browser_family": "Chrome",
            "os_family": "Linux",
            "platform": "desktop",
            "device_fingerprint": "didit-fp-a13c0d22e8b94471"
          },
          "location_info": {
            "ip_address": "45.61.23.99",
            "ip_country": "Netherlands",
            "ip_country_code": "NL",
            "ip_state": "North Holland",
            "ip_city": "Amsterdam",
            "is_vpn_or_tor": true,
            "is_data_center": true
          },
          "confidence": 1.0,
          "match_mode": "deterministic"
        }
      ]
    }
  ]
}

Voir aussi

Avertissements de l’analyse de l’appareil et de l’IP — tous les codes d’avertissement que l’analyse IP peut émettre
Vue d’ensemble de l’analyse de l’appareil et de l’IP — ce que mesure chaque bloc
Modèles de données — Analyse IP — schéma canonique
Webhooks — status.updated transmet le même payload d’analyse IP

Authentification

Vérification

Surveillance

Plateforme

Rapport d'analyse de l'appareil et de l'IP

Vue d’ensemble

Où elle apparaît dans les réponses d’API

Schéma

Sémantique des correspondances

Valeurs de statut

Détection de VPN, proxy et Tor

Exemples

Approuvé

Refusé — détection dans la liste de blocage IP + VPN + appareil en double

Voir aussi

​Vue d’ensemble

​Où elle apparaît dans les réponses d’API

​Schéma

​Sémantique des correspondances

​Valeurs de statut

​Détection de VPN, proxy et Tor

​Exemples

​Approuvé

​Refusé — détection dans la liste de blocage IP + VPN + appareil en double

​Voir aussi

Vue d’ensemble

Où elle apparaît dans les réponses d’API

Schéma

Sémantique des correspondances

Valeurs de statut

Détection de VPN, proxy et Tor

Exemples

Approuvé

Refusé — détection dans la liste de blocage IP + VPN + appareil en double

Voir aussi