> ## 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. # Relatório de dispositivo e IP: campos e correspondências > Relatório de dispositivo e IP da Didit: geolocalização, fingerprint, flags de VPN/Tor/proxy, distância documento-IP e dispositivos duplicados. ## Visão geral A Análise de dispositivo e IP traça o perfil de cada sessão com base na geolocalização do IP, impressão digital do dispositivo, navegador/sistema operacional e tipo de rede. A geolocalização, o enriquecimento de risco de rede, a correspondência de dispositivos e as verificações remotas de integridade do dispositivo são executados de forma assíncrona enquanto o usuário conclui a verificação. As observações de dispositivo e IP continuam disponíveis enquanto a análise está pendente; os campos de geolocalização podem ficar vazios até que os resultados cheguem ou quando o endereço não é público. Se o seu fluxo de verificação (workflow) usa essas verificações para determinar o resultado ou escolher uma etapa seguinte, a sessão permanece `In Progress` até que os resultados necessários estejam disponíveis. Se a análise necessária continuar indisponível após um número limitado de novas tentativas, a sessão passa para `In Review` para uma decisão manual. Falhas de enriquecimento opcional não impedem a conclusão, e as decisões manuais continuam prevalecendo. Ela produz: * Um bloco de **geolocalização de IP** (país, estado, cidade, latitude/longitude, fuso horário) derivado do IP público. * **Sinalizadores de risco de rede**, `is_vpn_or_tor` e `is_data_center`, para detectar tentativas de mascaramento (VPN, nós de saída do Tor, provedores de hospedagem, anonimizadores). * **Cálculos de distância entre documentos**: a distância em linha reta, em km, entre a localização do IP, a localização do documento de identidade e a localização do comprovante de endereço. * **Correspondências entre sessões**: quando o mesmo endereço IP ou a mesma identidade de dispositivo aparece em sessões pertencentes a usuários diferentes (agrupados por `vendor_data`). * **Recuperação da impressão digital do dispositivo**: um sinal de recuperação de alta confiança que vincula sessões mesmo depois que o usuário limpa o armazenamento, alterna entre modos anônimos ou reinstala o app. ![Captura de tela do relatório de Análise de dispositivo e IP da Didit com geolocalização, impressão digital do dispositivo e sinalizadores de risco](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis-report.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=5d4877664a7c89384ee32d4a5cb6949b) ## Onde aparece nas respostas da API O endpoint de decisão retorna a análise de dispositivo e IP como o array plural **`ip_analyses[]`** em `GET /v3/session/{sessionId}/decision/`. As entradas são observações `Location` sem duplicatas, identificadas por (`node_id`, `ip_address`, `device_fingerprint`). Um único nó pode gerar várias entradas quando o IP ou o dispositivo do usuário muda no meio da sessão. ```text theme={null} GET /v3/session/{sessionId}/decision/ ──▶ { "ip_analyses": [ { status, node_id, ip_address, ip, id_document, poa_document, warnings, matches, … }, … ] } ``` A estrutura abaixo reflete o schema canônico. Consulte [Modelos de dados](https://docs.didit.me/pt-br/reference/data-models.md#análise-de-ip). ## Schema Consulte [Análise de dispositivo e IP na referência de Modelos de dados](https://docs.didit.me/pt-br/reference/data-models.md#análise-de-ip) para ver o schema canônico. ```typescript theme={null} 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' } ``` ### Semântica das correspondências `match_source` indica como a correspondência foi obtida, e `confidence` pontua a probabilidade de ela estar *errada* (`confidence = 1 - P(false positive)`): | `match_source` | Significado | `confidence` | `match_mode` | | - | - | - | - | | `ip_address` | IP compartilhado: colocalização na rede, nunca uma afirmação sobre a identidade do dispositivo. | `0.0` | `co_occurrence` | | `persistent_id` | Identificador persistente exato do dispositivo armazenado. | `1.0` | `deterministic` | | `legacy_fp` | Hash legado `didit-fp-*` da impressão digital do dispositivo. | `0.5` | `probabilistic` | | `recovered_high` | Correspondência de recuperação aproximada da impressão digital, com alta confiança, após verificações obrigatórias rigorosas. | `1.0` quando vinculado ao hardware; caso contrário, `< 1.0`, elevado quando o TLS JA4 e o país do IP concordam de forma independente | `deterministic` ou `probabilistic` | Candidatos de recuperação com confiança mais baixa aparecem apenas como avisos de risco, nunca em `matches[]`. As correspondências de IP e as correspondências de dispositivo são limitadas a 5 cada, então o array contém no máximo 10 entradas. ## Valores de status Os status são valores `FeatureStatusChoices` no nível do recurso. Cada aviso disparado é mapeado para a ação configurada para ele no nó do fluxo; a ação mais forte prevalece. | Valor | Significado | | - | - | | `Not Finished` | O nó de análise de IP não foi concluído para esta sessão (padrão). | | `Approved` | Nenhum aviso foi disparado, ou todos os avisos disparados estão configurados como Nenhuma ação. | | `In Review` | Pelo menos um aviso disparado está configurado como Revisão (consulte [avisos](https://docs.didit.me/pt-br/core-technology/ip-analysis/warnings-ip-analysis.md)). | | `Declined` | Um aviso de lista de bloqueio foi disparado (`IP_ADDRESS_IN_BLOCKLIST` ou `DEVICE_FINGERPRINT_IN_BLOCKLIST`, que sempre resulta em recusa), ou um aviso configurável está definido como Recusar no seu fluxo. | | `Resub Requested` | Um revisor solicitou o reenvio desta etapa. | Regras de status personalizadas configuradas no nó de análise de IP podem ajustar ainda mais o status resultante. ## Detecção de VPN, proxy e Tor `is_vpn_or_tor` e `is_data_center` são sinalizadores booleanos independentes retornados para cada sessão. Quando `is_vpn_or_tor` é `true`, a Didit também emite o aviso `PRIVATE_NETWORK_DETECTED` para que sua equipe possa agir com base nele por meio da configuração do fluxo de trabalho. Tráfego apenas de data center (sem VPN/Tor) define `is_data_center=true`, mas não gera aviso automático. Use-o como um sinal adicional na sua própria pontuação. ## Exemplos ### Aprovado ```json theme={null} { "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": [] } ] } ``` ### Recusado: IP presente na lista de bloqueio + VPN + dispositivo duplicado ```json theme={null} { "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" } ] } ] } ``` ## Conteúdos relacionados * [Avisos da Análise de dispositivo e IP](https://docs.didit.me/pt-br/core-technology/ip-analysis/warnings-ip-analysis.md): todos os códigos de aviso que a análise de IP pode emitir * [Visão geral da Análise de dispositivo e IP](https://docs.didit.me/pt-br/core-technology/ip-analysis/overview.md): o que cada bloco mede * [Modelos de dados: análise de IP](https://docs.didit.me/pt-br/reference/data-models.md#análise-de-ip): schema canônico * [Webhooks](https://docs.didit.me/pt-br/integration/webhooks.md): `status.updated` traz o mesmo payload da análise de IP This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.