Skip to content

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.

ConceptDeveloper

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ôleFonctionPeut notamment
HDS_ADMINAdministrateur HDS du clientToutes 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_HEALTHCAREProfessionnel 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_MEDICALConsultation médicaleLire les coffres, documents, dossiers et consentements auxquels il a accès. Aucune écriture.
HDS_PATIENTPatientLire les coffres auxquels il a accès, y déposer des documents, lire leurs consentements, exporter leurs données.
HDS_STORAGEStockage techniqueCréer des coffres, déposer des documents, organiser les dossiers, lire les partages. Destiné aux comptes qui alimentent des coffres non nominatifs.
HDS_DELETESuppressionSupprimer 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

PersonneRôles recommandés
MédecinHDS_HEALTHCARE, HDS_MEDICAL
Secrétaire médicaleHDS_STORAGE
PatientHDS_PATIENT
Responsable de la conformité de l'établissementHDS_ADMIN
Médecin habilité à supprimer des documentsHDS_HEALTHCARE, HDS_MEDICAL, HDS_DELETE

Pour aller plus loin