Advertències de verificació d'ubicació i codis LOCATION_

Visió general

Les advertències de l’informe d’ubicació assenyalen cada condició que Didit ha detectat en un pas de verificació d’ubicació. Apareixen a la matriu warnings[] de cada element de geolocation_checks[] (consulta l’informe d’ubicació). Cada advertència té tres capes:

El codi risk: un identificador estable amb què pots fer la correspondència; tots comencen per LOCATION_.
El log_type: information, warning o error. Per als riscos configurables, segueix l’acció configurada: NO_ACTION dona information, REVIEW dona warning i DECLINE dona error.
L’impacte en la decisió: l’acció més estricta d’entre les advertències estableix el status del pas. REVIEW dona In Review, DECLINE dona Declined i NO_ACTION el deixa intacte.

La incertesa i el rebuig tenen per defecte el valor REVIEW, mai DECLINE: un permís denegat, una posició en interiors o un radi ampli no són proves de frau. Les advertències sobre precisió, actualitat, àrees, distància i anonimitzadors només es generen en l’últim intent, de manera que una persona que se’n surt satisfactòriament al segon intent no arrossega cap advertència. Les regles de status_rules personalitzades al node poden mantenir o augmentar l’estat, però mai reduir-lo.

Condicions de rebuig automàtic

Aquestes condicions sempre rebutgen el pas, amb log_type: "error", i no tenen clau d’acció.

Risk	Activador
`LOCATION_REPLAY_DETECTED`	L’enviament contenia un desafiament que pertany a una altra sessió. Cada intent rep un desafiament d’un sol ús vinculat a la seva sessió, de manera que presentar-lo en un altre lloc constitueix una repetició.
`LOCATION_INTEGRITY_FAILED`	Una atestació del dispositiu acompanyava la posició i no ha superat la verificació.

Advertències generades

Els valors per defecte són les accions d’un pas sense geolocation_preset. Sota licensing, LOCATION_VPN_DETECTED, LOCATION_TOR_DETECTED i LOCATION_EMULATOR_DETECTED tenen per defecte DECLINE, i LOCATION_PROXY_DETECTED té REVIEW. Sota fraud_screening, cada valor per defecte que és DECLINE passa a ser REVIEW, i aquestes quatre troballes d’anonimitzadors passen a ser REVIEW. Una acció que defineixis explícitament sempre preval.

Permisos i disponibilitat

Risc	Activador	Clau de configuració	Per defecte
`LOCATION_PERMISSION_DENIED`	La persona ha rebutjat o descartat l’avís d’ubicació en tots els intents permesos. És una elecció, no una prova de frau.	`geolocation_permission_denied_action`	`REVIEW`
`LOCATION_RESTRICTED`	El sistema operatiu ha refusat abans que la persona pogués respondre: els serveis d’ubicació estan desactivats a tot el dispositiu, o bé una política de gestió de dispositius o de control parental els bloqueja.	`geolocation_unavailable_action`	`REVIEW`
`LOCATION_UNAVAILABLE`	El dispositiu ha acceptat la sol·licitud, però el seu sistema de posicionament no ha retornat cap posició en cap intent permès. Habitual en interiors i sota terra.	`geolocation_unavailable_action`	`REVIEW`
`LOCATION_TIMEOUT`	No s’ha rebut cap posició dins de `geolocation_timeout_seconds` en cap intent permès.	`geolocation_unavailable_action`	`REVIEW`
`LOCATION_SKIPPED`	El flux de treball permet ometre el pas i la persona ha continuat sense compartir la ubicació.	`geolocation_unavailable_action`	`REVIEW`
`LOCATION_UNSUPPORTED_CLIENT`	La sessió ha arribat a una versió de l’aplicació o de l’SDK que no implementa el pas. Didit ha tancat el pas en lloc de deixar la sessió aturada. Actualitza l’SDK.	`geolocation_unavailable_action`	`REVIEW`

Precisió i actualitat

Risc	Activador	Clau de configuració	Per defecte
`LOCATION_LOW_ACCURACY`	La millor posició tenia un radi més ampli que `geolocation_max_accuracy_radius_m`. Una mesura de confiança, no d’honestedat.	`geolocation_low_accuracy_action`	`REVIEW`
`LOCATION_ACCURACY_UNDETERMINED`	La posició no contenia cap radi en cap intent permès, de manera que res indica que compleixi el límit. Mai no es considera que compleixi el límit.	`geolocation_low_accuracy_action`	`REVIEW`
`LOCATION_STALE_FIX`	Feia més de `geolocation_max_age_seconds` que s’havia mesurat la posició quan Didit la va rebre.	`geolocation_stale_fix_action`	`REVIEW`
`LOCATION_APPROXIMATE_ONLY`	Es requeria una ubicació precisa i la persona n’ha concedit una d’aproximada (precisió reduïda a iOS, «Aproximada» a Android). Mai no es genera al web, que no ho pot distingir.	`geolocation_approximate_action`	`REVIEW`
`LOCATION_CLOCK_SKEW`	El dispositiu indicava que havia mesurat la posició en el futur en comparació amb el rellotge de Didit. Només informatiu: l’antiguitat es calcula a partir de l’hora de recepció de Didit.	cap	informació

Suplantació i integritat

Risc	Activador	Clau de configuració	Per defecte
`LOCATION_MOCK_PROVIDER_DETECTED`	Android ha informat que la posició provenia d’un proveïdor d’ubicacions simulades. Les eines de prova i d’accessibilitat també ho defineixen, per la qual cosa l’acció és configurable.	`geolocation_mock_location_action`	`REVIEW`
`LOCATION_SIMULATED_BY_SOFTWARE`	iOS ha informat que la posició s’havia simulat per programari.	`geolocation_mock_location_action`	`REVIEW`
`LOCATION_INTEGRITY_MISSING`	Una aplicació nativa ha enviat una posició sense atestació del dispositiu. El web es registra com a no compatible, no com a absent.	`geolocation_integrity_missing_action`	`NO_ACTION`
`LOCATION_EMULATOR_DETECTED`	L’aplicació ha informat que s’executa en un emulador o màquina virtual. Els navegadors no ho poden informar. Llevat que l’acció sigui `NO_ACTION`, finalitza el pas en aquest intent.	`geolocation_emulator_action`	`NO_ACTION`
`LOCATION_VPN_DETECTED`	La connexió que ha compartit la ubicació surt a través d’una VPN comercial. Llevat que l’acció sigui `NO_ACTION`, es demana a la persona que la desactivi i torni a comprovar-ho.	`geolocation_vpn_action`	`NO_ACTION`
`LOCATION_PROXY_DETECTED`	La connexió passa a través d’un proxy obert, anònim o de retransmissió privada.	`geolocation_proxy_action`	`NO_ACTION`
`LOCATION_TOR_DETECTED`	La connexió és un node de sortida de Tor.	`geolocation_tor_action`	`NO_ACTION`

Àrees

Risc	Activador	Clau de configuració	Per defecte
`LOCATION_OUTSIDE_GEOFENCE`	La posició i tot el seu cercle de precisió es troben fora de qualsevol àrea permesa.	`geolocation_geofencing_action`	`DECLINE`
`LOCATION_GEOFENCE_UNDETERMINED`	El cercle de precisió arriba a un límit que determina la resposta, o la posició no es resol en cap país. La incertesa mai no s’informa com a fora.	`geolocation_geofence_undetermined_action`	`REVIEW`
`LOCATION_IN_BLOCKED_AREA`	La posició i tot el seu cercle de precisió es troben dins d’una àrea bloquejada. S’afegeix al veredicte d’àrea permesa, mai en lloc d’aquest, i l’acció més estricta decideix.	`geolocation_blocked_area_action`	`DECLINE`

Distància i historial

Risc	Activador	Clau de configuració	Per defecte
`LOCATION_IP_DISTANCE_MISMATCH`	La posició del dispositiu i la ubicació de la IP estan més separades que `geolocation_ip_distance_km`, després de restar ambdós radis. Una VPN, un proxy corporatiu o la sortida central d’un operador ho poden provocar legítimament.	`geolocation_ip_distance_action`	`REVIEW`
`LOCATION_DOCUMENT_DISTANCE_MISMATCH`	La posició es troba a una distància superior a `geolocation_document_distance_km` de l’adreça del document. Un senyal feble, perquè les adreces es geocodifiquen de manera aproximada i les persones viatgen.	`geolocation_document_distance_action`	`REVIEW`
`LOCATION_CONSECUTIVE_MISMATCHES`	Aquesta comprovació i les comprovacions anteriors de la mateixa persona (mateix `vendor_data`) han quedat fora d’una àrea permesa, dins d’una àrea bloquejada o massa lluny de l’adreça almenys `geolocation_consecutive_mismatch_count` vegades consecutives.	`geolocation_consecutive_mismatch_action`	`REVIEW`

Què veu la persona

Algunes troballes no s’expliquen mai a la persona, perquè donar el nom del senyal indica a un defraudador què ha de canviar. LOCATION_EMULATOR_DETECTED, LOCATION_MOCK_PROVIDER_DETECTED, LOCATION_SIMULATED_BY_SOFTWARE, LOCATION_REPLAY_DETECTED, LOCATION_INTEGRITY_FAILED i LOCATION_IP_DISTANCE_MISMATCH formen part d’aquest grup: si un revisor retorna la verificació, la persona veu un motiu genèric, mentre que el payload de decisió i els teus webhooks conserven l’advertència completa. Una VPN només es mostra a la persona com una sol·licitud per desactivar qualsevol VPN i tornar-ho a provar, i una zona bloquejada només es mostra com la llista de llocs on el servei està disponible.

Exemple

{
  "risk": "LOCATION_LOW_ACCURACY",
  "log_type": "warning",
  "short_description": "Device location accuracy below the configured limit",
  "additional_data": {
    "accuracy_m": 1200.0,
    "accuracy_confidence": "p95",
    "max_accuracy_radius_m": 250
  },
  "node_id": "geolocation_1"
}

Tipus d’advertència

A cada risc se li assigna una gravetat basada en la configuració de la teva aplicació. Les tres gravetats són:

Relacionat

Informe de verificació d’ubicació - els camps al costat de warnings[].
Verificació d’ubicació - com funciona el pas.
Configuracions de funcionalitats del flux de treball - cada clau d’acció.
Models de dades - Objecte d’advertència - l’estructura de cada entrada a warnings[].

Autenticació

Verificació

Monitoratge

Plataforma

Advertències de verificació d'ubicació i codis LOCATION_

Visió general

Condicions de rebuig automàtic

Advertències generades

Permisos i disponibilitat

Precisió i actualitat

Suplantació i integritat

Àrees

Distància i historial

Què veu la persona

Exemple

Tipus d’advertència

Relacionat

​Visió general

​Condicions de rebuig automàtic

​Advertències generades

​Permisos i disponibilitat

​Precisió i actualitat

​Suplantació i integritat

​Àrees

​Distància i historial

​Què veu la persona

​Exemple

​Tipus d’advertència

​Relacionat

Visió general

Condicions de rebuig automàtic

Advertències generades

Permisos i disponibilitat

Precisió i actualitat

Suplantació i integritat

Àrees

Distància i historial

Què veu la persona

Exemple

Tipus d’advertència

Relacionat