01 · Device intelligence para la prevención de fraude Los recorridos que usted etiqueta
Una etiqueta por cada pantalla que usted elija
Un script en su sitio lee el navegador y el dispositivo en cerca de una décima de segundo en escritorio. Una llamada firmada desde su backend, con una etiqueta que usted nombra, obtiene la respuesta al instante: una puntuación de confianza, la cobertura de evidencia y 13 indicadores, desde bots y automatización, navegadores falsificados y emuladores hasta VPN, proxy y Tor, con el motivo de cada recomendación. Detecte robo de cuentas (account takeover), registros falsos y fraude en retiros con evidencia, no con suposiciones. Nosotros recomendamos. Usted decide y actúa.
Respuesta síncrona en cualquier pantalla que etiquete · Modo sombra antes de influir en cualquier decisión · Sus reglas, sus listas, su decisión
Cómo leer esta respuesta · ejemplo v1.1/login_completed
Por qué esta recomendación
ALLOW
Ningún indicador que la política pondera volvió como detectado. Ejemplo del contrato: la política gestionada de FingerTrackID recomienda MONITOR con cualquier puntuación; ALLOW viene de una franja de puntuación que su empresa definió en sus propias reglas de riesgo. Decidido con policy-login-v1.
Qué es la puntuación, y qué no es
trust_score 100
Confianza en este acceso con esta versión de política, no una probabilidad de fraude. Fuera de COMPLETED es null, nunca un valor por defecto.
Cuánto se pudo ver
evidence_coverage 100
La proporción de las verificaciones esperadas que se ejecutaron. Si faltara evidencia, se nombraría aquí: reduce la cobertura y nunca es un motivo de riesgo.
Después, es suyo
customer_action
Su backend decide y actúa; después informa lo que hizo y el resultado real. Nunca bloqueamos ni retenemos dinero.
POST /v1/assessments → 201
event-assessment.v1.1 · ejemplo del contrato
{ "schema_version": "event-assessment.v1.1", "tag": "login", "assessment_status": "COMPLETED", "trust_score": 100, "device_match_confidence": 0.98, "evidence_coverage": 100, "signals": [ … 13 objects ], "limitation_codes": [], "reason_codes": ["NO_ADVERSE_INDICATOR_MATCH"], "recommended_action": "ALLOW", "recommendation_basis": "EVALUATION", "policy_version": "policy-login-v1" // … 21 more fields in the full response: ids, snapshot, versions, timestamps}
1{2 "schema_version": "event-assessment.v1.1",3 "assessment_id": "01996f2a-0000-7000-8000-000000000101",4 "assessment_version": 1,5 "supersedes_assessment_id": null,6 "business_event_id": "01996f2a-0000-7000-8000-000000000102",7 "external_event_id": "login_20260904_000001",8 "tag": "login",9 "assessment_status": "COMPLETED",10 "retryable": false,11 "trust_score": 100,12 "device_intelligence_snapshot_id": "01996f2a-0000-7000-8000-000000000103",13 "device_intelligence_snapshot_version": 1,14 "device_id": "dev_0123456789abcdefghij",15 "device_match_confidence": 0.98,16 "evidence_coverage": 100,17 "data_freshness": {18 "evidence_cutoff_at": "2026-09-04T12:00:00Z",19 "oldest_required_observed_at": "2026-09-04T11:59:59Z",20 "maximum_required_age_ms": 300000,21 "all_required_fresh": true22 },23 "signals": [24 { "signal_code": "ANTI_FINGERPRINTING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },25 { "signal_code": "BOT_AUTOMATION", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },26 { "signal_code": "BROWSER_SPOOFING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },27 { "signal_code": "EMULATED_ENVIRONMENT", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },28 { "signal_code": "PRIVATE_BROWSING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },29 { "signal_code": "BROWSER_PRIVACY_BRAVE", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },30 { "signal_code": "BROWSER_PRIVACY_SAFARI", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },31 { "signal_code": "BROWSER_PRIVACY_SAMSUNG_INTERNET", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },32 { "signal_code": "NETWORK_PROXY", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },33 { "signal_code": "NETWORK_VPN", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },34 { "signal_code": "NETWORK_HOSTING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },35 { "signal_code": "NETWORK_TOR", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },36 { "signal_code": "DEVICE_MULTI_USER", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … }37 ],38 "limitation_codes": [],39 "reason_codes": ["NO_ADVERSE_INDICATOR_MATCH"],40 "recommended_action": "ALLOW",41 "recommendation_basis": "EVALUATION",42 "policy_version": "policy-login-v1",43 "fallback_policy_version": "production-observation-fallback-v2",44 "ruleset_version": "ruleset-web-v1",45 "signal_catalog_version": "signals-web-v1",46 "feature_schema_version": "features-v1",47 "resolver_version": "resolver-v1",48 "sdk_version": "web-sdk-1.0.0",49 "provider_versions": ["network-provider-2026-09-04"],50 "evidence_cutoff_at": "2026-09-04T12:00:00Z",51 "evaluated_at": "2026-09-04T12:00:01Z",52 "expires_at": "2026-09-04T12:05:00Z",53 "correlation_id": "corr-assessment-login-0001"54}
Versiones que la definieron · policy-login-v1 · production-observation-fallback-v2 · ruleset-web-v1 · signals-web-v1 · features-v1 · resolver-v1 · web-sdk-1.0.0 · network-provider-2026-09-04
13 señales en la respuesta completa · matriz de indicadores ↓
El producto en números
La respuesta
13
Indicadores web en cada respuesta
3
Estados por indicador: detectado, no detectado, no evaluado
14
Motivos con nombre para "no evaluado", nunca un falso silencioso
5
Recomendaciones posibles
3
Medidas separadas: confianza, coincidencia de dispositivo, cobertura de evidencia
1
Llamada firmada por evento evaluado
La recolección
17
Secciones de evidencia del navegador y del dispositivo por recolección
48
APIs del navegador contrastadas con la versión que el navegador declara
125
Milisegundos o menos: mediana de la recolección en escritorio en Chrome, Firefox y Safari
0
Solicitudes de permiso mostradas a su usuario
Sus reglas y su investigación
54
Elementos de contexto calculados dentro de cada evaluación
67
Reglas que su empresa puede ponderar en su propia puntuación: 13 indicadores y 54 elementos de contexto
6
Listas de referencia públicas detrás de los indicadores de red
6
Idiomas de la consola: inglés, portugués (Brasil y Portugal), español, francés, alemán
Nunca, y esto no cambia según el plan
— Cada valor es un conteo de un contrato, catálogo o lista versionados, excepto el tiempo de recolección, medido en nuestras máquinas de prueba con la caché vacía. Ninguno cambia según el plan o el volumen.
03 · Casos de uso
La inteligencia de dispositivos responde una pregunta antes de que su backend deje pasar la acción: ¿qué hay realmente del otro lado de esta pantalla? La misma llamada sirve para cada recorrido; la etiqueta que usted envía solo la clasifica.
login · password_recovery · profile_change
Una cuenta conocida en un dispositivo que nunca usó, un navegador que miente sobre sí mismo, un navegador antidetección, un viaje imposible de hacer en ese tiempo. Cada uno vuelve como evidencia, para que pida un segundo factor solo cuando importa.
signup · login · checkout
Navegadores headless, frameworks de automatización, agentes de IA identificados por firma y tráfico desde centros de datos. BOT_AUTOMATION y NETWORK_HOSTING dicen lo que se vio; la cobertura dice cuánto se pudo ver.
signup · deposit · promotions
Cuentas y personas por dispositivo y por IP, qué tan raro es el perfil del dispositivo en su base, una misma recolección repetida en otro dispositivo. Contexto que sus reglas pueden ponderar, nunca un veredicto automático: una persona puede tener varias cuentas legítimas.
withdrawal · pix_transfer · trade
Un retiro en la primera hora después de un dispositivo nuevo, beneficiarios compartidos entre cuentas, vecinas que usted marcó como fraude confirmado. Su backend retiene o revisa el dinero; nosotros nunca.
cualquier recorrido
Emuladores de Android y virtualización, una GPU imposible para el sistema declarado, una versión de navegador que sus propias APIs contradicen. Señales de device fingerprinting (huella digital del dispositivo) leídas como hashes y familias, nunca como píxeles en bruto.
cualquier recorrido
Proveedores de VPN conocidos, proxies públicos, salidas de Tor, rangos de hosting y Apple iCloud Private Relay, a partir de listas públicas que actualizamos de nuestro lado. La anonimización es contexto, no culpa: su política decide cuánto pesa.
04 · Las medidas
Fusionar confianza, cobertura y coincidencia de dispositivo en un solo número oculta justo lo que el analista necesita ver: si el problema es el acceso o la evidencia.
trust_score
72
Responde qué tan confiable es este acceso con esta versión de política; la etiqueta que usted envía no la cambia. Entero de 0 a 100. Solo existe cuando assessment_status = COMPLETED; en cualquier otro estado es null, nunca un valor por defecto.
No es una probabilidad de fraude, la reputación de la persona ni un valor por defecto ante datos faltantes. Mostramos 72/100, nunca "72 % confiable".
device_match_confidence
0.94
Fuerza de la evidencia de que este acceso viene del mismo dispositivo ya visto, de 0 a 1. Viene con device_id, un identificador público opaco del clúster probabilístico.
No es la identidad de la persona ni una prueba de hardware. Party y Account son cosas distintas.
evidence_coverage
100
Cuánto del conjunto esperado de verificaciones se pudo ejecutar, de 0 a 100. Cada indicador aplicable que queda como NOT_EVALUATED reduce la cobertura y aparece en limitation_codes.
No forma parte de la puntuación. Una cobertura baja no hace bajar la puntuación ni la sube: deja la evaluación como no concluyente.
Por qué no las sumamos
Una única puntuación de "sospecha" mezcla tres preguntas distintas: ¿este acceso merece confianza? ¿La evidencia fue suficiente? ¿Es el mismo dispositivo? Cuando la respuesta llega separada, su analista sabe si pedir un segundo factor, esperar la recolección o mirar el historial. Cuando llega fusionada, solo sabe que "sacó 42".
05 · 13 indicadores
Cada evaluación web devuelve los 13 códigos, siempre. Lo que cambia es el estado de cada uno, nunca la lista. Cada indicador tiene su propio detector versionado, y la respuesta nombra la versión que lo evaluó. Un detector ausente, vencido o con fallas nunca se convierte en false.
signal_catalog web · 13 códigos · ejemplo withdrawal_completed
Integridad del entorno
Privacidad del navegador · contexto neutral
Red · contexto neutral
Dispositivo
En nuestras políticas gestionadas, Tor por sí solo nunca justifica BLOCK_RECOMMENDED; las reglas que su empresa configura siguen los pesos y el corte que ella eligió. En este ejemplo del contrato v1, policy-withdrawal-v1 pidió la revisión del retiro, no un bloqueo, y el único código de motivo dice exactamente eso. La política gestionada en producción hoy recomienda MONITOR con cualquier puntuación.
El mismo indicador, tres estados
Un detector ausente, vencido o con fallas nunca se convierte en false. NOT_APPLICABLE viene solo de la matriz inmutable del catálogo por canal, motor y plataforma; su etiqueta nunca la cambia, y una política desactivada, un timeout o una caída nunca toman ese atajo.
Contexto neutral por defecto
Pueden limitar lo que observamos. La cobertura baja solo donde la evidencia no se evalúa. No son fraude. Describen el entorno; no acusan a la persona. En nuestras políticas gestionadas, por sí solos nunca justifican BLOCK_RECOMMENDED; las reglas que su empresa configura siguen los pesos y el corte que ella eligió. Cuando no se puede distinguir el tipo de red, como detrás de iCloud Private Relay de Apple, hosting, VPN y proxy quedan todos en NOT_EVALUATED con NETWORK_TYPE_AMBIGUOUS: nunca marcamos tres detecciones a partir de un solo booleano.
La evidencia de red viene de listas de referencia públicas que actualizamos en nuestra propia infraestructura: direcciones de salida de Tor, rangos de proveedores de nube, listas de redes de hosting, rangos de proveedores de VPN y una base de proxies públicos. Las direcciones de sus usuarios nunca se envían a quienes publican las listas. Una lista que supera su antigüedad máxima deja su indicador en NOT_EVALUATED, nunca en NOT_DETECTED.
06 · Elementos de contexto
Dentro de cada evaluación, antes de la respuesta, calculamos 54 elementos de contexto a partir de lo recolectado y del propio historial de su empresa: quién más usa el dispositivo, qué tan rápido se mueve la cuenta, desde qué red, junto a qué cuentas. La política gestionada de FingerTrackID los deja fuera de la puntuación. En sus propias reglas de riesgo, cualquiera de ellos puede estar desactivado, en fantasma o activo, con puntos para inusual y muy inusual: un elemento activo que se dispara resta puntos de la puntuación de confianza y se nombra en reason_codes.
context-insight.v1 · 54 elementos en seis temas · agrupados como en la consola y en sus reglas
Cuenta y dispositivo · 10
Dispositivo nuevo y sistema operativo nuevo para la cuenta · cuentas y personas distintas en el dispositivo en 30 días · cuentas de la misma persona en él · dispositivos por cuenta y por persona en 24 horas · dispositivo de alta actividad · qué tan común, poco común o raro es el perfil del dispositivo en su empresa · cookie del dispositivo perdida
Retiros y pedidos · 7
Retiros en la primera hora después de un dispositivo nuevo · beneficiarios por dispositivo y cuentas por beneficiario en 30 días · cantidad y monto de retiros por cuenta · cantidad de pedidos por cuenta y la mediana del intervalo entre pedidos
Red y ubicación · 12
País nuevo y proveedor de internet (ASN) nuevo para la cuenta · países, proveedores e IPs distintos por cuenta · cuentas y personas por IP · viaje imposible · zona horaria del navegador que no coincide con el país de la IP · país de salida de la VPN · proveedor en una lista pública de abuso · Apple iCloud Private Relay
Integridad del navegador y del SDK · 16
Herramientas de desarrollo abiertas · marcas de automatización · marcador de navegador antidetección · firma TLS que no coincide con el navegador declarado, y su estabilidad en 30 días · renderizador por software y familia de GPU · canvas o audio que cambia entre dos lecturas · navegador integrado en una app · posible modo invitado · agente de IA identificado por firma · categoría de bot · SDK distinto del paquete aprobado · una sesión del SDK en varios dispositivos · recolección idéntica repetida en otro dispositivo · cookie del dispositivo usada en lugares demasiado distantes
Velocidad · 5
Accesos por dispositivo y por cuenta en 5 minutos, 1 hora y 24 horas; por IP en 5 minutos y 1 hora · evaluaciones con la misma etiqueta por cuenta y por dispositivo en 1 minuto, 5 minutos y 1 hora
Vínculos entre cuentas, a un salto · 4
Otras cuentas que usaron los mismos dispositivos · cuentas vecinas donde se detectó automatización o falsificación del navegador · cuentas vecinas que usted marcó como fraude confirmado · beneficiarios de retiros compartidos con otras cuentas
Tres estados · un motivo, nunca un cero
Algunos elementos dependen de lo que usted envía. Sin referencias de cuenta o de persona, sin etiqueta o sin resultados, el elemento lo dice: cuenta no enviada, evaluación sin etiqueta, ningún resultado enviado. Una solicitud con etiqueta no lleva monto ni beneficiario, así que los elementos de monto y beneficiario del retiro también lo dicen. Un primer acceso, una red anonimizada o una IP fuera de la ventana de una hora de una verificación también son motivos.
Lo que no son
reason_codes solo a través de una regla que su empresa activó.Dónde los lee el analista
Detalle del acceso. Una tarjeta "Contexto del acceso" agrupa los elementos por tema, con sus ventanas de tiempo, el corte del historial que consideraron, qué tan inusual es cada uno en su regla de medida y el motivo de cada elemento que quedó sin valor. Un elemento que no cabe en el presupuesto de tiempo de la evaluación se termina en segundo plano y lo indica; nunca retrasa ni hace fallar la respuesta.
Catálogo de indicadores. Una página explica qué busca cada uno de los 13 indicadores, qué lo deja sin evaluar y si puede mover la puntuación, y enumera los elementos de contexto con los motivos por los que pueden quedar sin valor.
Canvas, WebGL, audio y fuentes se leen bajo la política de recolección gestionada de cada empresa, solo como valores derivados, y alimentan algunos de estos elementos, como la familia de GPU, un renderizador por software o un renderizado que cambia entre dos lecturas. Donde el navegador no permite una verificación, el elemento queda sin evaluar, con su motivo.
07 · No concluyente es un resultado
La falta de evidencia no produce una confianza de 100 ni se convierte en una señal de fraude. Sin puntuación, la recomendación viene del fallback congelado dentro de la versión de política y cubierto por su hash, y es una sola respuesta para cada estado sin puntuación, sea cual sea la etiqueta: MONITOR. Nunca ALLOW.
Casos sin puntuación de los ejemplos del contrato
La etiqueta nunca selecciona el fallback. En la política gestionada, cada estado sin puntuación, con cualquier etiqueta, recomienda MONITOR: seguir adelante y registrarlo. Así también los tres ejemplos del contrato de abajo.
INCONCLUSIVEetiqueta login · el SDK no cargó
Sin recolección: trust_score: null, evidence_coverage: 0, COLLECTOR_NOT_LOADED, base INSUFFICIENT_EVIDENCE. Nunca se libera nada como ALLOW.
INCONCLUSIVEevidencia de red no disponible
Cuatro indicadores de red NOT_EVALUATED, evidence_coverage: 69, PROVIDER_UNAVAILABLE. Sea cual sea la operación, se queda en su sistema, bajo su decisión; nunca retenemos dinero.
FAILEDetiqueta pix_transfer · política no disponible
Falla técnica: POLICY_UNAVAILABLE, policy_version: null, base TECHNICAL_FAILURE. Nunca se lee como "sin riesgo".
Sin puntuación nunca recomendamos ALLOW · fallback_policy_version production-observation-fallback-v2 en los ejemplos · el fallback se valida con la política cada vez que se lee la política
Cuatro estados de la evaluación
Los 14 códigos de limitación del catálogo · qué faltó, nunca por qué es riesgoso
Un código de limitación explica la recolección y la calidad; un código de motivo explica la política. Cada indicador NOT_EVALUATED apunta al suyo; la evaluación los agrega todos en limitation_codes. Una limitación de recolección nunca es un motivo de riesgo.
08 · Usted decide
recommended_action dice lo que sugiere la política. customer_action dice lo que usted hizo. Dos campos porque son dos hechos.
Quién recomienda, quién decide, quién actúa
FingerTrackID recomienda
Nunca solo por privacidad · Tor, VPN, proxy, incógnito, dispositivo compartido
Su flujo decide
Su backend decide y actúa. Devolvemos una recomendación; hoy la política gestionada responde MONITOR, solo observación. Lo que pasa con el acceso se decide y se ejecuta de su lado. Usted conoce la cuenta, el límite, el historial y el costo de la fricción. Nosotros no.
Usted actúa e informa
customer_action · el campo que usted devuelve
Lo que cada recomendación no significa
La política no encontró motivo de fricción en este acceso. No significa que la persona sea legítima ni que el acceso esté certificado. Solo se emite con una puntuación y con la evidencia requerida evaluada.
Seguir adelante, pero registrarlo. Es el fallback sin puntuación en cualquier etiqueta, y hoy también la respuesta de la política gestionada con cualquier puntuación. No significa una sospecha confirmada, y no exige ninguna acción del usuario.
Pedir un segundo factor o una confirmación. No significa que nosotros desafiemos a nadie: quien muestra el desafío es usted.
Enviarlo a revisión humana. No significa que retengamos dinero: la operación se queda en su sistema, bajo su decisión.
La política sugiere denegar. No significa un bloqueo ejecutado, un fraude confirmado ni un baneo. Cuando usted bloquea, eso se convierte en customer_action: BLOCKED, un evento suyo, y alimenta la medición de precisión.
09 · Integración
Un script en su sitio, un endpoint servidor a servidor en su backend y dos llamadas para devolver la acción y el resultado. Ninguna decisión en el cliente.
SDK en su sitio
Servido desde un subdominio suyo. Antes de que usted envíe la solicitud que quiere evaluar, sea cual sea la pantalla, recolecta señales del navegador y del entorno y recibe 202 PROCESSING: confirma la recepción, no un resultado. Las señales de red las agrega el edge en su dominio de recolección, nunca el script. Ninguna puntuación, señal ni decisión vuelve al navegador.
import { initializeSdk } from '@ftid/sdk-web'
// publicKey is a public locator, not a secret.
// collectionOrigin is YOUR collection domain (https).
const sdk = initializeSdk({
publicKey: 'pub_app_0123456789abcdef',
collectionOrigin: 'https://collect.yourcompany.com',
})
// ACCEPTED (202 PROCESSING on the wire): confirms receipt, not a result.
const collection = await sdk.collect()
if (collection.status !== 'ACCEPTED') {
// Without collection the journey continues; the backend will get
// INCONCLUSIVE / COLLECTOR_NOT_LOADED: no fake score.
return continueWithoutToken()
}
// Create the event before sending the request to be assessed.
const event = sdk.createEvent(collection.observation)
// Only a COMPLETED collection yields a token. The token goes in the POST
// that YOUR backend makes; the decision never comes back here.
const ctx = await sdk.getEventContext(event)
const token =
ctx.status === 'COMPLETED'
? ctx.eventContextToken
: nullSu backend llama
HMAC-SHA-256 sobre diez líneas canónicas: marcador, key_id, método, ruta, timestamp, ids de evento y de solicitud, metadatos del contenido y el SHA-256 de los bytes exactos del cuerpo en la última línea. Nunca vuelva a serializar el JSON antes de calcular el hash; el contrato incluye el vector normativo. key_id es el único localizador público. El secreto nunca viaja. Vector canónico requests.both_refs_deadline_750 del contrato v1.1: la misma ruta y la misma firma que v1, con un tag en lugar de journey, action y journey_context.
POST /v1/assessments HTTP/1.1
Host: api.fingertrackid.com
Content-Type: application/json
X-FTID-Signature: v1=<key_id>:<mac-hex>
X-FTID-Timestamp: 1791720000
X-FTID-Request-Id: <uuidv7 of the attempt>
X-FTID-External-Event-Id: evt:tag-0003
{
"schema_version": "event-assessment-request.v1.1",
"external_event_id": "evt:tag-0003",
"idempotency_key": "idem-tag-0003",
"occurred_at": "2026-10-11T12:00:00.000Z",
"subject_ref": "subject:synthetic",
"account_ref": "account:synthetic",
"event_context_token": "ctx.synthetic-token_0003",
"tag": "pix_transfer_a1b2c3d4e5f6g7h8i9j0abcdeabcdeabcdeabcdeabcdeabcdez",
"deadline_ms": 750
}tag es un slug en minúsculas de hasta 64 caracteres (letras, dígitos y guion bajo, como máximo diez dígitos), nunca datos personales; este vector está en ese límite · subject_ref y account_ref pueden ser null, y un account_ref exige un subject_ref · las refs son códigos opacos suyos, nunca un documento de identidad, un email ni un ID secuencial · deadline_ms es un entero de 250 a 5000, o null para 5000; si se excede, vuelve un Problem 503 reintentable, no una puntuación parcial
Respuesta síncrona
Después, dos llamadas de retorno: customer_action con lo que usted hizo y, cuando lo sepa, truth_status con el resultado real (el outcome: legítimo, fraude confirmado o evidencia insuficiente). El contrato aplica a ambas la misma disciplina que a la llamada de evaluación: nada cuenta como aceptado antes de un commit durable, y un reintento idéntico no agrega un segundo efecto. Un resultado se puede corregir después: la corrección se agrega como sucesora, y el registro anterior sigue legible.
POST /v1/assessments/POST /v1/assessments/
Web, en cualquier navegador moderno · sin app que instalar · SDK, evaluación y retorno en el mismo contrato versionado
npm install @fingertrackid/server firma la llamada por usted, y @fingertrackid/mcp permite que Claude Code, Cursor o cualquier agente de código compatible con MCP conecte la integración a partir del contrato publicado. Paso a paso en el quickstart, la guía del Web SDK y la referencia de la API.
10 · Zero trust en el navegador
Nada que venga del navegador se trata como autoridad. La evaluación es servidor a servidor, firmada, y cada intento cuenta una sola vez: repetirlo no crea ningún efecto nuevo.
Quién habla con quién
El navegador recibe solo IDs opacos de sesión y de evento. La puntuación, las señales y la recomendación nacen y se quedan en el servidor. La cookie first-party está firmada, es HttpOnly, Secure y está limitada a su tenant y su aplicación.
Anatomía de la llamada
ftidHmacV1 del contratokey_id UUIDv7 es el único localizador; tenant, aplicación, entorno y capacidades solo se vuelven autoridad después de un MAC válido en comparación de tiempo constante. X-Client-Id, el nonce heredado y las firmas múltiples se rechazan.request_id nuevo; un MAC inválido no crea reserva.assessment-unavailable (503, retryable: true), no una puntuación parcial.key_id inexistente, revocado o una firma incorrecta producen el mismo authentication-failed.key_id existe. Firme un request_id nuevo.11 · Política versionada
Cambiar la sensibilidad de un indicador crea una versión nueva, con autor, período de vigencia, simulación y rollback. El historial no cambia. Si falta una versión real, se bloquea el uso.
Versión que decidió · ejemplo withdrawal_completed
policy-withdrawal-v1
correlation_id sirve para soporte sin exponer un identificador personal. Las versiones expuestas son etiquetas públicas opacas; los IDs internos de la base de datos nunca aparecen en la API, en el webhook ni en la consola.
Lo que congela una versión de política
Reproducible, nunca reescrita
ejemplo login_completed
assessment_version1
supersedes_assessment_idnull
ejemplo login_completed_revision_2
assessment_version2
supersedes_assessment_id…0000000101
Una revisión operativa conserva la política y todas las demás versiones vigentes en el received_at del evento. Una política nueva sobre un evento antiguo es una simulación aparte; nunca reescribe qué recomendación orientó la decisión histórica.
12 · Modo sombra
El modo sombra es ejecutar FingerTrackID lado a lado con lo que usted usa hoy, sin que la respuesta toque ninguna decisión. Usted compara, devuelve los resultados reales y solo entonces empieza a usar la recomendación. Así recomendamos empezar.
El ciclo completo
El SDK recolecta
202 PROCESSING · event_context_token
Su backend pide la evaluación
POST /v1/assessments · síncrona
Usted decide con su flujo
en sombra, sin usar la respuesta
Usted informa la acción
customer_action · POST …/customer-actions
Usted informa el resultado
truth_status · POST …/outcomes
recommendation_alignment · derivado en el servidor a partir del par recomendación × acción; nunca lo declara el cliente. La coincidencia no prueba causalidad, ni precisión, ni fraude.
Comparación, campo por campo
| recommended_action | customer_action | recommendation_alignment |
|---|---|---|
REVIEW | REVIEWED o HELD | ALIGNED |
STEP_UP | ALLOWED | NOT_ALIGNED |
ALLOW o MONITOR | ALLOWED | ALIGNED |
BLOCK_RECOMMENDED | BLOCKED | ALIGNED |
| cualquiera | CANCELLED | NOT_COMPARABLE |
Bloquear no prueba fraude. Confirmar un fraude exige evidencia independiente: truth_status pasa de PENDING a LEGITIMATE, FRAUD_CONFIRMED o INSUFFICIENT_EVIDENCE, con madurez PROVISIONAL o MATURE. Solo una etiqueta madura se convierte en métrica de calidad.
Lo que alimenta el ciclo
customer_action y truth_status son hechos separados, y cada corrección crea una sucesora.13 · Privacidad por contrato
Los datos personales (PII) en texto claro no son un requisito del producto. Usted envía referencias opacas de persona y de cuenta; no pedimos documento de identidad, email ni teléfono para evaluar un acceso.
packages/contracts/src/sdk-handshake-v1.ts · política de recolección
canvas: z.boolean(),
audio: z.boolean(),
fonts: z.boolean(),
behavioral: z.literal(false),packages/contracts/src/sdk-signals/rendering-v1.ts · extracto
const Hash128 = z.string().regex(/^[0-9a-f]{32}$/)
canvas_hash: Hash128.optional(),
webgl_gpu_family: z.enum(SDK_RENDERING_GPU_FAMILY_V1).optional(),
audio_hash: Hash128.optional(),
fonts_count: z.number().int().min(0).max(SDK_RENDERING_FONT_COUNT_V1).optional(),La recolección conductual, es decir, el movimiento del puntero y las pulsaciones de teclas, solo acepta el valor desactivado: activarla exige cambiar el contrato, no una configuración. Canvas, WebGL, audio offline y la presencia de fuentes se leen bajo la política de recolección gestionada, que los activa para todas las empresas, y salen del navegador solo como valores derivados: hashes de longitud fija, una familia de GPU cerrada, un conteo y una máscara de presencia sobre una lista fija de fuentes. El contrato no tiene ningún campo para píxeles, muestras de audio, nombres de fabricante o renderizador de la GPU ni nombres de fuentes. En conjunto, estos valores derivados pueden reconocer de nuevo el mismo navegador, por eso se tratan como datos del dispositivo, no como datos anónimos. Nunca se recolecta, como regla absoluta: contraseña, texto escrito, contenido de chats o documentos, portapapeles, capturas de pantalla, micrófono, cámara. Cada pieza de evidencia tiene una clase de privacidad, y la clase no es peso de riesgo.
Garantías que no dependen de la buena voluntad
tenant_id con aislamiento forzado en la base de datos. No hay reputación ni etiqueta compartida entre clientes.HttpOnly, Secure, limitada a su tenant y su aplicación. El valor nunca viaja a una base de datos, una cola o un log; si falta o se rechaza, la continuidad se degrada como limitación y la evaluación no se detiene.Party no es Account
El vínculo viene de su backend · nunca se infiere de la huella digital
Una persona, varias cuentas legítimas. Una cuenta nunca cambia de persona en silencio; la sesión solo avanza de anónima a persona y luego a una cuenta de la misma persona. Una contradicción es un conflicto, no una nueva asociación ni evidencia negativa improvisada.
Dónde viven los datos
14 · Consola
La consola responde primero "¿estamos recibiendo, evaluando y explicando con calidad?", y solo después deja que alguien hable de legitimidad. Cada porcentaje nombra su denominador.
Esquema, no captura de pantalla · tonos de la consola dentro del marco
Detalle del acceso. Las tres medidas como tres componentes separados; la recomendación con su recommendation_basis, la política vigente y lo que su equipo informó haber hecho; la frescura de la evidencia; los 13 indicadores con estado, aplicabilidad, fuente, confianza del detector, frescura y el motivo de cualquier no evaluado; limitaciones y códigos de motivo; sesión, dispositivo y sus asociaciones; la multiplicidad en el dispositivo; una ubicación aproximada a partir de la red; el contexto del acceso; y una pestaña de datos técnicos con todo lo que el SDK y el edge recolectaron, incluida la versión real del navegador leída de las APIs que expone, junto a la versión que declara.
Filtros de investigación. La lista de accesos se filtra por proveedor de internet (ASN), país de la red, instalación del dispositivo, el motivo por el que un indicador no se evaluó y hasta dos indicadores en estados elegidos al mismo tiempo, y encuentra un acceso por su propia referencia de cuenta o de persona. No hay filtro por dirección IP: es un dato personal. Cada detalle de acceso trae además sus elementos de contexto ↑.
Investigue a fondo. Desde cualquier acceso, un grafo de vínculos abre los dispositivos y las cuentas a su alrededor, un salto a la vez, sobre hasta 92 días de su propio historial. Cada expansión es una lectura registrada; las direcciones IP nunca se convierten en nodos.
Listas de bloqueo y de permitidos. Desde el detalle del acceso, su equipo pone un dispositivo, una referencia de cuenta o una IP individual en la lista de bloqueo de su empresa (bloquear o revisar) o en la lista de permitidos, con una nota y el nombre de quien la agregó. En un acceso de producción con puntuación, una entrada prevalece sobre la recomendación y se nombra en reason_codes. Nada se borra: quitar una entrada registra quién la quitó y cuándo.
Asistente de IA. Un panel lateral explica cada pantalla y responde preguntas sobre su propia integración y sus accesos, dentro de su empresa y de su rol.
Configuración de riesgo. Las propias reglas de riesgo de su empresa, por aplicación: cada uno de los 13 indicadores está desactivado, en fantasma o activo, con un peso de 1 a 100 puntos, y usted define las franjas de puntuación y la acción de cada una. Una regla en fantasma se calcula y se registra, pero nunca cambia la respuesta. Antes de publicar, la tarjeta de impacto reproduce su borrador sobre las evaluaciones de los últimos 1, 7 o 30 días. Cada uno de los 54 elementos de contexto ↑ puede sumarse con sus propios puntos. Su administrador o supervisor de riesgo publica directamente; cada publicación es una nueva versión auditada, y todo en fantasma detiene todas sus reglas de una vez. FingerTrackID nunca activa una regla por usted: su soporte solo puede poner en fantasma todas las reglas de una aplicación, con un motivo que su consola muestra. Mientras ninguna regla esté activa, responde la política gestionada, publicada por el equipo de FingerTrackID con aprobación registrada.
Dieciséis pantallas en cuatro grupos · principal, detección, operación, administración
La cola de revisión es el módulo de revisión de retiros: una cola operativa construida sobre el mismo núcleo, que lleva a una persona cada retiro v1 con recomendación REVIEW, con la evidencia al lado. Las evaluaciones con etiqueta nunca entran en ella, y se mantiene vacía mientras la política recomiende MONITOR, como hace hoy la política gestionada.
En inglés, portugués (Brasil y Portugal), español, francés y alemán. Inicio de sesión con llave de acceso (passkey) o segundo factor; permisos por rol; un registro de auditoría de quién vio datos sensibles y quién cambió qué. Los datos en bruto no aparecen libremente: cada acceso a ellos queda registrado.
15 · Cómo cobramos
Precio por volumen de recolecciones completadas, definido en la propuesta. El modo sombra consume las mismas unidades y aparece en la consola como uso estimado; lo que va a la factura en ese período se define en la propuesta.
La unidad
Es la unidad de medida y la unidad candidata de cobro. Cada device_intelligence_snapshot_id produce como máximo una unidad, sin importar cuántas evaluaciones, etiquetas, proveedores o reprocesamientos usen esa recolección.
Evento · ¿crea una unidad?
idempotency_keynocustomer_action y resultadono4xx por autenticación, autorización o contrato inválidono5xx, un timeout de nuestro lado, recolección INCONCLUSIVE o FAILEDnoPropuesta por volumen, con el uso del modo sombra sobre la mesa.
Solicitar una propuesta16 · Preguntas frecuentes
customer_action y el resultado, y en la consola compara, acceso por acceso, la recomendación con lo que su equipo informó haber hecho, y sigue la cobertura de evidencia. Cuando los números cierran, su equipo decide si la recomendación empieza a influir en una decisión, y dónde, siempre ejecutada por su backend.tag propio con cada evaluación, un slug en minúsculas como login, withdrawal o pix_transfer: sin registro, sin lista cerrada y sin límite. La consola filtra, agrupa y exporta por etiqueta, y las plantillas (registro, login, recuperación de contraseña, segundo factor, cambio de perfil, depósito, retiro, transferencia Pix, trade, checkout) son una guía de integración. La etiqueta nunca selecciona la política, los detectores, el fallback ni el plazo: toda evaluación con etiqueta corre bajo la misma política y los mismos 13 indicadores. Nunca debe llevar datos personales. La solicitud no lleva monto, moneda ni beneficiario.BLOCK_RECOMMENDED es la recomendación más fuerte que existe, y sigue siendo una recomendación. Cuando usted bloquea, registra customer_action: BLOCKED, y eso se convierte en un dato para medir si la recomendación acertó.BLOCK_RECOMMENDED por sí solo; las reglas que su empresa configura siguen los pesos y el corte que ella eligió. El modo privado y las protecciones del navegador son contexto neutral: pueden reducir la cobertura y aparecen en el detalle, sin código de motivo adverso. Tor, proxy, VPN y hosting son contexto de anonimización: una política puede ponderarlos junto con lo demás que se vio, nunca por etiqueta. En la política gestionada, hoy solo la automatización y la falsificación del navegador mueven la puntuación, y la recomendación es MONITOR. En el ejemplo del contrato v1 de retiro de esta página, Tor detectado llevó a REVIEW, y el código de motivo lo dice. Nunca es fraude en sí mismo.event_context_token y recibe INCONCLUSIVE, trust_score: null, evidence_coverage: 0, limitation_codes: ["COLLECTOR_NOT_LOADED"] y la recomendación de fallback, MONITOR. Nunca una puntuación inventada. Nunca ALLOW por falta de evidencia.deadline_ms lo fija en cualquier punto entre 250 y 5000 (mantenga su timeout HTTP por encima de unos 6 s para el valor por defecto); si se excede, recibe un Problem assessment-unavailable (503, retryable: true, con Retry-After), no una respuesta parcial. Repita la misma operación lógica con un request_id nuevo. La latencia y el SLA van en la propuesta, medidos en su modo sombra antes de que cualquier decisión dependa de la respuesta.key_id UUIDv7 es el único localizador público; request_id se reserva contra replay; una falla de autenticación devuelve un 401 uniforme sin revelar si la clave existe. El secreto nunca viaja. El vector de prueba normativo del protocolo forma parte del contrato; con él usted reproduce la firma byte a byte.@fingertrackid/server firma la llamada, el servidor MCP @fingertrackid/mcp le da a Claude Code, Cursor o cualquier agente compatible con MCP los contratos, los vectores de firma, un módulo de servidor listo por etiqueta y una verificación de su dominio de recolección, todo de solo lectura, y la documentación publica llms.txt y un bloque de reglas listo para su AGENTS.md. El secreto se queda en su entorno; el agente nunca necesita verlo.17 · Contacto
Empiece en modo sombra: la respuesta corre junto a su flujo real sin tocar ninguna decisión, usted compara, devuelve los resultados y solo entonces empieza a usar la recomendación. Si tiene pantallas donde la decisión importa y quiere ver la respuesta explicada antes de confiar en ella, hable con nosotros.
Agendar una demo
Cómo empieza
Qué incluye
event-assessment.v1 ejecutable, con un vector de prueba HMAC