Installer l'agent Linux
LinGuard 0.1.3 en préproduction : amd64 / x86_64 et ARM64 / aarch64, téléchargement, désinstallation préalable, Flatpak, service hôte et recette.
Édition du 23 octobre 2026. Architectures : amd64 (x86_64) et ARM64 (aarch64).
Ces paquets sont réservés aux postes de recette. Utiliser une machine Linux de bureau dédiée avec systemd, nftables, une session graphique, D-Bus et polkit. Conserver un instantané ou une sauvegarde avant installation. Le service modifie les règles réseau et les magasins de confiance. Les binaires sont compilés avec la clé publique de licence de la préproduction ; les licences, catalogues et modèles restent vérifiés. Les bundles Flatpak ne portent pas de signature de publication.
1. Identifier l'architecture
Dans le terminal de la session utilisateur cible :
uname -mChoisir x86_64 pour amd64 (Intel/AMD 64 bits), ou aarch64 pour ARM64 (dont Raspberry Pi avec un système 64 bits). Les systèmes ARM 32 bits ne sont pas pris en charge.
2. Préparer les prérequis et l'accès
Exemple sur Ubuntu/Debian de bureau, à adapter au gestionnaire de paquets de la distribution :
sudo apt update
sudo apt install flatpak nftables polkitd pkexec openssl
flatpak remote-add --user --if-not-exists flathub \
https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user -y flathub org.gnome.Platform//50Le site et la console de préproduction nécessitent le VPN nominatif et son DNS. La passerelle agents est également exposée en HTTPS pour les postes autorisés hors VPN. Vérifier l'horloge, la résolution de agents.preprod.maelgard.fr et son certificat sans désactiver TLS :
getent hosts agents.preprod.maelgard.fr
openssl s_client -connect agents.preprod.maelgard.fr:443 \
-servername agents.preprod.maelgard.fr \
-verify_return_error </dev/null3. Télécharger les paquets du poste
Ouvrir https://preprod.maelgard.fr/fr/account/downloads avec le compte client membre du tenant. Dans Linux, télécharger le Flatpak et l'archive hôte de la même architecture, ainsi que ce guide. Les liens personnels exigent la session du compte et expirent : recharger la page au besoin.
Placer les fichiers dans un dossier vide puis y ouvrir un terminal. Les commandes suivantes sélectionnent automatiquement le suffixe du système :
ARCH=$(uname -m)
tar -xzf "MaelGard-Linux-host-$ARCH-preprod.tar.gz"
sha256sum -c HOST-SHA256SUMS.txt
sha256sum -c FLATPAK-SHA256SUMS.txtChaque résultat doit être OK. Les empreintes contrôlent l'intégrité ; télécharger uniquement par le canal HTTPS authentifié de préproduction. Arrêter en cas de fichier manquant ou différent.
4. Désinstaller une version existante avant la recette
Si une version est déjà présente, demander son jeton de désinstallation à son administrateur. Le fichier /etc/linguard/install.json conserve uniquement son empreinte SHA-256 : elle ne permet pas de retrouver le jeton. Sudo ne dispense pas de ce contrôle.
Dans un terminal administrateur privé :
read -r -s -p 'Jeton de désinstallation : ' OLD_TOKEN
printf '\n'
sudo /opt/linguard/linguard-svc --uninstall \
--uninstall-token "$OLD_TOKEN"
unset OLD_TOKEN
flatpak uninstall --user -y com.maelgard.LinGuardNe poursuivre que si la désinstallation réussit. Elle retire le service, les binaires, les règles nftables, les stratégies navigateur et la CA locale posés par LinGuard. Sans --purge, les données locales sont conservées ; ajouter cette option seulement pour une recette voulant explicitement supprimer cet état. Les arguments du programme peuvent être visibles temporairement par les administrateurs locaux ; ne pas journaliser la commande avec sa valeur de jeton.
5. Installer le Flatpak sans sudo
Dans la session de l'utilisateur cible, depuis le dossier de téléchargement :
ARCH=$(uname -m)
flatpak install --user -y "./MaelGard-Linux-$ARCH-preprod.flatpak"
flatpak info --user com.maelgard.LinGuardVérifier l'architecture et la version 0.1.3. Le Flatpak fournit l'interface et l'agent de session ; la protection du poste nécessite aussi le service hôte de l'étape suivante.
6. Installer la protection et enrôler
Se connecter à https://console.preprod.maelgard.fr avec un compte autorisé du tenant client. Dans Parc / Enrôlement, créer un jeton à usage unique et de courte durée. Relever le tenant_id. Choisir aussi un nouveau jeton de désinstallation et le conserver dans le gestionnaire de mots de passe. Les deux jetons ont des usages distincts.
Le script livré dans l'archive hôte demande les jetons en saisie masquée. Remplacer la valeur d'exemple par le véritable identifiant du tenant :
sudo bash ./Install-Linux-Preprod.sh --tenant 'TENANT_ID'
flatpak run com.maelgard.LinGuardLe service utilise /opt/linguard, /etc/linguard, /var/lib/linguard et /run/linguard. Il configure systemd, la redirection nftables, la CA locale et les stratégies navigateur. Relancer les navigateurs après installation. Sous GNOME, une extension AppIndicator peut être nécessaire pour afficher l'icône de notification.
7. Vérifier le poste et sa licence
systemctl status linguard --no-pager
sudo /opt/linguard/linguard-admin status
sudo /opt/linguard/linguard-admin license status
sudo nft list table inet linguard
journalctl -u linguard --since '10 minutes ago' --no-pagerAttendus : service actif, version 0.1.3, bon tenant, identité enrôlée et protection active. Vérifier dans Parc que le poste apparaît et communique. La licence renseignée dans la console descend automatiquement avec le battement ; sa signature et son tenant restent contrôlés. Pour un import manuel autorisé, utiliser la licence du même tenant :
sudo /opt/linguard/linguard-admin license import ./tenant.lic
sudo /opt/linguard/linguard-admin license statusNe pas contourner un refus de signature, de tenant ou de certificat.
8. Effectuer la recette de protection
Tester un texte neutre puis des données sensibles entièrement synthétiques. Vérifier la fenêtre de décision, l'obfuscation, l'annulation et la remontée de l'événement dans la console. Contrôler chaque navigateur utilisé. Un flux relayé ou un service actif ne prouve pas à lui seul l'inspection. Les navigateurs Flatpak et les magasins isolés nécessitent une recette spécifique ; ne pas les annoncer couverts sur la seule base de l'installation.
En cas d'échec, conserver le diagnostic sans jeton ni donnée sensible. Vérifier le VPN, le DNS, l'horloge, les journaux et le tenant. Pour réessayer l'enrôlement, générer un jeton neuf.
9. Désinstaller à la fin des tests
Reprendre l'étape 4 avec le jeton choisi à l'étape 6. Vérifier ensuite que le service et la table nftables LinGuard ont disparu. Révoquer le poste dans la console si nécessaire. Restaurer l'instantané de la machine de recette pour retrouver son état initial.
Portée des validations
Les tests automatisés et les contrôles de packaging sont distincts de la recette réelle d'un poste. Une installation fraîche, l'enrôlement, la session graphique et le trafic navigateur doivent être vérifiés sur chaque architecture. Aucune validation non effectuée n'est implicite dans ce guide.