Comment nous gérons votre code

Herozion est un scanner de sécurité local-first. L'analyse s'exécute sur votre machine, votre dépôt complet n'est jamais envoyé. Des connexions réseau limitées et documentées (télémétrie anonyme, OSV.dev, auth, push opt-in, ai-fix opt-in) sont décrites ci-dessous.

Connexions réseau documentées

Toute connexion sortante est listée ci-dessous. Vous contrôlez ce qui part via les flags et variables d'environnement.

Ce qui circule sur le réseau (et pourquoi)

Architecture CLI, scan local

Herozion est un outil CLI autonome (package npm et/ou installateurs natifs). Pour analyser votre code, aucun service cloud n'est requis : le moteur tourne sur votre machine. AI Fix est un flux distinct, opt-in, qui appelle un service cloud uniquement lorsque vous le demandez.

AI Fix, provider IA et cache

herozion ai-fix est opt-in. Un extrait (±30 lignes) et des métadonnées partent vers le service AI Herozion (ai.herozion.io), puis vers un provider IA (aujourd'hui Google Gemini ; l'architecture permet de changer de provider). Herozion n'entraîne pas de modèle sur cet extrait.

Selon les conditions Paid Services de l'API Gemini, Google n'utilise pas les prompts ni les réponses pour entraîner ou améliorer ses produits ; un journalnage limité peut exister pour la détection d'abus et les obligations légales. Voir ai.google.dev/gemini-api/terms.

Cache AI Fix (serveurs Herozion)

Pour éviter de reconsommer un crédit sur un même motif, Herozion peut conserver en cache (mémoire / infrastructure Herozion) une empreinte SHA-256 du code normalisé (littéraux anonymisés, sans identifiants métier) associée à la réponse du modèle, jusqu'à 30 jours. Le corps de requête brut n'est pas archivé en base. Un hit de cache = 0 crédit.

Contrôles utilisateur

• Ne pas lancer herozion ai-fix : aucun extrait ne part vers un LLM.
• Confirmation informative une fois par session terminal ; skip CI via --yes-consent / --accept-privacy / -y.
• Consentement durable (VS Code / automation) : ~/.herozion/ai_consent.json ; session : ~/.herozion/ai_consent_session.json.
• À côté de HEROZION_TELEMETRY=0 et --offline pour le scan : ces flags contrôlent AI Fix sans désactiver l'analyse locale.

Chiffrement des rapports et du cache

Les fichiers sensibles stockés par Herozion sur votre machine utilisent un chiffrement fort.

• Cache de licence chiffré, Le cache de licence est chiffré avec une clé dérivée de votre machine (identifiant système unique). Il ne peut pas être réutilisé sur une autre machine.
• Rapports en clair par défaut, Le fichier herozion-report.json est en JSON lisible par défaut pour faciliter l'intégration CI/CD. Utilisez --encrypt-output pour chiffrer le rapport avec votre propre clé.
• Aucune donnée persistée par Herozion, En dehors du cache de licence et du rapport, Herozion ne crée aucun fichier persistant sur votre machine.

Suppression automatique des données

Herozion applique une politique de rétention minimale sur les données qu'il stocke, aussi bien côté serveur que côté client.

Télémétrie & Statistiques d'utilisation

Après chaque herozion scan, Herozion envoie par défaut des statistiques anonymes (score, compteurs, durée, version CLI, OS) pour améliorer le produit, jamais vos chemins de fichiers ni votre code source.

Désactivation et périmètre

Vous gardez le contrôle :

• Opt-out télémétrie : HEROZION_TELEMETRY=0.
• Distinct de herozion push et herozion ai-fix (tous deux opt-in).
• OSV.dev désactivé avec --offline (noms/versions de packages uniquement).
• Auth / licence : herozion login → API Herozion (OTP, /auth/me).
• AI Fix : confirmation par session, ou --yes-consent / ~/.herozion/ai_consent.json.

Format des rapports d'analyse

Le rapport produit par Herozion est un fichier JSON structuré, stocké localement. Il contient exclusivement des résultats d'analyse, jamais le code source lui-même.

Nos engagements

Ces engagements sont des garanties techniques et contractuelles, pas de simples déclarations d'intention.

• Votre code ne nous appartient pas. Herozion n'a aucun droit sur le code que vous analysez. Aucune licence implicite n'est accordée.
• Jamais le dépôt complet. Scan local. Push et AI Fix (opt-in) peuvent envoyer des extraits limités, jamais l'intégralité des sources.
• Transparence sur les changements. Tout changement dans notre collecte de données sera annoncé dans le changelog 30 jours avant son entrée en vigueur.
• Audit accessible. Vous pouvez auditer le comportement réseau de l'outil CLI à tout moment. Nous encourageons la surveillance par la communauté.
• Suppression sur demande. Toutes les données de votre compte (e-mail, inscriptions) sont supprimées sur simple demande à [email protected] dans un délai de 30 jours.
• Pas de revente. Vos données ne sont jamais vendues, louées ou partagées à des fins commerciales avec des tiers.

Questions fréquentes des CTO & équipes sécurité

Les questions que les responsables techniques posent avant d'intégrer un outil de sécurité dans leur pipeline. Réponses directes, sans marketing.