Esdeveniments d'autenticació i webhooks

L’autenticació és nova. Didit activa el lliurament d’esdeveniments per a la teva aplicació. Les accions de regla que tanquen la sessió d’una persona o la bloquegen encara no estan actives: una regla que les utilitza registra l’acció però no l’aplica.

Didit Authentication envia la seva activitat a Didit automàticament. Tu no envies els esdeveniments d’inici de sessió. Cada esdeveniment s’associa a la persona amb el mateix vendor_data, juntament amb les seves verificacions i transaccions. No enviïs també els teus propis esdeveniments auth.login a /v3/events/ per als mateixos inicis de sessió. Es guardarien dues vegades, i no actualitzarien el resum d’inicis de sessió de la persona ni enviarien webhooks auth.*.

Què s’envia

Activitat d’inici de sessió	Es guarda com a	Webhook
Registre	`auth.signup`	`auth.signup`
Inici de sessió	`auth.login`	`auth.login`
Inici de sessió fallit	`auth.login_failed`	`auth.login_failed`
Tancament de sessió, o sessió revocada	`auth.logout`	Cap
Contrasenya oblidada	`auth.password_forgot`	`auth.password_reset_requested`
Restabliment de contrasenya	`auth.password_reset`	`auth.password_reset_completed`
Contrasenya canviada	`security.password_changed`	Cap
Autenticador afegit o canviat	`security.mfa_changed`	`auth.mfa_changed`
Inici de sessió des d’un dispositiu nou	`security.device_changed`	`auth.new_device`
Compte bloquejat o bloquejat	`security.account_locked`	`auth.account_locked`
Accés d’agent aprovat o revocat	`security.agent_access_approved`, `security.agent_access_revoked`	Cap

Les decisions de protecció contra bots (attempt_challenged, attempt_blocked i altres) també es guarden com a esdeveniments auth.*, de manera que apareixen a la línia de temps. Un dispositiu nou és un dispositiu que no coincideix ni amb un identificador de dispositiu ni amb una empremta digital amb què la persona hagi iniciat sessió abans. Cada esdeveniment inclou:

el method d’inici de sessió (per exemple password o passkey) i un reason per als errors i els bloquejos,
l’adreça IP, i el context del dispositiu: un identificador de dispositiu persistent, una empremta digital, l’agent d’usuari i una puntuació de bot quan el client l’ha enviat,
l’identificador de la sessió.

Un inici de sessió fallit amb un identificador desconegut o no verificat no té vendor_data. Didit mai rep l’identificador en si, només un hash amb clau. Aquests intents mai s’enllacen a una persona, però les vistes de frau següents els continuen comptant per compte.

On les veus

El perfil de la persona

Cada persona té un resum d’inici de sessió, que es mostra a la llista i al perfil de Persones i es retorna a /v3/users/ com a authentication:

{
  "authentication": {
    "status": "ACTIVE",
    "methods": ["password", "passkey"],
    "mfa_enabled": true,
    "last_sign_in_at": "2026-10-14T09:12:44Z"
  }
}

status és ACTIVE, LOCKED (bloquejat per una política de seguretat) o BLOCKED (bloquejat pel teu equip).
authentication és null per a una persona sense identitat d’inici de sessió.
Pots filtrar Persones per estat d’inici de sessió, mètode d’inici de sessió (inclosa l’opció «none») i MFA.

Esdeveniments i línia de temps

Els esdeveniments d’inici de sessió apareixen a la pàgina Esdeveniments de la consola i a la pestanya Esdeveniments de cada persona. Per llegir-los cal el permís list:transactions o read:authentication. En obrir un esdeveniment d’inici de sessió es mostren el dispositiu i la xarxa, qualsevol motiu de protecció (per exemple bots, stuffing, brute, vpn, travel o attack_mode) i les regles amb què ha coincidit.

Vistes de frau

La pàgina Esdeveniments té vistes predefinides que combinen els inicis de sessió amb la resta d’activitat d’una persona:

Vista	Què troba
Un dispositiu, diverses persones	3 o més persones amb la mateixa empremta digital de dispositiu en 7 dies.
Pujada d’inicis de sessió fallits	Una adreça IP pública amb 10 o més inicis de sessió fallits contra 3 o més comptes (24 hores per defecte), amb els seus 30 minuts més actius.
Dispositiu nou, i després un pagament	Un inici de sessió des d’un dispositiu no vist en 90 dies, i després una retirada o una transacció de sortida en 15 minuts.
Contrasenya canviada, i després una transacció	Una transacció de sortida en els 30 minuts posteriors a un canvi de contrasenya.
Moltes sessions des d’una mateixa IP	3 o més sessions de verificació per a 3 o més persones en 48 hores.

Les vistes analitzen fins a 31 dies enrere.

Regles d’esdeveniments

Els esdeveniments d’inici de sessió passen per les mateixes regles d’esdeveniments que la resta dels teus esdeveniments. El paquet Frau d’autenticació té quatre preconfiguracions:

Preconfiguració	Coincideix amb	Accions
Apropiació de compte	Un canvi de contrasenya o MFA després de 3 o més inicis de sessió fallits i un dispositiu nou en 1 hora.	Rebutjar (puntuació 90), etiquetar, tancar la sessió, bloquejar
Farciment de credencials	Un inici de sessió correcte des d’una IP amb 10 o més fallades en 3 o més comptes en 1 hora.	Revisar (puntuació 60), etiquetar, tancar la sessió
Dispositiu nou, i després un pagament	Una retirada en els 15 minuts posteriors a un dispositiu nou.	Revisar (puntuació 60), etiquetar, tancar la sessió
Desplaçament impossible	Més de 500 km entre inicis de sessió a més de 1.000 km/h.	Revisar (puntuació 50), etiquetar, tancar la sessió

Els camps útils per a les teves pròpies regles inclouen event.category, event.action_type, event.payload.method, event.payload.reason, event.security.changed_field, event.device.fingerprint, event.device.persistent_device_id, event.device.bot_score, event.ip.is_vpn_or_tor, event.ip.is_data_center, event.ip.country, event.ip.travel_distance_km i event.ip.travel_speed_kmh. Les regles d’esdeveniments tenen només dues accions per als esdeveniments d’inici de sessió: Tancar la sessió de la persona en totes les sessions i Bloquejar la persona perquè no pugui iniciar sessió. Encara no estan actives. Mentre no ho estiguin, una regla les registra amb l’estat DISABLED i no les aplica. La resta d’accions (puntuació, estat, etiquetes, notes, llistes i casos) funcionen com de costum.

Webhooks

Subscriu una destinació del webhook als tipus auth.* que necessitis. Només les destinacions subscrites els reben. Fes servir Try Webhook a la consola per enviar una mostra de cada tipus.

auth.new_device

{
  "webhook_type": "auth.new_device",
  "event_id": "0b6f2a71-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
  "application_id": "11111111-2222-3333-4444-555555555555",
  "environment": "live",
  "timestamp": 1760433164,
  "created_at": 1760433164,
  "vendor_user_id": "8f0c3a52-4b7e-4a51-9a56-1f2d3c4b5a69",
  "vendor_data": "user-1234",
  "auth_event": {
    "event_id": "auth:3d0f1c2e-7a8b-4c5d-9e0f-1a2b3c4d5e6f",
    "event_uuid": "5b6c7d8e-9f01-4a2b-8c3d-4e5f60718293",
    "type": "security.device_changed",
    "method": "passkey",
    "reason": null,
    "occurred_at": "2026-10-14T09:12:44+00:00",
    "ip_address": "203.0.113.10",
    "device": {
      "fingerprint": "fp_7f3a",
      "label": "Chrome on Android",
      "persistent_device_id": "dev_4c21"
    }
  },
  "authentication": {
    "status": "ACTIVE",
    "methods": ["passkey"],
    "mfa_enabled": true,
    "last_sign_in_at": "2026-10-14T09:12:44Z"
  }
}

Desduplica per auth_event.event_id, l’identificador propi de l’esdeveniment d’inici de sessió: és el mateix a cada lliurament d’aquell esdeveniment. auth_event.event_uuid permet llegir l’esdeveniment guardat a GET /v3/events/{event_uuid}/.
vendor_data, vendor_user_id i authentication són null per a un intent que no esmenta cap persona coneguda.
Verifica la signatura com per a qualsevol webhook de Didit (consulta webhooks).

Facturació

Els esdeveniments d’autenticació no es facturen per esdeveniment. L’autenticació es factura per usuari actiu mensual.

Esdeveniments que són propis de la teva aplicació

Per a les accions que es produeixen al teu propi producte, com ara un canvi de perfil o una sol·licitud de pagament, envia tu mateix els esdeveniments des del teu servidor (POST /v3/events/ amb x-api-key) o des del dispositiu amb un token de monitoratge amb abast limitat. Consulta esdeveniments i enviament d’esdeveniments amb el SDK. Utilitza el vendor_data de la persona des del seu token d’accés.

Guies

Autenticació

Model Context Protocol (MCP)

SDK web

SDK natius

SDK de servidor

Integracions

Esdeveniments d'autenticació i webhooks

Què s’envia

On les veus

El perfil de la persona

Esdeveniments i línia de temps

Vistes de frau

Regles d’esdeveniments

Webhooks

Facturació

Esdeveniments que són propis de la teva aplicació

​Què s’envia

​On les veus

​El perfil de la persona

​Esdeveniments i línia de temps

​Vistes de frau

​Regles d’esdeveniments

​Webhooks

​Facturació

​Esdeveniments que són propis de la teva aplicació

Què s’envia

On les veus

El perfil de la persona

Esdeveniments i línia de temps

Vistes de frau

Regles d’esdeveniments

Webhooks

Facturació

Esdeveniments que són propis de la teva aplicació