Aller au contenu

Sécurité ​

Ce document décrit contre qui Virtum protège, ce qu'il garantit, et ce qu'il ne peut pas garantir. Chaque garantie est rattachée au code qui la porte et aux tests qui la vérifient : une régression doit faire échouer un test.

Modèle de menace ​

Virtum est une CLI lancée par un utilisateur de l'hôte. Elle pilote qemu:///system (libvirt système), lance virtiofsd, socat, ssh et ansible-playbook sous cet utilisateur.

ActeurCe qu'il contrôleConfiance
L'invité d'une VM (adversaire principal)Tout ce qui tourne dans la VM, en root : ses réponses DHCP (nom d'hôte, client-id), l'agent invité, l'ARP, sa clé SSH, le contenu des partages qu'on lui donne en écritureAucune
Une autre VM du réseau de labLe trafic du réseau de lab, ses propres baux DHCPAucune
Une machine du réseau local (VM en bridge, ou ports: en bind: lan)Le trafic du LAN : elle joint directement une VM en bridge, et peut répondre à sa place sur le LANAucune
Un autre compte Unix de l'hôte, hors des groupes libvirt et kvmSes propres fichiersAucune
Le Virtumfile et le playbookCe que Virtum crée, et le code Ansible exécuté sur l'hôteTotale : c'est du code de l'utilisateur
L'utilisateur, root, les membres des groupes libvirt et kvm, libvirt, QEMU, le noyauToutTotale

Usage visé : un poste de développement à un seul utilisateur. Les comptes des groupes libvirt et kvm sont de confiance, car l'accès à qemu:///system vaut presque root (voir Limites). Le réseau, lui, ne l'est pas : les invités, les autres VM et, dès qu'une VM est en bridge ou qu'un port est ouvert sur le LAN, les machines du réseau local sont des adversaires.

Virtum distingue quand même ses objets de ceux d'un autre Virtum sur le même libvirt (G3), pour ne jamais en arrêter ou en supprimer un par erreur.

Garanties ​

#GarantieOù
G1Rien de ce qu'un invité peut modifier n'est exécuté sur l'hôte. Les partages sont en lecture seule par défaut, imposée côté hôte (virtiofsd --readonly, ou virtiofsd sous bubblewrap avec le dossier monté en lecture seule). ansible-playbook tourne sur une copie privée du dossier du playbook, d'où les partages inscriptibles (rw) sont exclus ; un lien qui en sort vers un dossier contenant un partage rw est refusé. Un partage rw ne peut contenir ni le Virtumfile, ni le playbook, ni le fichier requirements, ni une source locale qu'il cite. Les partages ne peuvent pas s'imbriquer, y compris entre labs d'un même état.mounts.rs (start_virtiofsd), ansible.rs (snapshot_project), virtumfile.rs (ensure_host_code_outside_shares)
G2Ce que fournit l'invité ne sert pas à l'identifier. Les baux DHCP sont lus par colonnes (MAC, IP) ; nom d'hôte et client-id sont ignorés. La clé d'hôte SSH est épinglée par VM (HostKeyAlias=<id de la VM>, known_hosts de l'instance) : une autre VM qui obtient l'IP présente une autre clé et la connexion est refusée.libvirt.rs (parse_dhcp_lease_line), ssh.rs (SshSessionOpts)
G3Virtum ne touche qu'à ses propres ressources. Domaines et réseaux portent un marqueur de propriétaire (métadonnées libvirt) ; un objet marqué par un autre Virtum n'est ni démarré, ni arrêté, ni redéfini, ni supprimé. Un objet sans marqueur n'est touché que s'il utilise le disque de l'instance. Un signal n'est envoyé qu'à un processus de l'utilisateur dont la ligne de commande correspond.ownership.rs, libvirt.rs (refuse_foreign_domain), lab_network.rs, procs.rs
G4Les fichiers d'état ne suivent pas de lien symbolique : écriture atomique (O_EXCL | O_NOFOLLOW puis rename), relecture seulement d'un fichier régulier de l'utilisateur. Clé privée en 0600, répertoire des clés en 0700. La racine d'un partage est fermée aux autres comptes (un invité peut y créer un exécutable setuid de l'utilisateur).fsutil.rs, ssh.rs, mounts.rs (restrict_share_root)
G5Le Virtumfile est validé avant usage : noms (lab, machines, volumes, groupes, instantanés), chemins hôte relatifs et sous le Virtumfile, chemins invité sous /home/virtum, partages non imbriqués. Les valeurs passées à virsh, ssh et cloud-init le sont en arguments séparés, sans shell.virtumfile.rs, mounts.rs, cloud_init.rs
G6Chaque lab a son réseau libvirt isolé (virtum-lab-<nom>). Les ports: n'écoutent que sur 127.0.0.1, sauf bind: lan explicite (confirmé).lab_network.rs, port_forward.rs
G7Aucun secret n'est affiché ni écrit dans les journaux : la clé privée n'est jamais lue par Virtum, seulement passée par chemin à ssh.ssh.rs

Limites ​

Ce que Virtum ne protège pas, et ce qu'il faut faire à la place :

  • Accéder à qemu:///system, c'est presque être root. Être membre du groupe libvirt permet de créer une VM qui monte n'importe quel disque de l'hôte. Ne mettez dans ce groupe que des comptes de confiance.
  • Un Virtumfile est du code. Lancer le Virtumfile ou le playbook d'un inconnu revient à exécuter son code sur votre machine.
  • Partage rw : la VM peut y écrire n'importe quoi. N'exécutez pas sur l'hôte ce qu'elle y dépose, et ne placez pas dans un partage rw un dossier que l'hôte lit (dépôt Git avec hooks, configuration d'un outil…).
  • Ansible : seul le dossier du playbook est copié. Un fichier chargé par chemin absolu, ou par ../ hors de ce dossier, n'est pas protégé par la copie (un ../ échoue, un chemin absolu vers un partage rw serait lu tel quel).
  • Partages créés avant la lecture seule par défaut : le virtiofsd déjà lancé reste en écriture jusqu'à virtum destroy puis virtum up.
  • VM en bridge : elle est sur le LAN comme une machine physique et toutes les machines du réseau peuvent la joindre. Virtum n'y filtre rien : le pare-feu et les services de la VM sont à la charge de l'invité. Préférez un réseau de lab avec des ports: locaux quand la VM n'a pas à être vue du LAN.
  • Premier contact SSH : la clé d'hôte d'une nouvelle VM est enregistrée à la première connexion (confiance au premier usage). Une autre VM du lab, ou une machine du LAN pour une VM en bridge, qui répondrait à sa place à ce moment précis serait épinglée à sa place.
  • Clés SSH épinglées avant HostKeyAlias : la première connexion à une VM existante après la mise à jour enregistre sa clé (confiance au premier usage).
  • --insecure-ssh désactive la vérification de la clé d'hôte. Réservé aux scripts de confiance.
  • virtiofsd tourne toujours avec --sandbox=none, avec ou sans uidmap : il n'est pas confiné au dossier partagé, et une faille de virtiofsd donnerait les droits de l'utilisateur. La lecture seule reste imposée (--readonly ou bubblewrap).
  • Failles de QEMU, libvirt, virtiofsd, du noyau ou des images cloud : hors de portée de Virtum. Tenez l'hôte et les images à jour (virtum pull).

Signaler une faille ​

Écrivez à security@virtum.dev, ou ouvrez un signalement privé (security advisory) sur le dépôt GitHub, avec les étapes pour reproduire et la version concernée (virtum --version). Ne publiez pas de détails d'exploitation avant le correctif.