ProxTrace
GitHubDépôt public en préparation Accéder à la console

Sécurité & confiance

Ce que le collecteur lit. Ce qu’il n’écrit jamais.

Le collecteur observe vos hôtes Proxmox VE en lecture seule. Cette page détaille les droits qu’il reçoit, ce qui quitte votre infrastructure, ce qui n’en sort jamais, et comment le vérifier vous-même.

01 · En clair

Quatre affirmations, vérifiables plus bas.

Chacune se vérifie plus bas : matrice des droits, règle sudo et schéma de circulation.

  • Le collecteur lit, il n’écrit jamais : aucune action automatique n’est exécutée sur un nœud, une VM ou un conteneur, et aucun droit d’écriture n’est demandé à Proxmox VE.
  • Aucun canal entrant vers le collecteur : le collecteur ouvre lui-même sa connexion sortante vers la console. Il n’ouvre aucun port et l’API Proxmox n’est jamais exposée sur Internet.
  • Pas de compte root pour lire les hôtes : un compte système dédié, sans mot de passe, limité par une commande forcée et une règle sudo qui interdit tout argument.
  • Les clés d’hôtes sont épinglées : la vérification stricte est active et la mise à jour automatique des clés désactivée ; un jeu de clés modifié est refusé plutôt qu’accepté.

02 · Droits de lecture

Source par source, droit par droit.

Quatre sources alimentent la console. Chacune reçoit le droit minimal nécessaire à sa lecture.

Droits accordés au collecteur 4 sources
Droits de lecture du collecteur, source par source
SourceCe qui est luDroit accordéÉcriture
API Proxmox VE Nœuds, VM et conteneurs, stockages, réseaux, pare-feu, HA, tâches, comptes, rôles, tokens API et certificats. Compte sans mot de passe et jeton séparé, rôle PVEAuditor VM.Audit · Sys.Audit · Datastore.Audit Aucune
Journaux des hôtes Tâches, authentifications et erreurs retenues comme preuve, filtrées sur l’hôte avant envoi. Lecture par le lecteur fixe, sans accès interactif. Aucune
Lecteur SSH Corosync, pmxcfs, systèmes de fichiers, watchdog, Ceph, LVM-thin, ZFS, dépôts APT, compteurs matériels ciblés, et la date d’écriture des fichiers de configuration du cluster, sans leur contenu. Compte système dédié, commande forcée, sudo -n Aucune
Agent invité QEMU Système, services et interfaces de l’invité, selon le profil choisi : désactivé, Essentiel ou Étendue. Optionnel, rôle dédié VM.GuestAgent.Audit Aucune
Les quatre sources sont en lecture ; aucune ne reçoit de droit d’écriture, de création ou de suppression.
  • Une source qui exigerait davantage de privilèges apparaît inaccessible dans Sources & preuves. Aucun droit d’écriture n’est attribué pour la débloquer, et les contrôles qui en dépendent restent « Non évaluable ».
  • Le privilège d’agent invité sans restriction n’est jamais accordé au jeton principal : l’inspection des invités reste bornée au profil choisi.

03 · Compte de lecture

Un compte qui ne peut lancer qu’une seule commande.

Sur chaque hôte préparé, la clé du collecteur ouvre une session sur un compte système dédié qui ne dispose d’aucun shell utilisable. La règle sudo installée est reproduite ici telle quelle.

proxtrace ALL=(root) NOPASSWD: /usr/local/libexec/proxtrace-read ""
La règle sudo installée sur chaque hôte. Les guillemets vides interdisent tout argument.
  • Commande forcée : le fichier de clés autorisées n’accepte que des entrées restreintes pointant vers le lecteur fixe. La commande envoyée par le client est ignorée.
  • Shell inopérant : le shell du compte ne fait que lancer le lecteur et ignore tout argument qu’on lui passerait.
  • Le compte ne possède rien : ni ses clés ni son dossier personnel ne lui appartiennent : il ne peut ajouter une clé ni retirer la commande forcée.
  • Aucun droit élargi : aucune règle sudo générale, aucun groupe supplémentaire et aucune modification de la configuration SSH globale de l’hôte.
  • Aucun paquet installé : l’installation n’installe rien sur les hyperviseurs. Si sudo est absent, le nœud le signale au lieu d’élargir ses droits.
  • Compte existant refusé : un compte du même nom qui n’a pas été créé par ProxTrace, qui est privilégié ou qui appartient à un autre groupe est écarté.

04 · Clés d’hôtes

Chaque hôte est authentifié par une clé épinglée.

Les lectures, les sondes d’installation et les connexions de relais utilisent un alias d’hôte stable, de sorte qu’un changement d’adresse ou d’interface de gestion conserve la même identité attendue.

  • Vérification stricte : la vérification des clés d’hôtes est exigée et leur mise à jour automatique désactivée. Aucun échec de clé ne déclenche d’acceptation automatique.
  • Origine administrative : les clés publiques proviennent des fichiers d’hôte locaux et, pour les pairs, du fichier de confiance de Proxmox par nœud. Une source absente, invalide ou modifiée bloque le nœud concerné.
  • Changement refusé : une modification du jeu de clés d’un nœud connu est rejetée ; ses anciennes clés sont conservées et les autres nœuds continuent de fonctionner.
  • Aucune clé privée copiée : aucun balayage de clés n’est lancé, aucune clé privée d’administration n’est copiée et le fichier de confiance reste administré par root.
  • Connexion partagée : les lectures d’un même nœud passent par une seule connexion SSH, ouverte avec la même clé et la même empreinte d’hôte épinglée ; chaque lecture reste une commande forcée distincte. La connexion est renouvelée au moins toutes les 30 minutes : une clé retirée ou une empreinte modifiée s’applique dans ce délai. Le journal des nœuds n’enregistre pas une session par lecture.

05 · Ce qui sort

Ce qui sort, et ce qui reste chez vous.

Le collecteur transmet le résultat de ses observations et leur preuve. Il ne transmet ni le contenu de vos machines, ni celui de vos sauvegardes.

Ce qui quitte votre infrastructure

  • Les observations normalisées et leurs empreintes : inventaire des nœuds, des machines, des stockages et des réseaux.
  • Les événements avec leur identifiant de tâche, leur nœud, le compte ou le jeton concerné et l’adresse source.
  • Les valeurs avant et après des configurations observées.
  • Les lignes de journal retenues comme preuve d’un événement.
  • L’état du collecteur lui-même : version, fraîcheur des sources et taille de sa file d’envoi.

Ce qui n’en sort jamais

  • Le contenu des disques de vos machines et celui de vos sauvegardes.
  • Le contenu du dossier privé de Proxmox : seules les permissions de ce dossier sont observées.
  • Les lignes brutes des avertissements du noyau : seuls des compteurs ciblés sont transmis.
  • Les données d’une organisation vers une autre : le périmètre est appliqué côté serveur.
  • Une commande venue de la console : il n’en existe aucune à recevoir.

06 · Sens de circulation

Un seul sens de circulation.

Les données remontent de vos hôtes vers la console, jamais l’inverse.

  1. Hôtes Proxmox VEAPI en lecture, journaux filtrés et lecteur fixe exécuté sous le compte restreint.
  2. Agent · nœuds ProxmoxNormalise, déduplique et met en file localement. Une seule destination, en HTTPS.
  3. Console ProxTraceConfirme la réception, normalise et conserve l’historique dans PostgreSQL.
Le flux va des hôtes Proxmox VE au collecteur, puis du collecteur à la console, et jamais dans l’autre sens : la collecte est en lecture seule, aucun canal entrant n’atteint le collecteur, et les observations attendent dans sa file locale si la console est injoignable.
  • Aucune flèche en retour : la console ne dispose d’aucun moyen d’envoyer une commande, un script ou un argument au collecteur. Les capacités du collecteur sont fixes et déterminées par sa version installée.
  • File locale : si la console est injoignable, les observations attendent dans la file locale du collecteur et repartent par lots au rétablissement, sans perte.
  • Retrait après confirmation : la file n’est vidée qu’après réception de la liste exacte des événements acceptés. Une réponse partielle ou invalide conserve les données à réessayer.
  • Tailles bornées : les lots sont plafonnés de part et d’autre, et la compression n’est utilisée que lorsqu’elle raccourcit réellement l’envoi.

07 · Conservation

Où vit l’historique, et ce qui le scelle.

L’historique et les rapports vivent dans la base de la console. Leur durée de vie dépend du déploiement que vous avez choisi.

  • Rapports scellés : l’état d’une date reste consultable tel qu’il a été évalué. Un rapport déjà scellé n’est pas réécrit par une évaluation ultérieure.
  • Une seule base : les observations, les événements et les rapports sont conservés dans PostgreSQL, côté console. En auto-hébergement, cette base et ses sauvegardes vous appartiennent entièrement.
  • Durée de conservation : elle suit la configuration effective du déploiement qui héberge la console, et n’est pas fixée par cette page.

La rétention réglable par organisation, l’export complet des données et la suppression à la demande ne sont pas encore disponibles.

08 · SaaS ou auto-hébergé

La console chez nous, ou chez vous.

Dans les deux cas, le collecteur reste installé dans votre environnement et conserve exactement les mêmes droits de lecture.

SaaS

  • Nous exploitons la console ; vous n’installez que le collecteur dans votre Proxmox VE.
  • Les observations transitent en HTTPS vers une destination unique, fixée à l’enrôlement.
  • Plusieurs organisations cohabitent dans la console, chacune dans son propre périmètre.

Auto-hébergé

  • Serveur, interface et PostgreSQL réunis dans un déploiement Docker Compose, sur votre infrastructure.
  • Aucune observation ne quitte votre réseau : la destination du collecteur est votre propre console.
  • Vous gardez la main sur la base, ses sauvegardes et la durée de conservation.
Découvrir les offres

09 · Limites

Ce que ProxTrace ne fait pas.

  • Administrer Proxmox VE : Proxmox VE reste l’outil d’administration. ProxTrace n’exécute aucune action automatique sur les nœuds ou les machines.
  • Surveiller les métriques en temps réel : le suivi continu du processeur, de la mémoire et du réseau reste le rôle de vos outils de monitoring.
  • Certifier une infrastructure : les contrôles évaluent des bonnes pratiques et conservent les preuves disponibles ; cette évaluation ne constitue pas une certification.
  • Suivre un autre hyperviseur : ProxTrace est conçu pour Proxmox VE uniquement, qu’il s’agisse d’un cluster ou d’un hôte seul.
Explorer les fonctionnalités

Une question sur les droits du collecteur ou sur les données transmises ?

contact@proxtrace.com