Rôles HDS et règles d'accès
Ce que permet chacun des six rôles HDS, et les règles de propriété et de partage qui s'appliquent en plus des rôles.
This page has not been translated yet and is shown in French.
L'accès aux données de santé repose sur deux contrôles successifs. Le rôle HDS de l'utilisateur dit quelles opérations il peut tenter ; la propriété ou le partage du coffre dit sur quels coffres il peut les faire.
Définition
Un rôle HDS est une habilitation propre au module, attribuée à un utilisateur en plus de son niveau d'administration et de ses droits applicatifs. Un utilisateur peut cumuler plusieurs rôles ; ses permissions sont alors l'union de celles de ses rôles. Les rôles HDS sont portés par le jeton enrichi et par la réponse de /me (hdsRoles).
Sans aucun rôle HDS, l'API refuse tout appel à /api/hds/*.
Pourquoi deux contrôles
Le rôle décrit une fonction (soignant, patient, administrateur), valable dans tout l'espace du client. Mais un soignant n'a pas à lire les dossiers de tous les patients de l'établissement : il lit ceux qu'il a créés et ceux qu'on lui a partagés. Séparer les deux contrôles permet d'attribuer les rôles une fois, puis de gérer l'accès dossier par dossier.
Comment ça marche
Les six rôles
| Rôle | Fonction | Peut notamment |
|---|---|---|
HDS_ADMIN | Administrateur HDS du client | Toutes les opérations du module ; seul rôle qui lit le journal d'audit, vérifie son intégrité, produit les rapports, mène les revues d'accès, gère les alertes et les sauvegardes, révoque un accès d'urgence et modifie un coffre. |
HDS_HEALTHCARE | Professionnel de santé | Créer des coffres, déposer des documents, organiser les dossiers, partager un coffre, recueillir un consentement, activer un accès d'urgence. |
HDS_MEDICAL | Consultation médicale | Lire les coffres, documents, dossiers et consentements auxquels il a accès. Aucune écriture. |
HDS_PATIENT | Patient | Lire les coffres auxquels il a accès, y déposer des documents, lire leurs consentements, exporter leurs données. |
HDS_STORAGE | Stockage technique | Créer des coffres, déposer des documents, organiser les dossiers, lire les partages. Destiné aux comptes qui alimentent des coffres non nominatifs. |
HDS_DELETE | Suppression | Supprimer des documents, des dossiers et ses propres coffres, révoquer les partages qu'il a accordés. À combiner avec un autre rôle. |
La matrice complète, opération par opération, est dans la référence.
Propriété et partage
Pour tout ce qui concerne un coffre précis, le module vérifie en plus que l'utilisateur :
- en est le propriétaire (il l'a créé), ou
- est le destinataire d'un partage actif sur ce coffre.
Cette règle vaut aussi pour HDS_ADMIN : être administrateur HDS ne donne pas la lecture des coffres des autres. Certaines opérations sont réservées au seul propriétaire : modifier, supprimer un coffre.
Le cas du patient
Le coffre d'un patient appartient à celui qui le crée, en général un professionnel de santé. Pour que le patient consulte son dossier depuis votre application, partagez le coffre avec son identifiant Keycloak. Le rôle HDS_PATIENT seul ne relie pas automatiquement un patient à son coffre.
Attribuer un rôle
Un administrateur ne peut attribuer que les rôles HDS qu'il possède lui-même. En pratique, désignez un HDS_ADMIN par client, qui attribue ensuite les rôles aux autres utilisateurs. Voir Attribuer les rôles.
Exemples
| Personne | Rôles recommandés |
|---|---|
| Médecin | HDS_HEALTHCARE, HDS_MEDICAL |
| Secrétaire médicale | HDS_STORAGE |
| Patient | HDS_PATIENT |
| Responsable de la conformité de l'établissement | HDS_ADMIN |
| Médecin habilité à supprimer des documents | HDS_HEALTHCARE, HDS_MEDICAL, HDS_DELETE |