SDK de dispositivo

El SDK de navegador identifica el dispositivo del jugador para detectar multicuentas y abuso de bonos: varias cuentas desde el mismo equipo.

Cómo funciona

1. En tu página, el SDK calcula un identificador del navegador con FingerprintJS (versión de código abierto, licencia MIT). Solo salen del navegador ese identificador, su nivel de confianza y tres indicadores de automatización; las características crudas del navegador no.
2. Lo registra con POST /v1/device usando una llave publicable (pk_…) y recibe un device_id (dv_…).
3. Tu página manda el device_id a tu backend, y tu backend lo incluye en POST /v1/score con tu llave secreta. El enlace dispositivo ↔ cuenta ocurre ahí.

import { identify } from "@sentinel-mx/device";

const { deviceId } = await identify({
  publishableKey: "pk_live_…",
  endpoint: "https://…", // la URL base de la API
});
// envía deviceId a tu backend junto con el registro, depósito, etc.

Llaves publicables

Una llave publicable está pensada para estar en tu página, así que es pública. Por eso:

• solo sirve para POST /v1/device;
• solo funciona desde los orígenes registrados para ella (coincidencia exacta del encabezado Origin, p. ej. https://www.tucasino.mx);
• cada origen es https://host[:puerto], tal como lo envía el navegador: en minúsculas, sin ruta ni / final, sin el puerto 443 y con dominios internacionales en punycode (https://xn--…). null y * no se aceptan; http:// solo para localhost, 127.0.0.1 o [::1] en desarrollo;
• créala con POST /v1/keys {"name": "web", "kind": "publishable", "allowed_origins": ["https://www.tucasino.mx"]}.

Lo que verás en /v1/score

signals.device.facts incluye si el dispositivo es conocido y cuántas cuentas distintas lo usaron (accounts_30d). Razones relacionadas: DEVICE_NEW, DEVICE_EMULATOR y DEVICE_MULTI_ACCOUNT (esta última es una regla del paquete iGaming; el número de cuentas se ajusta).

Privacidad

La identificación del dispositivo debe mencionarse en tu aviso de privacidad. Safegate guarda el identificador solo como hash con llave (HMAC), separado por cuenta y entorno.