> ## 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. # Device fingerprinting e API di rischio IP per KYC > Didit rileva dispositivi duplicati, reti di frode, VPN, proxy, Tor, discrepanze di posizione e impronte sospette dei dispositivi durante la verifica KYC. L'Analisi dispositivo e IP di Didit combina il fingerprinting del dispositivo, il recupero dei dispositivi duplicati, le informazioni sugli IP e i controlli di geolocalizzazione nel flusso di verifica. Aiuta a rilevare quando lo stesso dispositivo fisico tenta di accedere a più account, anche quando l'utente cambia sessione, cancella lo storage del browser, apre una finestra di navigazione in incognito o modifica le informazioni di rete. Prompt per l'integrazione dell'Analisi dispositivo e IP Copia il prompt negli appunti \

\````# 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````

\
Incolla in Questa funzionalità è progettata per decisioni antifrode in cui i falsi positivi risultano costosi. Le corrispondenze esatte per dispositivi duplicati utilizzano identificatori persistenti stabili. Le corrispondenze per dispositivi recuperati utilizzano il vettore di segnali del fingerprint v2 e controlli ad alta affidabilità, consentendo a Didit di individuare il riutilizzo sospetto senza unire in modo troppo aggressivo utenti non correlati.Nella lezione della Didit Academy su come interpretare l'esito di una verifica, il capitolo al minuto 9:49 illustra in dettaglio i segnali dell'analisi del dispositivo e dell'IP.[Analisi dispositivo e IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Panoramica dell'Analisi dispositivo e IP di Didit con geolocalizzazione, fingerprinting del dispositivo, informazioni sul dispositivo e rilevamento delle 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)![Diagramma dell'architettura dell'Analisi dispositivo e IP di Didit che confronta l'IP, il fingerprint del dispositivo e la posizione dichiarata](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)## Come funzionaL'Analisi dispositivo e IP viene eseguita automaticamente durante la sessione di verifica e collega il contesto del dispositivo, della rete e dell'identità in un'unica superficie di rischio.**1. Acquisizione del fingerprint del dispositivo**Il client di verifica invia un payload del fingerprint v2, progettato per tutelare la privacy, contenente segnali del dispositivo web o mobile:| Dato | Descrizione | | - | - | | **ID dispositivo persistente** | Identificatore di prima parte utilizzato per il rilevamento esatto dello stesso dispositivo quando lo storage rimane disponibile. | | **Hash composito** | Hash stabile di segnali raggruppati, utilizzato per controlli deterministici dei duplicati con misure di protezione dalle collisioni. | | **Vettore di segnali** | Attributi del dispositivo e del browser/app vettorializzati per un recupero ad alta affidabilità. | | **Contesto della piattaforma** | Segnali di browser, SO, app, hardware, WebGL/canvas, media, impostazioni internazionali, fuso orario e integrità mobile, ove disponibili. |**2. Analisi dell'IP e della connessione**Didit arricchisce i dati della connessione osservata con informazioni sul rischio di rete:- Geolocalizzazione IP per paese, regione, città e coordinate - Rilevamento di VPN, proxy, Tor, data center e reti private - Controlli sull'IP atteso quando fornisci un IP consentito per la sessione - Controlli sulle blocklist IP configurate nella tua applicazione**3. Corrispondenza di duplicati e recupero**Didit verifica se la sessione corrente corrisponde a sessioni precedenti associate a un altro `vendor_data`:| Controllo | Finalità | | - | - | | **IP duplicato** | Rileva lo stesso indirizzo IP tra utenti diversi. | | **Fingerprint del dispositivo duplicato** | Rileva il riutilizzo esatto della stessa identità di dispositivo persistente. | | **Dispositivo recuperato** | Rileva un recupero ad alta affidabilità del fingerprint v2 quando l'ID persistente è cambiato. | | **Protezione dalle collisioni** | Sopprime gli hash aggregati di bassa qualità invece di unire dispositivi non correlati. |**4. Verifiche incrociate della posizione**L'Analisi dispositivo e IP confronta il contesto di posizione con punti di riferimento attendibili:- Paese del documento e coordinate dell'indirizzo - Indirizzo IP atteso per la sessione - Paese e città dell'IP - Distanza e direzione tra l'indirizzo e la posizione dell'IP**5. Azione e reportistica**Puoi configurare ogni categoria di rischio in modo indipendente e utilizzarne il risultato in tutti gli output di Didit:| Canale | Descrizione | | - | - | | **Azioni del workflow** | Approva, invia a revisione o rifiuta in caso di VPN/proxy, mancata corrispondenza della posizione, IP duplicato, dispositivo duplicato esatto e dispositivo recuperato. | | **Dashboard** | Esamina avvisi, sessioni corrispondenti, informazioni sul dispositivo e dettagli di rete nella console di Didit. | | **Webhook e API** | Ricevi avvisi e corrispondenze strutturati nei payload delle decisioni. | | **Report** | Esporta i dettagli dell'Analisi dispositivo e IP nei PDF di verifica. |## Modello di corrispondenzaL'Analisi dispositivo e IP distingue le corrispondenze esatte da quelle recuperate, permettendoti di calibrare la risposta alle frodi in totale sicurezza:| Livello | Cosa rileva | Approccio ai falsi positivi | | - | - | - | | **ID persistente esatto** | La stessa identità di dispositivo di prima parte compare nella sessione di un altro utente. | Il segnale più forte. Utilizzato per `DUPLICATED_DEVICE_FINGERPRINT`. | | **Hash composito** | Lo stesso hash deterministico del dispositivo compare nella sessione di un altro utente. | Protetto dal rilevamento delle collisioni, in modo da sopprimere i pool comuni di WebView/browser. | | **Dispositivo recuperato v2** | L'ID persistente è cambiato, ma un ricco insieme di segnali del dispositivo corrisponde a un dispositivo precedente con alta affidabilità. | Conservativo. Utilizzato per `DEVICE_RECOVERED_HIGH_CONFIDENCE` solo dopo il superamento di criteri rigorosi. | | **Riutilizzo dell'IP** | Lo stesso indirizzo IP compare tra più utenti. | Contestuale. Utile per identificare reti di frode, ma uffici condivisi, nuclei familiari e operatori mobili possono essere legittimi. |La corrispondenza per dispositivi recuperati si basa su un indice di recupero vettoriale dedicato. Se tale indice non è disponibile, Didit continua a eseguire i controlli esatti dei duplicati senza generare candidati di recupero approssimativi.In **Reti**, Didit evidenzia anche il riutilizzo di proxy residenziali quando le stesse informazioni su IP non appartenenti a data center compaiono tra più utenti o aziende distinti. Il grafo mostra il segnale di rischio aggregato, il conteggio dei soggetti, il tipo di connessione e il contesto ISP e ASN; non espone l'indirizzo IP grezzo né i dati del profilo di un'altra organizzazione.## Schemi di frode rilevatiL'Analisi dispositivo e IP aiuta a identificare e ridurre:- Gestione di più account e creazione di account duplicati - Tentativi di elusione dei controlli KYC utilizzando lo stesso dispositivo su diverse identità - Reti di frode che coordinano molti account da dispositivi o infrastrutture condivisi - Abuso di bonus, abuso di referral, abuso di promozioni e abuso di periodi di prova gratuiti - Onboarding di identità sintetiche provenienti dal riutilizzo di dispositivi - Schemi di onboarding di prestanome finanziari - Rischio di presa di controllo dell'account da dispositivi non riconosciuti o ad alto rischio - Credential stuffing e tentativi di registrazione automatizzati - Card testing, abuso di chargeback e abuso di rimborsi supportati da pattern di utilizzo ripetuto di dispositivi/reti - Elusione tramite VPN, proxy, Tor, data center e proxy residenziali - Manomissione del dispositivo, uso di emulatori, rischio di jailbreak/root e clonazione di app dove sono disponibili segnali mobili - Spoofing della posizione e discrepanze tra documento, IP, fuso orario, operatore e contesto del dispositivo - Tentativi di verifica guidati da bot tramite browser headless o client basati su script## Funzionalità chiave#### Fingerprinting e recupero dei dispositivi- **Rilevamento esatto di dispositivi duplicati**: rileva la stessa identità del dispositivo tra sessioni con valori diversi di `vendor_data`. - **Recupero ad alta affidabilità**: recupera le probabili relazioni di appartenenza allo stesso dispositivo quando le modifiche allo spazio di archiviazione o la navigazione in incognito/privata cambiano l'ID persistente. - **Protezione dalle collisioni**: evita di unire utenti non correlati quando un hash del dispositivo appare troppo comune tra molti ID persistenti distinti. - **Copertura mobile e web**: utilizza segnali del browser web e segnali mobili nativi, inclusi i campi relativi all'integrità quando disponibili.#### Informazioni su IP e rete- **Rilevamento di VPN e proxy**: identifica connessioni mascherate o anonimizzate. - **Rilevamento di Tor e data center**: contrassegna infrastrutture ad alto rischio. - **Riutilizzo di proxy residenziale**: rileva l'uso ripetuto della stessa rete apparentemente residenziale tra soggetti distinti senza esporre il valore IP grezzo nel grafo Networks. - **Blocklist di IP**: rifiuta automaticamente quando l'IP compare nella blocklist della tua applicazione. - **Applicazione dell'IP previsto**: confronta l'IP rilevato con un IP previsto fornito durante la creazione della sessione.#### Geolocalizzazione e confronto dei documenti- **Rilevamento delle discrepanze tra paesi**: confronta il paese del documento e il paese dell'IP. - **Geofencing**: accetta solo sessioni da paesi consentiti — con deroghe specifiche per stato/regione per paesi come gli Stati Uniti — in base alla geolocalizzazione dell'IP. - **Controlli della distanza dell'indirizzo**: confronta le coordinate dell'indirizzo del documento e la geolocalizzazione dell'IP. - **Contesto di corrispondenza delle sessioni**: restituisce le sessioni corrispondenti con i dettagli su dispositivo e posizione per la revisione da parte del team.## Configurare le azioniUsa le impostazioni del workflow per scegliere l'azione per ciascun rischio. I clienti più prudenti spesso impostano inizialmente `recovered_device_action` su `REVIEW`, esaminano gli avvisi relativi ai dispositivi recuperati per alcune settimane e passano a `DECLINE` solo dopo aver confermato il profilo locale dei falsi positivi.| Impostazione | Azione iniziale consigliata | Motivo | | - | - | - | | `vpn_detection_action` | `REVIEW` o `DECLINE` | Dipende dal fatto che l'uso di VPN sia consentito o meno nel tuo prodotto. | | `ip_mismatch_action` | `REVIEW` | La discrepanza di posizione è un contesto indicativo, ma può essere legittima. | | `duplicated_ip_action` | `REVIEW` | Le reti condivise possono generare falsi positivi. | | `duplicated_device_action` | `REVIEW` o `DECLINE` | Il riutilizzo esatto dello stesso dispositivo tra utenti diversi è un forte segnale di frode. | | `recovered_device_action` | `REVIEW` | Il recupero ad alta affidabilità è volutamente prudente, ma dovrebbe essere monitorato prima di applicare il rifiuto automatico. | | `ip_geofencing_action` | `DECLINE` | Il geofencing di solito esprime una regola giurisdizionale rigida; usa `REVIEW` se preferisci una gestione manuale delle località soggette a restrizioni. |Consulta gli [avvisi di Analisi dispositivo e IP](https://docs.didit.me/it/core-technology/ip-analysis/warnings-ip-analysis.md) per tutti i tag di rischio e le [configurazioni delle funzionalità del workflow](https://docs.didit.me/it/management-api/workflows/feature-configs.md#analisi-dispositivo-e-ip) per i campi delle API. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.