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.
- Accès requis
- Rôle HDS_HEALTHCARE ou HDS_ADMIN pour activer ; HDS_ADMIN pour consulter et révoquer
- Durée
- 5 min
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(ouHDS_ADMIN). - Votre application demande une justification écrite d'au moins 20 caractères avant d'appeler l'API.
Activer l'accès
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" }'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) :
{
"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.
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é.
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
- Après activation,
GET /api/hds/vaults/vlt_a1B2c3D4répond200pour le demandeur. - Après révocation, la même requête répond
404. - Le journal d'audit contient l'activation et la révocation.
Dépannage
400Justification must be at least 20 characters: allongez la justification.400Cannot activate break glass on vault with status ARCHIVED: le coffre n'est pasACTIVE.400Break glass access already revoked: l'accès est déjà révoqué.