Documentation HealthGuard — version bêta
Une plateforme de santé numérique conçue pour protéger la confidentialité de vos documents grâce à la blockchain et au chiffrement de bout en bout.
Vue d'ensemble
HealthGuard est une application décentralisée (dApp) révolutionnaire qui permet aux patients et aux professionnels de santé de gérer, partager et consulter des dossiers médicaux en toute sécurité.
Nous ne pouvons pas lire vos documents
HealthGuard ne détient aucune clé capable d'ouvrir vos documents.
Sans serveur de clés
Aucun serveur ne détient vos clés ni ne lit vos documents ; identités, clés publiques et pointeurs : sur la blockchain
Chiffrement E2E
Fichiers chiffrés avant de quitter votre navigateur
Basé sur blockchain
Permissions et relations de soin ancrées de façon immuable
Maîtrise de vos accès
Vous ouvrez et retirez les accès à votre dossier, hors accès d'urgence
Sans frais
Account Abstraction avec transactions sponsorisées
Réserve : Notre clé d'administration sur les registres de clés publiques permettrait de détourner des envois futurs, jamais d'ouvrir ce qui a déjà été envoyé. Voir la page Sécurité, §10.
Pourquoi HealthGuard ?
❌ Le problème actuel
- • Serveurs centralisés que vous ne contrôlez pas
- • Bases de données cibles privilégiées pour les pirates
- • Administrateurs ont accès à vos dossiers
- • Millions de dossiers compromis chaque année
- • Aucun contrôle sur qui accède à vos données
✅ La solution HealthGuard
- • Zéro connaissance : sans les clés, le contenu est illisible. Exceptions pour les soignants admis : relation d'urgence ouverte sans votre accord par un professionnel admis au dispositif d'urgence (24 heures, mais ce qui a été délivré reste lisible) ; fiche d'urgence à deux facteurs, lisible sans votre accord par un professionnel admis qui scanne votre carte (sans échéance)
- • Chiffrement côté client dans votre navigateur
- • Clés dérivées de votre signature de portefeuille
- • Stockage chiffré : Amazon S3 (région UE), IPFS en option de résilience
- • Accès et partages ancrés sur la blockchain, vérifiables publiquement
Architecture technique
HealthGuard repose sur une architecture décentralisée combinant frontend React, smart contracts déployés sur Base Sepolia (réseau de test) et stockage chiffré (Amazon S3 en région UE ; IPFS en option de résilience).
Diagramme d'architecture complet
┌─────────────────┐
│ NAVIGATEUR │
│ (Frontend) │
│ │
│ ┌───────────┐ │ ┌─────────────────────────────────────┐
│ │ Next.js │ │ │ SMART CONTRACTS │
│ │ React 18 │ │ │ (Base Sepolia, test) │
│ │TypeScript │ │ │ │
│ └─────┬─────┘ │ │ ┌────────────────────────────────┐ │
│ │ │ │ │ ScopeKeyRegistryV1 │ │
│ ┌─────▼─────┐ │ │ │ - initializeScopeKeys() │ │
│ │ Web Crypto│ │ │ │ - hasInitializedKeys() │ │
│ │ API │◄─┼──────┼─▶│ - (clés chiffrées, clé maître) │ │
│ │ AES-256 │ │ │ └────────────────────────────────┘ │
│ └─────┬─────┘ │ │ │
│ │ │ │ ┌────────────────────────────────┐ │
│ ┌─────▼─────┐ │ │ │ EncryptionKeyRegistryV6 │ │
│ │ML-KEM-768 │ │ │ │ - setPatientHybridPubKey() │ │
│ │ + X25519 │◄─┼──────┼─▶│ - hasHybridKey() │ │
│ │ hybride │ │ │ └────────────────────────────────┘ │
│ └─────┬─────┘ │ │ │
│ │ │ │ ┌────────────────────────────────┐ │
│ ┌─────▼─────┐ │ │ │ HealthResourceRegistryV3 │ │
│ │ viem + │ │ │ │ - registerResource() │ │
│ │ wagmi │◄─┼──────┼─▶│ - storeEnvelope() │ │
│ │(Blockchain│ │ │ │ - getEnvelope() │ │
│ │ Connector)│ │ │ │ - getResource() │ │
│ └─────┬─────┘ │ │ └────────────────────────────────┘ │
│ │ │ │ │
│ ┌─────▼─────┐ │ │ ┌────────────────────────────────┐ │
│ │ Account │ │ │ │ RelationRegistryV4 │ │
│ │Abstraction│◄─┼──────┼─▶│ - createRelation() │ │
│ │ (Alchemy) │ │ │ │ - setRelationStatus() │ │
│ │ Gasless │ │ │ │ - openEmergencyRelation() │ │
│ └───────────┘ │ │ └────────────────────────────────┘ │
│ │ │ │
│ │ │ ┌────────────────────────────────┐ │
│ │ │ │ SharedKeyVaultV2 │ │
│ │ │ │ - setSharedKey() │ │
│ │ │ │ - getSharedKey() │ │
│ │ │ └────────────────────────────────┘ │
│ │ └─────────────────────────────────────┘
└────────┬────────┘
│
│ HTTPS (chiffré)
▼
┌─────────────────────────────────────┐
│ API ROUTES (Next.js) │
│ URL signées S3 | /api/ipfs-upload │
└────────┬────────────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Amazon S3 (UE) | IPFS (Pinata) │
│ - S3 principal / IPFS résilience │
│ - (IPFS) Content Addressing (CID) │
│ - Fichiers CHIFFRÉS uniquement │
└─────────────────────────────────────┘Flux d'upload d'un document médical
📁 Fichier original : ordonnance.pdf (250 KB)
↓
↓ [DANS LE NAVIGATEUR DU MÉDECIN]
↓
1. Lecture du fichier en mémoire (ArrayBuffer)
2. Calcul de l'empreinte SHA-256 → "d4f2a9b8c3e1..."
(sur le fichier d'origine)
3. Bourrage au palier de taille supérieur
(256 Kio minimum)
4. Génération Clé de Document aléatoire (32 octets)
et IV aléatoire (12 octets pour AES-GCM)
5. Chiffrement AES-256-GCM
→ Fichier chiffré (palier + 16 octets auth tag)
↓
↓ [UPLOAD VERS LE STOCKAGE]
↓
🌐 Adresse signée Amazon S3 (ou /api/ipfs-upload si IPFS)
↓
🔗 Dépôt chez Amazon S3 (UE) ou Pinata (IPFS)
↓
📦 Fichier stocké (objet S3 ou IPFS)
- Identifiant : QmXyZ123abc... (CID si IPFS)
- Avec IPFS : réplication possible sur plusieurs nœuds
↓
↓ [ENREGISTREMENT BLOCKCHAIN]
↓
⛓️ Smart Contract HealthResourceRegistryV3
- registerResource()
- Enregistré : le pointeur vers le
fichier chiffré (S3 et/ou IPFS) et
des métadonnées elles aussi chiffrées
↓
✅ Ressource enregistrée sur la blockchainFlux de consultation d'un document
👤 Patient ouvre l'application HealthGuard
↓
1. Connexion avec portefeuille (email/social/passkey)
↓
2. Signature du message de dérivation
(versionné, servi par la configuration serveur)
→ Dérivation Clé Maître en RAM
↓
3. Signature dédiée (EIP-191, déterministe)
→ Dérivation paire de clés hybride
ML-KEM-768 + X25519 en RAM
↓
↓ [LECTURE DEPUIS LA BLOCKCHAIN]
↓
⛓️ Requêtes aux smart contracts
- HealthResourceRegistryV3 :
getResource(), getEnvelope()
- ScopeKeyRegistryV1 : clés de scope
↓
↓ [DANS LE NAVIGATEUR DU PATIENT]
↓
📋 Affichage de la liste des documents
✅ ordonnance.pdf - remise par un professionnel
(nom déclaré par lui)
↓
↓ [PATIENT CLIQUE SUR LE DOCUMENT]
↓
🔓 Ouverture de l'enveloppe hybride
(documents reçus d'un tiers)
1. Clé secrète hybride (en RAM) +
texte chiffré KEM de l'enveloppe
2. Décapsulation ML-KEM-768 + X25519
→ secret partagé → clé d'emballage
(HKDF-SHA256)
3. Déchiffrement AES-256-GCM
4. → clé de scope, qui désenveloppe la
clé de document ; ou directement la
clé de ressource (= clé du fichier)
Vos propres documents s'ouvrent par la
hiérarchie Clé Maître → scope → document
↓
🌐 Téléchargement depuis le stockage (S3 ou IPFS)
ex. IPFS : passerelle dédiée Pinata
(…/ipfs/QmXyZ123abc...)
↓
🔓 Déchiffrement AES-256-GCM, puis
retrait du bourrage
→ Fichier PDF original (250 KB)
↓
🔍 Empreinte SHA-256 comparée et affichée
(avertissement en cas de discordance)
↓
📄 Affichage du PDF dans le navigateur
✅ Patient peut lire son ordonnanceDiagramme de séquence : Partage par QR Code
Patient Smart Contract Médecin │ │ │ │ │ Montre son QR │ │ │ d'identité │ │◀─────────────────────────────┼────────────────────────│ │ Scanne, choisit les │ │ │ catégories et la durée │ │ │ createRelation() │ │ │─────────────────────────────▶│ │ │ Scelle la clé de scope │ │ │ setSharedKey() │ │ │─────────────────────────────▶│ │ │ Invitation (QR ou lien) │ │ │──────────────────────────────┼───────────────────────▶│ │ │ │ │ │ acceptRelation() │ │ │◀───────────────────────│ │ │ Relation active │ │ │───────────────────────▶│ │ │ │ │ setRelationStatus(id, 3) │ │ │─────────────────────────────▶│ │ │ │ Accès retiré dans │ │ │ l'application │ │ │───────────────────────▶│ │ │ Ce qui a été partagé │ │ │ reste ouvrable │
Une révocation retire l’accès pour la suite, mais ne rend pas indéchiffrable ce qui a déjà été partagé : le professionnel a pu conserver une copie de la clé reçue. Renouveler la clé de la catégorie ferme cette catégorie pour la suite — les documents que vous y déposerez ensuite ne seront plus ouvrables par ceux à qui l’ancienne clé avait été partagée. Cela ne reprend pas les documents déjà partagés — qu’ils aient été ouverts ou non — et ne rechiffre pas les fichiers déjà déposés.
Une échéance ferme l’accès pour la suite — elle ne rend pas illisible ce qui a déjà été partagé.
Flux de chiffrement hiérarchique complet
📱 Signature du portefeuille
↓
↓ HKDF-SHA256
↓
🔐 Clé Maître (AES-256)
│ [Existe uniquement en RAM]
│
├──→ Dérive (HKDF-SHA256) Clé Catégorie 0 (Ordonnances)
├──→ Dérive Clé Catégorie 1 (Comptes-rendus)
├──→ Dérive Clé Catégorie 2 (Biologie)
├──→ Dérive Clé Catégorie 3 (Imagerie)
├──→ Dérive Clé Catégorie 4 (Certificats)
├──→ Dérive Clé Catégorie 5 (Documents administratifs)
└──→ Dérive Clé Catégorie 6 (Autres)
Chaque clé est publiée chiffrée sous la Clé Maître
dans ScopeKeyRegistryV1 ; la clé relue est revérifiée
par re-dérivation (les clés transcodées de l'ancien
registre, elles, sont aléatoires)
↓
🗝️ Clé de Catégorie (AES-256)
│
├──→ Désenveloppe Clé Document 1 ←── Métadonnées chiffrées (HealthResourceRegistryV3)
├──→ Désenveloppe Clé Document 2
└──→ Désenveloppe Clé Document 3
↓
📄 Clé de Document (AES-256)
│
└──→ Déchiffre fichier médical ←── Stockage
↓
✅ Fichier PDF lisibleArchitecture de sécurité
Principe fondamental : Architecture "Zero-Knowledge"
HealthGuard est conçu selon un principe simple : aucune clé de déchiffrement n'est jamais stockée en clair. Ce qui est publié sur la chaîne, ce sont des clés chiffrées : les clés de catégorie sous votre clé maître, les clés de document enveloppées sous les clés de catégorie, et les enveloppes de clé scellées vers les destinataires. L'exception, voulue par conception : le facteur « carte » de la fiche d'urgence à deux facteurs, un secret imprimé sur une carte que vous portez, hors de l'application.
┌─────────────────────────────────────────────────┐ │ LE DÉCHIFFREMENT SE FAIT CHEZ VOUS │ │ │ │ Portefeuille → Blockchain → S3/IPFS │ │ (Signature) (Métadonnées) (Fichiers │ │ chiffrées) chiffrés) │ │ │ │ Aucune clé en clair, hors facteur « carte » │ │ Clé maître et paire hybride : re-dérivées à │ │ chaque session. Clés de document : aléatoires │ └─────────────────────────────────────────────────┘
Comment cela fonctionne ?
- 1Vous vous connectez avec votre portefeuille (email, Google, passkey)
- 2Votre portefeuille signe un message de dérivation (versionné, servi par la configuration serveur, rotatif)
- 3Cette signature est transformée en clé via HKDF-SHA256
- 4La clé existe uniquement en mémoire pendant la session
- 5Vous fermez l'onglet ? La clé disparaît
- 6Vous vous reconnectez ? La même signature reproduit la même clé
Système de chiffrement hiérarchique
HealthGuard utilise un système de chiffrement à 3 niveaux pour maximiser la sécurité et la flexibilité.
Clé Maître (Master Key)
- • Algorithme : AES-256-GCM
- • Dérivation : HKDF-SHA256 depuis signature de portefeuille
- • Stockage : JAMAIS stockée (uniquement en RAM)
- • Utilisation : Dériver les Clés de Catégorie, et protéger leur publication (elles sont publiées chiffrées sous elle)
Clés de Catégorie
Pour organiser vos documents, HealthGuard utilise 7 catégories médicales. Chaque clé de catégorie est dérivée de la Clé Maître par HKDF-SHA256, puis publiée chiffrée sous elle ; la clé relue est revérifiée par re-dérivation. Les clés reprises de l'ancien registre font exception : elles sont aléatoires.
Clés de Document
Chaque fichier médical que vous uploadez reçoit sa propre clé de chiffrement unique. La clé est générée aléatoirement, utilisée pour chiffrer le fichier, puis "enveloppée" avec la Clé de Catégorie correspondante.
Transit et stockage des données
Points critiques de sécurité dans le transit
| Étape | Qui peut voir ? |
|---|---|
| Navigateur médecin | ✅ Le médecin, dans sa session (le clair n'existe qu'en mémoire) |
| Stockage (Amazon S3 / réseau IPFS) | ❌ Ne voit que du chiffré |
| Blockchain | ❌ Métadonnées chiffrées |
| Navigateur patient | ✅ Le patient, dans sa session — et les professionnels auxquels il a ouvert un accès. Exceptions : relation d'urgence ouverte sans votre accord par un professionnel admis au dispositif d'urgence (24 heures, mais ce qui a été délivré reste lisible) ; fiche d'urgence à deux facteurs, lisible sans votre accord par un professionnel admis qui scanne votre carte (sans échéance) |
| Créateur HealthGuard | ❌ HealthGuard ne détient aucune clé capable d'ouvrir vos documents. Notre clé d'administration sur les registres de clés publiques permettrait de détourner des envois futurs, jamais d'ouvrir ce qui a déjà été envoyé. Voir Sécurité §10. |
Architecture Zero-Trust
- ❌ HealthGuard ne détient aucune clé capable d'ouvrir vos documents (réserve : notre clé d'administration, voir Sécurité §10)
- ❌ Les validateurs de la blockchain ne voient que des données chiffrées et des identifiants opaques
- ❌ Les hébergeurs de stockage (Amazon S3, nœuds IPFS) ne voient que du contenu chiffré
- ✅ Ce qui protège le contenu, c'est la cryptographie. Ses limites — accès d'urgence, partages déjà effectués, signatures ECDSA — sont dites sur cette page et sur la page Sécurité
Conformité RGPD
HealthGuard est conçu nativement pour respecter le Règlement Général sur la Protection des Données (RGPD) de l'Union Européenne.
Privacy by Design
Chiffrement par défaut, pas optionnel
Minimisation des données
Seules les métadonnées minimales stockées
Retrait d'un document
Retirer un document retire l'état courant et la découvrabilité — pas les octets déjà déposés chez le service de stockage (Amazon S3 et/ou IPFS), ni les données des transactions passées
Droit de portabilité
Téléchargement de vos documents un par un, déchiffrés ; pas d'export groupé à ce jour
Intégrité
AES-256-GCM + empreinte SHA-256 (avertissement en cas de discordance)
État des permissions
Relations et partages ancrés on-chain ; les ouvertures de documents faites depuis l'application laissent un reçu (voir ci-dessous)
Ouvertures de vos documents — Par un professionnel, depuis l’application.
Cette liste montre les ouvertures faites depuis l’application HealthGuard. Un professionnel à qui vous avez donné une clé peut aussi déchiffrer un document en dehors de l’application : cela n’y laisse aucune trace. Retirer un accès reste le geste qui compte : il ferme l’avenir, mais ne reprend pas ce qui a déjà été déchiffré.
Les lectures faites en urgence (carte du Patient + admission du professionnel) sont listées à part, dans l’espace du Patient sur l’application HealthGuard — pas dans la liste ci-dessus. Pour savoir si un accès d’urgence est actuellement ouvert avec un professionnel, le Patient consulte « Mes partages » dans ce même espace. Voir les lectures d’urgence dans mon espace
L'exercice de vos droits est détaillé sur la page RGPD, et ce qu'un retrait retire exactement sur la page Sécurité.
Fonctionnalités principales
Pour les patients
Upload de documents
Chiffrement automatique avant upload
Gestion du dossier
Vue d'ensemble, filtrage, recherche
Partage par QR Code
Durée configurable ; retrait d'accès possible (voir l'encadré ci-dessous)
Accès d'urgence
Deux dispositifs distincts : relation d'urgence (24 heures) et fiche d'urgence à deux facteurs (sans échéance)
Une révocation retire l’accès pour la suite, mais ne rend pas indéchiffrable ce qui a déjà été partagé : le professionnel a pu conserver une copie de la clé reçue. Renouveler la clé de la catégorie ferme cette catégorie pour la suite — les documents que vous y déposerez ensuite ne seront plus ouvrables par ceux à qui l’ancienne clé avait été partagée. Cela ne reprend pas les documents déjà partagés — qu’ils aient été ouverts ou non — et ne rechiffre pas les fichiers déjà déposés.
Une échéance ferme l’accès pour la suite — elle ne rend pas illisible ce qui a déjà été partagé.
Deux exceptions existent, que nous préférons dire. Un professionnel admis au dispositif d'urgence, et doté d'une identité professionnelle, peut ouvrir une relation d'urgence sans votre accord préalable : elle se clôt après 24 heures, mais ce qui a été délivré reste lisible. Et si vous avez scellé votre fiche d'urgence à deux facteurs, un professionnel admis qui scanne votre carte peut la lire sans votre accord, sans échéance ni révocation effective : retirer une admission ou sceller de nouveau la fiche ne referme rien, seule une nouvelle carte (nouveau facteur) le fait (voir la page Sécurité, fiche d'urgence).
Pour les professionnels
Enregistrement pro
NFT d'identité professionnelle, émis après une autorisation de mint accordée par l'administrateur ; le nom est déclaré par le professionnel, HealthGuard ne le vérifie pas
QR Code
Présenter son QR d'identité, puis ouvrir et accepter l'invitation du patient
Création pour patients
Auto-partage cryptographique hybride (ML-KEM-768 + X25519)
Gestion des accès
Liste de qui a accès ; les ouvertures de documents faites depuis l'application laissent un reçu, un déchiffrement hors de l'application n'en laisse aucun
🔗 Fonctionnalités blockchain
Smart Contracts (liste non exhaustive) : ScopeKeyRegistryV1, EncryptionKeyRegistryV6 / ProEncryptionKeyRegistryV6, SharedKeyVaultV2, HealthResourceRegistryV3, RelationRegistryV4, AccessReceiptRegistryV3, ProAdmissionRegistryV1, EmergencyGroupKeyRegistryV2, PatientDataV3, HGPatientNFTV4, HGProNFTV3
Transactions sans frais : compte intelligent EIP-7702 (portefeuille embarqué Privy), gas sponsorisé via l'infrastructure ERC-4337
NFTs médicaux : Patient NFT, Professional NFT (identités non transférables) ; les documents ne sont plus des NFT
© 2026 HealthGuard - Tous droits réservés.
Cette documentation est la propriété intellectuelle de HealthGuard. Toute reproduction, distribution ou utilisation non autorisée est strictement interdite.
