VIGIL MESH

Documentation

Gérer les devices et leur cycle de vie

Un device est une machine enrôlée dans un réseau : elle y reçoit une identité durable, une adresse stable et un nom interne. Depuis la console, vous suivez toute sa vie — de l'enrôlement à la révocation — en passant par le renommage et la suspension temporaire. Cette page décrit les trois façons d'enrôler une machine, les statuts par lesquels elle peut passer, le renommage via MagicDNS et ce que produit une révocation.

Enrôler une machine

Enrôler, c'est rattacher une machine à un réseau et lui donner son identité dans le mesh. VIGIL-MESH propose trois méthodes selon le degré de contrôle voulu ; elles se règlent dans la console et se posent ensuite sur la machine à l'aide du client. La procédure complète côté machine est décrite dans /docs/demarrer-enrolement.

  1. 1
    Clé pré-autoriséeUne clé émise à l'avance, à usage limité (nombre d'enrôlements et durée de validité bornés), pratique pour préparer un lot de machines ou automatiser un déploiement. La machine qui la présente rejoint le réseau sans validation manuelle supplémentaire.
  2. 2
    Invitation à durée courteUn lien ou un code d'invitation à durée de vie brève, destiné à faire rejoindre une personne ou une machine ponctuelle. L'invitation expire d'elle-même, ce qui évite les jetons oubliés qui traînent.
  3. 3
    File d'approbationLa machine demande à rejoindre, et un administrateur approuve explicitement depuis la console. C'est le mode le plus contrôlé : aucune machine n'entre sans un accord humain tracé dans l'audit.

Le cycle de vie : les statuts d'un device

Une fois enrôlée, une machine porte un statut qui décide de sa place dans le réseau. Le statut est piloté depuis la console et se propage aux autres membres via la carte réseau signée : changer un statut, c'est changer ce que les pairs sont autorisés à faire avec cette machine.

StatutCe qu'il signifieEffet sur le réseau
ActifLa machine est enrôlée et autorisée à participer.Elle reçoit son adresse, résout et se fait résoudre par MagicDNS, et communique selon la politique d'accès.
SuspenduMise à l'écart temporaire, sans perdre son identité ni son adresse.Ses sessions sont coupées et elle ne peut plus joindre le réseau ; on peut la réactiver plus tard sans réenrôler.
RévoquéRetrait définitif de la confiance accordée à la machine.Son identité n'est plus acceptée : elle doit être réenrôlée pour revenir, avec une nouvelle identité.
ExpiréL'autorisation attachée à la machine a atteint son terme.Elle est traitée comme non autorisée jusqu'à renouvellement ; utile pour des accès à durée bornée.

Renommage et MagicDNS

On joint rarement une machine par son adresse : chacune porte un nom court résolu localement par MagicDNS, sans qu'aucune requête DNS ne quitte le nœud. Depuis la console, vous renommez une machine et ce nom devient la façon canonique de la désigner à l'intérieur du réseau.

  • Choisissez des noms parlants et stables : ils servent d'adresse pratique et se retrouvent dans l'audit comme dans la topologie.
  • Le renommage change le nom interne, pas l'identité cryptographique ni l'adresse stable de la machine.
  • Un nom clair par rôle et par site (par exemple la fonction et l'emplacement) évite les confusions quand la flotte grandit.

Le fonctionnement détaillé de l'adressage et de la résolution de noms — plages d'adresses, résolution strictement locale — est traité dans /docs/adressage-dns et /docs/config-magicdns.

Révocation immédiate

Quand une machine doit partir — perte, vol, fin de mission, compromission suspectée — la révocation retire la confiance qui lui était accordée. C'est une action explicite d'administration, tracée dans l'audit.

La révocation prend effet immédiatement : la nouvelle carte réseau signée qui exclut la machine se distribue aux membres, ses sessions en cours sont coupées et son identité n'est plus acceptée. Pour la faire revenir, il faut la réenrôler, ce qui lui donne une nouvelle identité — l'ancienne ne redevient jamais valide.

Une machine suspendue garde-t-elle son adresse ?
Oui. La suspension met la machine à l'écart sans détruire son identité ni son adresse stable : à la réactivation, elle retrouve sa place sans réenrôlement.
Combien de temps une révocation met-elle à s'appliquer ?
Elle est immédiate : la carte réseau signée mise à jour est distribuée aux membres et les sessions de la machine révoquée sont coupées, sans attendre une expiration.
Le renommage casse-t-il les connexions en cours ?
Non. Renommer change le nom interne résolu par MagicDNS, pas l'identité ni l'adresse de la machine ; les sessions établies ne sont pas interrompues.
Lire ensuiteTopologie temps réel

In English

A device is a machine enrolled into a network, where it gets a durable identity, a stable address and a short internal name. Enrolment comes in three flavours — pre-authorised keys, short-lived invitations and an approval queue — and none of them opens an inbound port.

From the console you follow a device through its statuses: active, suspended (a reversible aside that keeps identity and address), revoked (a permanent withdrawal of trust that requires re-enrolment) and expired. Renaming updates the MagicDNS name without touching identity or address, and revocation takes effect immediately.