> ## 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. # Análise de dispositivo e risco de IP para KYC > A Didit deteta dispositivos duplicados, redes de fraude, VPNs, proxies, Tor, localizações incoerentes e impressões digitais suspeitas na verificação KYC. A Análise de dispositivo e IP da Didit combina impressão digital de dispositivos, recuperação de dispositivos duplicados, inteligência de IP e verificações de geolocalização no fluxo de verificação. Ajuda a detetar quando o mesmo dispositivo físico tenta aceder a várias contas, mesmo quando o utilizador muda de sessão, limpa o armazenamento do navegador, abre uma janela de navegação privada ou alterna as informações de rede. Prompt de integração da Análise de dispositivo e IP Copiar o prompt para a área de transferência \

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

\
Colar em Esta funcionalidade foi concebida para decisões de prevenção de fraude onde os falsos positivos têm um custo elevado. As correspondências exatas de dispositivos duplicados utilizam identificadores persistentes e estáveis. As correspondências de dispositivos recuperados utilizam o vetor de sinais de impressão digital v2 e critérios de validação de alta confiança, permitindo que a Didit identifique reutilizações suspeitas sem associar utilizadores não relacionados de forma demasiado agressiva.Na aula da Academy sobre como interpretar um resultado de verificação, o capítulo aos 9:49 analisa os sinais da análise de dispositivo e IP.[Análise de dispositivo e IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Visão geral da Análise de dispositivo e IP da Didit mostrando geolocalização, impressão digital de dispositivos, inteligência de dispositivos e deteção 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)![Diagrama de arquitetura da Análise de dispositivo e IP da Didit cruzando IP, impressão digital de dispositivo e localização declarada](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)## Como funcionaA Análise de dispositivo e IP é executada automaticamente durante a sessão de verificação e associa o contexto do dispositivo, da rede e da identidade numa única superfície de risco.**1. Captura da impressão digital do dispositivo**O cliente de verificação envia um payload de impressão digital v2 que preserva a privacidade com sinais do dispositivo web ou móvel:| Ponto de dados | Descrição | | - | - | | **ID de dispositivo persistente** | Identificador próprio utilizado para a deteção exata do mesmo dispositivo quando o armazenamento persiste. | | **Hash composto** | Hash estável de sinais agrupados utilizado para verificações determinísticas de duplicados com proteções contra colisões. | | **Vetor de sinais** | Atributos do dispositivo e do navegador/aplicação vetorizados para recuperação com elevada confiança. | | **Contexto da plataforma** | Navegador, SO, aplicação, hardware, WebGL/canvas, multimédia, idioma/região (locale), fuso horário e sinais de integridade móvel, quando disponíveis. |**2. Análise de IP e de ligação**A Didit enriquece os dados de ligação observados com informações de risco de rede:- Geolocalização de IP por país, região, cidade e coordenadas - Deteção de VPN, proxy, Tor, centro de dados e redes privadas - Verificações de IP esperado quando fornece um IP permitido para a sessão - Verificações de lista de bloqueio de IP configuradas na sua aplicação**3. Correspondência de duplicados e recuperação**A Didit verifica se a sessão atual corresponde a sessões anteriores de outro `vendor_data`:| Verificação | Finalidade | | - | - | | **IP duplicado** | Deteta o mesmo endereço IP em diferentes utilizadores. | | **Impressão digital de dispositivo duplicada** | Deteta a reutilização exata da mesma identidade persistente do dispositivo. | | **Dispositivo recuperado** | Deteta uma recuperação de impressão digital v2 com elevada confiança quando o ID persistente foi alterado. | | **Proteção contra colisões** | Suprime hashes partilhados de baixa qualidade em vez de fundir dispositivos não relacionados. |**4. Cruzamento de localizações**A Análise de dispositivo e IP compara o contexto de localização com pontos de referência fidedignos:- País do documento e coordenadas da morada - Endereço IP esperado da sessão - País e cidade do IP - Distância e direção entre a morada e a localização do IP**5. Ação e relatórios**Pode configurar cada categoria de risco de forma independente e consumir o resultado em todas as saídas da Didit:| Canal | Descrição | | - | - | | **Ações do fluxo** | Aprovar, rever ou recusar em caso de VPN/proxy, divergência de localização, IP duplicado, duplicação exata de dispositivo e dispositivo recuperado. | | **Painel** | Analise avisos, sessões correspondentes, informações do dispositivo e detalhes de rede na consola da Didit. | | **Webhooks e APIs** | Receba avisos estruturados e correspondências em payloads de decisão. | | **Relatórios** | Exporte detalhes da Análise de dispositivo e IP em ficheiros PDF de verificação. |## Modelo de correspondênciaA Análise de dispositivo e IP separa as correspondências exatas das correspondências recuperadas para que possa ajustar a resposta à fraude com segurança:| Camada | O que deteta | Postura em relação a falsos positivos | | - | - | - | | **ID persistente exato** | A mesma identidade de dispositivo própria surge na sessão de outro utilizador. | Sinal mais forte. Utilizado para `DUPLICATED_DEVICE_FINGERPRINT`. | | **Hash composto** | O mesmo hash de dispositivo determinístico surge na sessão de outro utilizador. | Protegido por deteção de colisões para suprimir pools comuns de WebViews/navegadores. | | **Dispositivo recuperado v2** | O ID persistente foi alterado, mas sinais abrangentes do dispositivo correspondem a um dispositivo anterior com elevada confiança. | Conservadora. Utilizado para `DEVICE_RECOVERED_HIGH_CONFIDENCE` apenas após o cumprimento de critérios rigorosos. | | **Reutilização de IP** | O mesmo endereço IP surge em vários utilizadores. | Contextual. Útil para redes de fraude, mas escritórios partilhados, residências e operadoras móveis podem ser legítimos. |A correspondência de dispositivos recuperados utiliza um índice dedicado de recuperação vetorial. Se esse índice não estiver disponível, a Didit continua a realizar verificações de duplicados exatos e não emite candidatos de recuperação aproximada.Em **Redes**, a Didit também destaca a reutilização de proxies residenciais quando a mesma informação de inteligência de IP relativa a endereços que não pertencem a centros de dados surge em múltiplos utilizadores ou empresas distintas. O grafo mostra o sinal de risco agregado, o número de entidades, o tipo de ligação e o contexto de ISP e ASN; não expõe o endereço IP original nem dados de perfil de outra organização.## Padrões de fraude detetadosA Análise de dispositivo e IP ajuda a identificar e a reduzir:- Criação de contas múltiplas e de contas duplicadas - Tentativas de contorno de KYC utilizando o mesmo dispositivo em diferentes identidades - Redes de fraude que coordenam várias contas a partir de dispositivos ou infraestruturas partilhados - Abuso de bónus, abuso de referências, abuso de promoções e abuso de períodos de teste gratuitos - Onboarding de identidades sintéticas a partir de dispositivos repetidos - Padrões de onboarding de mulas de dinheiro - Risco de usurpação de contas a partir de dispositivos desconhecidos ou de alto risco - Ataques de preenchimento de credenciais e tentativas automatizadas de registo - Testes de cartões, abuso de estornos e abuso de reembolsos sustentados por padrões repetidos de dispositivo/rede - Evasão através de VPN, proxy, Tor, centros de dados e proxies residenciais - Adulteração de dispositivos, utilização de emuladores, risco de jailbreak/root e clonagem de aplicações quando estão disponíveis sinais móveis - Spoofing de localização e discrepâncias entre documento, IP, fuso horário, operadora e contexto do dispositivo - Tentativas de verificação executadas por bots com recurso a navegadores sem interface gráfica ou clientes com scripts## Principais capacidades#### Impressão digital e recuperação de dispositivos- **Deteção exata de dispositivos duplicados**: Detete a mesma identidade de dispositivo entre sessões com valores distintos de `vendor_data`. - **Recuperação de alta confiança**: Recupere relações prováveis do mesmo dispositivo quando alterações de armazenamento ou a navegação anónima/privada alteram o ID persistente. - **Proteção contra colisões**: Evite fundir utilizadores não relacionados quando um hash de dispositivo parece demasiado comum em vários IDs persistentes distintos. - **Cobertura móvel e web**: Utilize sinais do navegador web e sinais móveis nativos, incluindo campos relacionados com integridade quando disponíveis.#### Informações de IP e de rede- **Deteção de VPN e proxy**: Identifique ligações mascaradas ou anonimizadas. - **Deteção de Tor e centros de dados**: Sinalize infraestruturas de alto risco. - **Reutilização de proxy residencial**: Detete a utilização repetida da mesma rede com aparência residencial em sujeitos distintos sem expor o valor de IP em bruto no grafo de Redes. - **Listas de bloqueio de IP**: Recuse automaticamente quando o IP constar na lista de bloqueio da sua aplicação. - **Aplicação de IP esperado**: Compare o IP observado com um IP esperado fornecido durante a criação da sessão.#### Geolocalização e comparação de documentos- **Deteção de discrepância de país**: Compare o país do documento e o país do IP. - **Geofencing**: Aceite apenas sessões de países permitidos — com substituições por estado/região para países como os Estados Unidos — com base na geolocalização do IP. - **Verificações de distância de morada**: Compare as coordenadas da morada do documento com a geolocalização do IP. - **Contexto de correspondência de sessões**: Devolva sessões correspondentes com detalhes de dispositivo e localização para revisão por parte da equipa.## Configurar açõesUtilize as definições do fluxo para escolher a ação para cada risco. Os clientes mais conservadores costumam definir primeiro `recovered_device_action` como `REVIEW`, analisar os avisos de dispositivos recuperados durante algumas semanas e só mudar para `DECLINE` após confirmarem o perfil local de falsos positivos.| Definição | Ação inicial recomendada | Motivo | | - | - | - | | `vpn_detection_action` | `REVIEW` ou `DECLINE` | Depende de a utilização de VPN ser permitida no seu produto. | | `ip_mismatch_action` | `REVIEW` | Uma discrepância de localização é um forte sinal contextual, mas pode ser legítima. | | `duplicated_ip_action` | `REVIEW` | Redes partilhadas podem gerar falsos positivos. | | `duplicated_device_action` | `REVIEW` ou `DECLINE` | A reutilização exata do mesmo dispositivo entre utilizadores é um forte sinal de fraude. | | `recovered_device_action` | `REVIEW` | A recuperação de alta confiança é intencionalmente conservadora, mas deve ser monitorizada antes da recusa automática. | | `ip_geofencing_action` | `DECLINE` | O geofencing geralmente expressa uma regra jurisdicional estrita; utilize `REVIEW` se preferir a triagem manual de localizações restritas. |Consulte os [avisos de Análise de dispositivo e IP](https://docs.didit.me/pt/core-technology/ip-analysis/warnings-ip-analysis.md) para ver todas as etiquetas de risco e as [Configurações de funcionalidades do fluxo](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#análise-de-dispositivo-e-ip) para os campos da API. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.