# Consulter le journal d'audit et vérifier son intégrité

> Lisez les opérations inscrites au journal d'audit HDS de votre espace et vérifiez que la chaîne d'empreintes n'a pas été altérée.

Le journal d'audit HDS enregistre chaque opération sur les données de santé de l'espace : création, dépôt, lecture, partage, accès d'urgence. L'administrateur HDS le consulte et vérifie son intégrité à la demande, en plus du contrôle automatique quotidien.

## Avant de commencer

- Vous portez le rôle `HDS_ADMIN`.
- Vous avez lu [Chiffrement et traçabilité](/v1.0/hds/chiffrement-et-tracabilite) pour comprendre la chaîne d'empreintes.

## Lire le journal

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl "https://api.wakastart.app/api/hds/audit-logs?eventCategory=BREAK_GLASS&from=2026-10-01T00:00:00Z&to=2026-10-23T23:59:59Z&limit=100" \
  -H "Authorization: Bearer $USER_TOKEN"
```
:::
:::tab{label="TypeScript"}
```typescript
const params = new URLSearchParams({
  eventCategory: "BREAK_GLASS",
  from: "2026-10-01T00:00:00Z",
  to: "2026-10-23T23:59:59Z",
  limit: "100",
});
const response = await fetch(`https://api.wakastart.app/api/hds/audit-logs?${params}`, {
  headers: { Authorization: `Bearer ${process.env.USER_TOKEN}` },
});
const { data } = await response.json();
console.table(data.map((e: any) => [e.timestamp, e.eventType, e.userId, e.result]));
```
:::
::::

| Paramètre | Description |
|---|---|
| `eventType` | Type d'événement exact, par exemple `DOCUMENT_UPLOADED`. |
| `eventCategory` | Catégorie : `VAULT`, `DOCUMENT`, `FOLDER`, `SHARE`, `CONSENT`, `BREAK_GLASS`, `COMPLIANCE`, `ACCESS_REVIEW`, `BACKUP`… |
| `from`, `to` | Bornes de la période, ISO 8601. |
| `limit` | 50 par défaut, 200 au plus. |

Les entrées sont triées de la plus récente à la plus ancienne. Extrait d'une entrée :

```json
{
  "auditId": "aud_4Gh7Jk1Lm0Qw",
  "timestamp": "2026-10-23T03:12:45.010Z",
  "userId": "5e1a9c3b-7d2f-4b8e-a6c0-3f9d2e1b8a74",
  "networkWid": "EXCLI1",
  "sourceIp": "203.0.113.24",
  "eventType": "BREAK_GLASS_ACTIVATED",
  "eventCategory": "BREAK_GLASS",
  "action": "ACTIVATE",
  "resourceType": "break_glass",
  "resourceId": "bg_Nm4Bv7Cx",
  "result": "SUCCESS",
  "details": {
    "vaultId": "vlt_a1B2c3D4",
    "justification": "Patient inconscient aux urgences, recherche d'allergies connues",
    "severity": "CRITICAL"
  },
  "accessContext": {
    "actorType": "client_user",
    "hdsRoles": ["HDS_HEALTHCARE"],
    "superAdminBypass": false,
    "customerWid": "EXCLI1"
  },
  "previousHash": "b5d4045c3f466fa91fe2cc6abe79232a1a57cdf104f7a26e716e0a1e2789df78",
  "entryHash": "a2c3f0e7b8d9e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f80912"
}
```

## Vérifier l'intégrité de la chaîne

```bash
curl "https://api.wakastart.app/api/hds/audit-logs/integrity-check" \
  -H "Authorization: Bearer $USER_TOKEN"
```

Réponse attendue quand la chaîne est intacte :

```json
{
  "valid": true,
  "totalEntries": 18452,
  "checkTimestamp": "2026-10-23T12:30:00.000Z"
}
```

En cas de rupture, `valid` vaut `false` et deux champs s'ajoutent : `firstInvalidAt`, la position de la première entrée invalide, et `details`, qui précise s'il s'agit d'un lien rompu (`Chain break at entry …`) ou d'une empreinte modifiée (`Invalid hash at entry …`).

:::warning
Un résultat `valid: false` signale une possible altération du journal. Conservez la réponse complète et contactez immédiatement le support Wakastart.
:::

## Vérifier le résultat

- La lecture renvoie les entrées de la période demandée.
- La vérification renvoie `valid: true` et un `totalEntries` cohérent avec l'activité de l'espace.

## Voir aussi

- [Produire un rapport de conformité](/v1.0/hds/produire-un-rapport-de-conformite)
- [Référence : entrée du journal d'audit](/v1.0/hds/reference#entrée-du-journal-daudit)
