# Chiffrement et traçabilité

> Comment le module HDS chiffre les fichiers, trace chaque opération dans un journal chaîné, vérifie son intégrité et sauvegarde les métadonnées.

Deux garanties fondent le module HDS : le contenu de chaque fichier est chiffré avant d'être stocké, et chaque opération laisse une trace chaînée à la précédente, ce qui permet de détecter une modification.

## Définition

Le **chiffrement** porte sur le contenu des fichiers : chaque document, et chaque version d'un document, est chiffré individuellement en AES-256-GCM avant d'être écrit dans le stockage objet de l'espace du client.

Le **journal d'audit HDS** est la liste, propre à chaque espace, de toutes les opérations effectuées sur les données de santé. Chaque entrée est liée à la précédente par une empreinte HMAC-SHA256, ce qui forme une chaîne.

```mermaid
flowchart LR
  G["GENESIS"] --> A1["aud_1<br/>VAULT_CREATED<br/>entryHash = HMAC(GENESIS | …)"]
  A1 --> A2["aud_2<br/>DOCUMENT_UPLOADED<br/>previousHash = hash de aud_1"]
  A2 --> A3["aud_3<br/>SHARE_CREATED<br/>previousHash = hash de aud_2"]
```

## Pourquoi c'est conçu ainsi

L'hébergement de données de santé exige de pouvoir prouver qui a accédé à quoi, et quand. Une simple table de journaux peut être modifiée par quiconque accède à la base. Avec une chaîne, modifier ou retirer une entrée casse le lien avec la suivante : la vérification d'intégrité le détecte et indique la première entrée invalide.

## Comment ça marche

### Au dépôt d'un document

1. Le module calcule l'empreinte SHA-256 du fichier d'origine (`hashSha256`).
2. Il soumet le fichier à l'[antivirus](/v1.0/antivirus).
3. Il chiffre le contenu en AES-256-GCM, avec un vecteur d'initialisation propre à chaque fichier.
4. Il stocke le fichier chiffré dans l'espace du client et enregistre les métadonnées.
5. Il inscrit l'opération au journal d'audit.

### Ce que contient une entrée du journal

Chaque entrée indique l'horodatage, l'utilisateur, l'adresse IP et le navigateur d'origine, le type d'événement (`eventType`), sa catégorie, l'action, la ressource concernée et le résultat : `SUCCESS`, `FAILURE` ou `DENIED`. Le champ `accessContext` précise les rôles HDS de l'acteur et si l'action vient d'un administrateur.

Les lectures sont journalisées comme les écritures : consulter la liste des documents d'un coffre laisse une trace.

### La vérification d'intégrité

Le module recalcule chaque empreinte de la chaîne, de la première entrée à la dernière :

- tous les jours à 3 h, automatiquement ; une rupture déclenche un événement `AUDIT_CHAIN_BROKEN` ;
- à la demande d'un administrateur HDS, par l'API. Voir [Consulter le journal d'audit](/v1.0/hds/consulter-le-journal-d-audit).

### Les sauvegardes

Chaque nuit à 2 h, le module sauvegarde les métadonnées de chaque espace actif (coffres, documents, dossiers, partages, consentements) dans un fichier chiffré. Les fichiers eux-mêmes restent dans le stockage objet. Un administrateur HDS peut déclencher une sauvegarde et restaurer. Voir [Sauvegarder et restaurer](/v1.0/hds/sauvegarder-et-restaurer).

### La purge

Un document supprimé est conservé 30 jours, puis toutes ses versions sont effacées du stockage par une tâche quotidienne.

### Ce qui n'est pas chiffré par le module

Le chiffrement applicatif porte sur le contenu des fichiers. Les métadonnées servent à rechercher et organiser : libellé du coffre, identité du patient d'un coffre `PATIENT`, noms de fichiers, noms de dossiers, métadonnées personnalisées. N'y placez que ce qui est nécessaire. Voir [Responsabilités du client](/v1.0/hds/responsabilites-du-client).

## Pour aller plus loin

- [Consulter le journal d'audit et vérifier son intégrité](/v1.0/hds/consulter-le-journal-d-audit)
- [Sauvegarder et restaurer les métadonnées](/v1.0/hds/sauvegarder-et-restaurer)
- [Journal d'audit de la plateforme](/v1.0/journal-d-audit)
