Guide de sécurité
Périmètre : l’application desktop HeelonVault (crates/heelonvault-core, crates/heelonvault-app).
1. Perimetre et modele de menace
Section intitulée « 1. Perimetre et modele de menace »HeelonVault est un gestionnaire de secrets desktop local-first.
Limites du Centre de sécurité et des contrôles de liens
Section intitulée « Limites du Centre de sécurité et des contrôles de liens »Le Centre est local : robustesse/réutilisation pour les mots de passe, expiration et format d’URL pour les métadonnées. Les données absentes/corrompues sont signalées, jamais assimilées à un résultat sain. Les rapports ne contiennent ni clair ni empreinte de mot de passe et sont effacés au verrouillage. Ils ne certifient pas l’absence de compromission.
Les contrôles réseau des URL restent désactivés jusqu’au consentement pour un contrôle
individuel dans l’éditeur. La crate séparée heelonvault-url-check résout et contacte
uniquement des destinations publiques et valide une négociation TLS par les racines de
confiance embarquées. Elle n’envoie ni requête HTTP, chemin, paramètres, identifiants ou
cookies. Le résolveur DNS et le site peuvent observer le domaine et l’IP du client. Les
destinations internes sont bloquées. Un succès TLS signifie seulement que le certificat
était valide pour cet hôte lors du contrôle ; ni réputation, révocation via OCSP/CRL en
ligne, existence de page ou légitimité du site ne sont évaluées. Aucun fournisseur de
réputation activé. L’invariant Core sans réseau reste testé.
Les vérifications facultatives de mise à jour de l’application relèvent de la couche App, pas de Core. Les vérifications automatiques exigent un consentement explicite, enregistré pour chaque utilisateur du système d’exploitation, et se limitent à une tentative toutes les 24 heures au démarrage ; le profil propose une vérification manuelle ponctuelle. Les requêtes visent uniquement l’API des releases GitHub officielle, en HTTPS, sans jeton ni donnée de coffre, de compte ou de licence. GitHub peut observer l’IP du client. Les redirections sont refusées ; la durée de la requête et la taille de la réponse sont bornées. Seules les versions semver stables sont prises en compte, et les liens de release utilisent le dépôt officiel fixe. La fonction ne télécharge ni n’installe aucun paquet et n’atteste pas leur authenticité. Une erreur réseau ou de configuration n’est jamais présentée comme un résultat « à jour ».
Objectifs securite :
- proteger les secrets au repos ;
- proteger les materiaux d’authentification ;
- limiter les tentatives de brute force ;
- reduire les fuites accidentelles en UI et logs ;
- garantir la securite de session (auto-lock et deconnexion explicite).
Hypothese principale : si le compte OS est compromis pendant que l’app est deverrouillee, l’impact attaquant reste eleve.
2. Cryptographie (Rust)
Section intitulée « 2. Cryptographie (Rust) »Primitives actuelles (src/services/crypto_service.rs) :
- KDF : Argon2id (v=19)
- Parametres par defaut : memoire 64 MiB, time cost 3, parallelisme 1
- Cle derivee : 32 octets
- Salt : 32 octets
- Chiffrement : AES-256-GCM
- Nonce : 12 octets aleatoires par chiffrement
- RNG :
getrandom(CSPRNG noyau) - Buffers sensibles :
secrecy+zeroize
3. Authentification
Section intitulée « 3. Authentification »Modele courant (src/services/auth_service.rs) :
- mot de passe clair present uniquement en memoire volatile ;
- verification avec comparaison en temps constant ;
- stockage via enveloppe versionnee (
users.password_envelope) ; - aucune persistance du mot de passe en clair.
4. Identifiant de login
Section intitulée « 4. Identifiant de login »Le champ unique de login accepte :
- username (priorite 1)
- email (priorite 2)
- display_name (priorite 3)
La politique d’echec est appliquee sur le username canonique resolu.
5. Brute force et controles de session
Section intitulée « 5. Brute force et controles de session »Controles actuels (src/services/auth_policy_service.rs) :
- seuil : 5 echecs
- fenetre de blocage : 5 minutes
- compteurs persistants en table
auth_policy - login reussi : reset des compteurs
Session :
- auto-lock par utilisateur : 0, 1, 5, 10, 15, 30 minutes
- retour ecran login sur logout/auto-lock
- verification TOTP obligatoire si 2FA activee
6. Politique de mot de passe
Section intitulée « 6. Politique de mot de passe »Regles actuelles (password_service) :
- longueur min 16, max 128
- minuscule + majuscule + chiffre + symbole
- pas d’espace
- generation par defaut : 24 caracteres
Recommandation operationnelle : utiliser des phrases de passe >= 16 caracteres pour les comptes sensibles.
7. Frontieres de protection des donnees
Section intitulée « 7. Frontieres de protection des donnees »Chiffre en AES-256-GCM :
- payloads secrets
- enveloppes de cles de coffre
- enveloppes de mot de passe
Peut rester en clair pour l’UX/recherche :
- certains metadonnees (titre, tags, URL, etc.)
Recommendation : ne pas placer de secrets sensibles dans ces champs indexables.
8. Etat 2FA
Section intitulée « 8. Etat 2FA »2FA/TOTP est activee de bout en bout :
- activation/desactivation depuis le profil ;
- login en deux etapes (mot de passe puis code TOTP) ;
- secret TOTP stocke chiffre en base.
8.1 Bootstrap initial et cle de recuperation
Section intitulée « 8.1 Bootstrap initial et cle de recuperation »Lorsque l’application demarre sans compte administrateur, un assistant en 3 etapes est presente :
- Etape identite — saisie du nom d’utilisateur et du mot de passe (force minimale verifiee, confirmation requise) ;
- Etape serment (oath) — une phrase mnemotechnique de 24 mots (style BIP39) est generee via
BackupService::generate_recovery_key(). L’utilisateur doit verifier deux mots tires au sort avant de confirmer, prouvant qu’il a bien note la phrase ; - Etape pending —
admin_service::bootstrap_first_admin_with_recovery()s’execute en arriere-plan : creation de la cle de compte, stockee chiffree sous le mot de passe et sous la phrase de recuperation, et enregistrement d’un verificateur de la phrase. Apres succes, aucune session n’est ouverte : la cle de compte est effacee de la memoire et l’ecran de connexion habituel s’affiche, identifiant pre-rempli.
Proprietes de securite de la cle de recuperation :
- generee par un RNG cryptographique (
getrandom) ; - la phrase elle-meme n’est jamais persistee en base (seuls la cle de compte scellee par elle et un verificateur le sont) ; l’utilisateur en est l’unique gardien ;
- la copie presse-papier declenche un effacement automatique apres 60 secondes ; le presse-papier est aussi vide a la fermeture du dialogue ;
- sur Linux/macOS, le contenu du presse-papier est servi a la demande via un fournisseur personnalise qui se met lui-meme a renvoyer un texte vide une fois expire, sans copie non effacee du secret persistant en memoire au-dela de l’expiration. Sur Windows, le backend presse-papier de GDK (OLE/
IDataObject) plante avec ce meme fournisseur (STATUS_ACCESS_VIOLATIONdanslibgtk-4-1.dll, reproduit systematiquement) ; Windows utilise a la place le fournisseur de contenu “eager” natif de GDK : le secret est copie en memoire geree par GDK des la copie, puis efface en ecrasant directement le presse-papier a l’expiration plutot que par auto-effacement du fournisseur a la lecture. Voircrates/heelonvault-app/src/ui/sensitive_clipboard.rs. - apres le bootstrap, la cle peut etre re-exportee depuis
Profil & Securite(admin uniquement) ; - les exports/imports
.hvbsont soumis auBackupApplicationServicequi applique un controle RBAC : seuls les comptes de role admin peuvent effectuer ces operations.
9. Journalisation
Section intitulée « 9. Journalisation »Couverture actuelle :
- historique des connexions reussies (
login_history) ; - traces de seuil d’echec et reset de politique.
Regle : ne jamais journaliser de secrets en clair.
10. Tests securite minimaux
Section intitulée « 10. Tests securite minimaux »Avant release :
cargo checkcargo test- Suites ciblees :
tests/security_auth.rstests/security_crypto.rstests/totp_activation_integration.rstests/twofa_messages_integration.rstests/backup_security_integration.rs
11. Divulgation responsable
Section intitulée « 11. Divulgation responsable »Ne pas ouvrir d’issue publique pour les vulnerabilites.
Canal principal :
security@heelonys.fr
Objet recommande :
SECURITY-HeelonVault : titre court
Merci d’inclure : version impactee, environnement, etapes de reproduction, impact, PoC minimal.
12. Priorisation (mini matrice CVSS)
Section intitulée « 12. Priorisation (mini matrice CVSS) »- P1 Critique : traitement immediat, objectif <= 7 jours
- P2 Haut : objectif <= 14 jours
- P3 Moyen : objectif <= 30 jours
- P4 Bas : meilleur effort dans cycle normal
13. Roadmap de durcissement
Section intitulée « 13. Roadmap de durcissement »Realise :
- Cycle de vie MFA durci : activation/desactivation TOTP entierement implementee
- Flux de recuperation securise : generation de cle avec effacement presse-papier automatique, verification obligatoire, operations de sauvegarde soumises au RBAC
- Journal d’audit pour les actions sensibles (table
audit_log, migration 0013)
Priorites court terme :
- unifier toutes les entrees de politique mot de passe sur >= 16 ;
- documenter les profils de durcissement (standard, admin, haute assurance).
References : ANSSI, OWASP Password Storage Cheat Sheet, NIST SP 800-63B.
14. Securite de la chaine d’approvisionnement et SBOM
Section intitulée « 14. Securite de la chaine d’approvisionnement et SBOM »Verifications automatisees en CI (.github/workflows/supply-chain.yml, a
chaque push sur main, chaque pull request, et quotidiennement) :
cargo-deny: tolerance zero sur les vulnerabilites connues (advisories RUSTSEC), liste blanche de licences (licences permissives uniquement), et interdiction des versions dupliquees d’une meme dependance (avec des exceptions explicitement documentees et revues dansdeny.tomlpour les cas reels de divergence de version dans l’ecosysteme amont).- SBOM (Software Bill of Materials) : un inventaire CycloneDX 1.4 JSON de
chaque dependance reellement livree dans le binaire
heelonvault— y compris les dependances propres a une plateforme (ex : crates Windows uniquement) et le composant priveheelonvault-premium, pas seulement la crate publiqueheelonvault-core. Regenere viascripts/generate-sbom.shet commite soussbom.cyclonedx.jsona la racine du depot ; le job CIcheck-sbomle regenere a chaque push pertinent et fait echouer le build si le fichier commite a divergé du graphe de dependances reel. - SBOM signe des releases : a chaque tag
vX.Y.Z,.github/workflows/sbom-release.ymljointheelonvault-sbom-<tag>.cyclonedx.jsonet son.sha256a la release GitHub, avec une attestation de provenance Sigstore :gh attestation verify heelonvault-sbom-<tag>.cyclonedx.json --repo ppaperso/heelonvault-core. - Composant proprietaire :
heelonvault-premium(verification de licence, administration, equipes, rapport d’audit) est proprietaire et son code source n’est pas public. Il figure dans le SBOM avec ses dependances. Sur demande, les equipes securite d’un client (DSI, RSSI, auditeur mandate) peuvent obtenir un acces en lecture a ce code pour audit, sous accord de confidentialite (NDA) ou equivalent : contactersupport@heelonys.fr.
Contexte reglementaire : le Cyber Resilience Act (CRA) de l’UE introduit des obligations de SBOM et de gestion des vulnerabilites pour les fabricants de produits comportant des elements numeriques, avec une entree en application progressive jusqu’en 2026-2027. Cet outillage est une pratique technique qui soutient cette posture (un inventaire des composants precis, verifie en continu par la CI) — ce n’est pas en soi une determination de conformite legale ni une certification. Confirmer l’applicabilite et les obligations precises aupres d’un conseil juridique.
