Aller au contenu

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.

GuideDéveloppeur
Accès requis
Rôle HDS_HEALTHCARE ou HDS_ADMIN pour activer ; HDS_ADMIN pour consulter et révoquer
Durée
5 min
Voir en Markdown

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

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" }'
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.

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