> ## 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.

# Esdeveniments d'autenticació i webhooks

> Com l'activitat d'inici de sessió arriba a la consola de Didit: resum, cronologia, vistes de frau, regles i webhooks auth.*.

> [!WARNING]
>
> 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/`](https://docs.didit.me/ca/transaction-monitoring/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](https://docs.didit.me/ca/authentication/bot-protection.md) (`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/`](https://docs.didit.me/ca/management-api/users/list) com a `authentication`:

```json theme={null}
{
  "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](https://docs.didit.me/ca/transaction-monitoring/event-rules.md) 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](https://docs.didit.me/ca/integration/webhooks.md) 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.

```json auth.new_device theme={null}
{
  "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](https://docs.didit.me/ca/integration/webhooks.md)).

## 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](https://docs.didit.me/ca/transaction-monitoring/events.md) i [enviament d'esdeveniments amb el SDK](https://docs.didit.me/ca/transaction-monitoring/sdk-event-submission.md). Utilitza el `vendor_data` de la persona des del seu token d'accés.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.