Aller au contenu

Guide de sécurité

Périmètre : l’application desktop HeelonVault (crates/heelonvault-core, crates/heelonvault-app).

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.

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

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.

Le champ unique de login accepte :

  1. username (priorite 1)
  2. email (priorite 2)
  3. display_name (priorite 3)

La politique d’echec est appliquee sur le username canonique resolu.

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

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.

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.

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.

Lorsque l’application demarre sans compte administrateur, un assistant en 3 etapes est presente :

  1. Etape identite — saisie du nom d’utilisateur et du mot de passe (force minimale verifiee, confirmation requise) ;
  2. 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 ;
  3. 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_VIOLATION dans libgtk-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. Voir crates/heelonvault-app/src/ui/sensitive_clipboard.rs.
  • apres le bootstrap, la cle peut etre re-exportee depuis Profil & Securite (admin uniquement) ;
  • les exports/imports .hvb sont soumis au BackupApplicationService qui applique un controle RBAC : seuls les comptes de role admin peuvent effectuer ces operations.

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.

Avant release :

  1. cargo check
  2. cargo test
  3. Suites ciblees :
    • tests/security_auth.rs
    • tests/security_crypto.rs
    • tests/totp_activation_integration.rs
    • tests/twofa_messages_integration.rs
    • tests/backup_security_integration.rs

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.

  • P1 Critique : traitement immediat, objectif <= 7 jours
  • P2 Haut : objectif <= 14 jours
  • P3 Moyen : objectif <= 30 jours
  • P4 Bas : meilleur effort dans cycle normal

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 dans deny.toml pour 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 prive heelonvault-premium, pas seulement la crate publique heelonvault-core. Regenere via scripts/generate-sbom.sh et commite sous sbom.cyclonedx.json a la racine du depot ; le job CI check-sbom le 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.yml joint heelonvault-sbom-<tag>.cyclonedx.json et son .sha256 a 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 : contacter support@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.