# Activer un accès d'urgence (bris de glace)

> Ouvrez en urgence vitale un coffre qui ne vous est pas partagé, avec justification tracée, puis faites révoquer l'accès.

Le bris de glace permet à un professionnel de santé d'accéder au dossier d'un patient qui ne lui est pas partagé, quand l'urgence l'exige. L'accès est accordé sur-le-champ, mais il est justifié, tracé comme événement critique et remonté dans les alertes de l'administrateur HDS.

## Avant de commencer

- Le coffre est au statut `ACTIVE`.
- Le demandeur porte le rôle `HDS_HEALTHCARE` (ou `HDS_ADMIN`).
- Votre application demande une justification écrite d'au moins 20 caractères avant d'appeler l'API.

## Activer l'accès

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl -X POST "https://api.wakastart.app/api/hds/break-glass/vaults/vlt_a1B2c3D4" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "justification": "Patient inconscient aux urgences, recherche d'\''allergies connues" }'
```
:::
:::tab{label="TypeScript"}
```typescript
const response = await fetch(
  "https://api.wakastart.app/api/hds/break-glass/vaults/vlt_a1B2c3D4",
  {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.USER_TOKEN}`, "Content-Type": "application/json" },
    body: JSON.stringify({
      justification: "Patient inconscient aux urgences, recherche d'allergies connues",
    }),
  },
);
console.log(response.status, await response.json());
```
:::
::::

Réponse attendue (`201 Created`) :

```json
{
  "breakGlassId": "bg_Nm4Bv7Cx",
  "vaultId": "vlt_a1B2c3D4",
  "requestedBy": "5e1a9c3b-7d2f-4b8e-a6c0-3f9d2e1b8a74",
  "requestedByEmail": "dr.exemple@hopital-exemple.fr",
  "justification": "Patient inconscient aux urgences, recherche d'allergies connues",
  "status": "ACTIVE",
  "shareId": "shr_Ty6Ui9Op",
  "grantedAt": "2026-10-23T03:12:45.000Z",
  "expiresAt": "2026-10-24T03:12:45.000Z",
  "revokedAt": null,
  "revokedBy": null,
  "reviewedAt": null,
  "reviewedBy": null,
  "reviewNotes": null,
  "createdAt": "2026-10-23T03:12:45.000Z",
  "updatedAt": "2026-10-23T03:12:45.000Z"
}
```

Le module crée un partage en lecture (`shareId`) au nom du demandeur : le coffre apparaît dans sa liste et ses documents deviennent lisibles. L'événement `BREAK_GLASS_ACTIVATED` est inscrit au journal d'audit avec la justification et classé critique. Tant que l'accès reste actif, le contrôle des seuils remonte une alerte `BREAK_GLASS_ACTIVE` à l'administrateur HDS. Voir [Surveiller les alertes](/v1.0/hds/surveiller-les-alertes).

## Consulter les accès d'urgence

Rôle : `HDS_ADMIN`.

```bash
curl "https://api.wakastart.app/api/hds/break-glass?status=ACTIVE" \
  -H "Authorization: Bearer $USER_TOKEN"
```

Filtres : `vaultId`, `status` (`ACTIVE`, `EXPIRED`, `REVOKED`, `PENDING_REVIEW`), `limit` (50 par défaut, 200 au plus). Détail : `GET /api/hds/break-glass/{breakGlassId}`.

## Révoquer l'accès

Rôle : `HDS_ADMIN`. Révoquez l'accès dès que l'urgence est passée : la révocation désactive le partage associé.

```bash
curl -X DELETE "https://api.wakastart.app/api/hds/break-glass/bg_Nm4Bv7Cx" \
  -H "Authorization: Bearer $USER_TOKEN"
```

La réponse renvoie l'accès avec `"status": "REVOKED"`, `revokedAt` et `revokedBy`.

## Vérifier le résultat

1. Après activation, `GET /api/hds/vaults/vlt_a1B2c3D4` répond `200` pour le demandeur.
2. Après révocation, la même requête répond `404`.
3. Le journal d'audit contient l'activation et la révocation.

## Dépannage

- `400` `Justification must be at least 20 characters` : allongez la justification.
- `400` `Cannot activate break glass on vault with status ARCHIVED` : le coffre n'est pas `ACTIVE`.
- `400` `Break glass access already revoked` : l'accès est déjà révoqué.

## Voir aussi

- [Surveiller les alertes HDS](/v1.0/hds/surveiller-les-alertes)
- [Consulter le journal d'audit](/v1.0/hds/consulter-le-journal-d-audit)
