> ## 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 IP: campos e correspondências > Analise o relatório de análise de dispositivo e IP da Didit: geolocalização, fingerprint do dispositivo, VPN/proxy e dispositivos duplicados. ## Visão geral A análise de dispositivo e IP traça o perfil de cada sessão através de geolocalização por IP, fingerprint do dispositivo, navegador/SO e tipo de rede. A geolocalização, o enriquecimento de risco de rede, a correspondência de dispositivos e as verificações de integridade remota do dispositivo são executados de forma assíncrona enquanto o utilizador conclui a verificação. As observações de dispositivo e IP permanecem disponíveis enquanto a análise está pendente; os campos de geolocalização podem estar vazios até que os resultados cheguem ou quando o endereço não for público. Se o seu fluxo de verificação utilizar estas verificações para determinar o resultado ou escolher um passo subsequente, a sessão permanece em `In Progress` até que os resultados necessários estejam disponíveis. Se a análise obrigatória continuar indisponível após um número limitado de tentativas, a sessão transita para `In Review` para uma decisão manual. Falhas no enriquecimento opcional não impedem a conclusão, e as decisões manuais continuam a prevalecer. Produz: * Um bloco de **geolocalização por 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 detetar tentativas de dissimulação (VPN, nós de saída Tor, fornecedores de alojamento, anonimizadores). * **Cálculos de distância entre documentos** — distância em linha reta (em km) entre a localização do IP, a localização do documento de identificação e a localização do comprovativo de morada. * **Correspondências entre sessões** — quando o mesmo endereço IP ou identidade de dispositivo surge em sessões pertencentes a utilizadores diferentes (agrupadas por `vendor_data`). * **Recuperação de fingerprint do dispositivo** — um sinal de recuperação de alta confiança que associa sessões mesmo após o utilizador limpar o armazenamento local, alternar para o modo de navegação anónima ou reinstalar a aplicação. ![Captura de ecrã do relatório de Análise de dispositivo e IP da Didit com geolocalização, fingerprint 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 surge nas respostas da API O endpoint de decisão devolve 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` deduplicadas indexadas por (`node_id`, `ip_address`, `device_fingerprint`) — um único nó pode produzir múltiplas entradas quando o IP ou o dispositivo do utilizador é alterado a 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 esquema canónico — consulte [Modelos de dados](https://docs.didit.me/pt/reference/data-models.md#análise-de-ip). ## Esquema Consulte [Análise de dispositivo e IP na referência dos Modelos de dados](https://docs.didit.me/pt/reference/data-models.md#análise-de-ip) para ver o esquema 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 de correspondência O campo `match_source` indica como a correspondência foi obtida, e `confidence` pontua a probabilidade de esta estar *errada* (`confidence = 1 - P(false positive)`): | `match_source` | Significado | `confidence` | `match_mode` | | - | - | - | - | | `ip_address` | IP partilhado — colocalização de rede, nunca uma afirmação de identidade de dispositivo. | `0.0` | `co_occurrence` | | `persistent_id` | Identificador persistente de dispositivo exato e armazenado. | `1.0` | `deterministic` | | `legacy_fp` | Hash de fingerprint de dispositivo legado `didit-fp-*`. | `0.5` | `probabilistic` | | `recovered_high` | Correspondência de recuperação difusa de fingerprint de alta confiança após ultrapassar critérios rigorosos de bloqueio. | `1.0` quando baseada em hardware, caso contrário `< 1.0`, reforçada quando o TLS JA4 e o país do IP coincidem de forma independente | `deterministic` ou `probabilistic` | Os candidatos à recuperação com menor confiança surgem apenas como avisos de risco — nunca em `matches[]`. As correspondências de IP e de dispositivo estão limitadas a 5 cada, pelo que o array contém, no máximo, 10 entradas. ## Valores de estado Os estados são valores `FeatureStatusChoices` ao nível da funcionalidade. Cada aviso disparado mapeia 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 (predefinição). | | `Approved` | Nenhum aviso disparado, ou todos os avisos disparados estão configurados para Sem ação. | | `In Review` | Pelo menos um aviso disparado está configurado para Revisão (consulte [avisos](https://docs.didit.me/pt/core-technology/ip-analysis/warnings-ip-analysis.md)). | | `Declined` | Um aviso de lista de bloqueio disparou (`IP_ADDRESS_IN_BLOCKLIST` ou `DEVICE_FINGERPRINT_IN_BLOCKLIST` — implica sempre recusa), ou um aviso configurável está definido como Recusar para o seu fluxo. | | `Resub Requested` | Um revisor solicitou o reenvio deste passo. | Regras de estado personalizadas configuradas no nó de análise de IP podem ajustar ainda mais o estado resultante. ## Deteção de VPN, proxy e Tor `is_vpn_or_tor` e `is_data_center` são sinalizadores booleanos independentes devolvidos para cada sessão. Quando `is_vpn_or_tor` é `true`, a Didit também emite o aviso `PRIVATE_NETWORK_DETECTED` para que a sua equipa possa agir com base nele através da configuração do fluxo. O tráfego exclusivo de datacenter (sem VPN/Tor) define `is_data_center=true`, mas não emite um aviso automático — utilize isto como um sinal adicional na sua própria pontuação. ## Exemplos ### Aprovada ```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": [] } ] } ``` ### Recusada — Correspondência na lista de bloqueio de IP + 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" } ] } ] } ``` ## Relacionado * [Avisos de análise de dispositivo e IP](https://docs.didit.me/pt/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/core-technology/ip-analysis/overview.md) — o que cada bloco mede * [Modelos de dados — Análise de IP](https://docs.didit.me/pt/reference/data-models.md#análise-de-ip) — esquema canónico * [Webhooks](https://docs.didit.me/pt/integration/webhooks.md) — `status.updated` transmite o mesmo payload de análise de IP This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.