# 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.

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](/v1.0/glossaire#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](/v1.0/glossaire#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](/v1.0/hds/reference#permissions-par-rôle).

### 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](/v1.0/hds/attribuer-les-roles).

## 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` |

## Pour aller plus loin

- [Attribuer les rôles HDS](/v1.0/hds/attribuer-les-roles)
- [Partager un coffre](/v1.0/hds/partager-un-coffre)
- [Référence : permissions par rôle](/v1.0/hds/reference#permissions-par-rôle)
