DocumentationInstaller l'agent Windows

Installer l'agent Windows

Installer l'agent Windows

Déploiement de l'agent MaelGard sur Windows 11 : MSI silencieux, propriétés publiques, GPO et Intune, contrôles de bon fonctionnement et désinstallation.

L'agent MaelGard pour Windows se livre en MSI par architecture. Il porte le service, l'agent de session, l'interface, l'outil d'administration, le driver WFP et le minifiltre. Un seul MSI couvre tout le poste.

Prérequis

  • Système : Windows 11 version 22H2 ou plus récente, édition Pro, Enterprise ou Education.
  • Architecture : x64 ou ARM64. Un MSI par architecture.
  • Runtime : .NET 10 Desktop Runtime pour l'interface (installé par le MSI si absent).
  • TPM : TPM 2.0 recommandé pour la clé client non exportable. CNG logiciel ACL SYSTEM à défaut.
  • Intégrité mémoire (HVCI) : prise en charge par le driver signé.
  • Compte : droits administrateur local pour l'installation.

Fichiers livrés

Contenu du paquet d'installation
FichierRôle
Maelgard-<version>-x64.msiAgent complet pour postes x64.
Maelgard-<version>-arm64.msiAgent complet pour postes ARM64.
DLPIA.admx, DLPIA.admlModèles ADMX et ADML pour GPO et Intune (français, anglais).
gateway-root.pemRacine de la passerelle, à épingler via la propriété SERVER_CA.

Installation silencieuse

Depuis une console PowerShell élevée, l'installation sans interaction utilise msiexec /qn avec les propriétés publiques.

$msi = 'C:\Deploiement\Maelgard-0.1.0-x64.msi'
$caPem = 'C:\Deploiement\gateway-root.pem'
$log = 'C:\Deploiement\install.log'
$serverCa = [Convert]::ToBase64String([IO.File]::ReadAllBytes($caPem))

Start-Process msiexec.exe -Wait -PassThru -ArgumentList @(
    '/i', $msi, '/qn', '/l*v', $log,
    "SERVER_URL=https://agents.preprod.maelgard.fr",
    "TENANT_ID=<identifiant-tenant>",
    "ENROLL_TOKEN=<jeton-neuf>",
    "SERVER_CA=$serverCa"
)

Le code de sortie 0 indique une installation réussie. Le service démarre et tente l'enrôlement en arrière-plan.

Propriétés publiques du MSI

Propriétés acceptées par msiexec
PropriétéObligatoireRôle
SERVER_URLOuiURL de la passerelle MaelGard, par exemple https://agents.preprod.maelgard.fr.
TENANT_IDOuiIdentifiant du tenant client (UUID).
SERVER_CAOuiRacine PEM de la passerelle, encodée en base64 sur une ligne.
ENROLL_TOKENOuiJeton d'enrôlement à usage unique.
CONFIG_PUBKEYNonClé publique Ed25519 du signer de configuration du tenant. Pré-chargée si fournie, livrée automatiquement par l'enrôlement sinon.
UNINSTALL_TOKENNonJeton exigé pour la désinstallation. Protège contre le retrait non autorisé.
BROWSER_POLICIESNonVaut 1 pour poser les stratégies Edge/Chrome/Firefox (QUIC, ECH, DoH, racines Firefox). Défaut : 1.
CA_MODENonlocal (défaut) ou enterprise. Choisit la source de la CA d'inspection.
CHANNELSNonListe des canaux activés à l'installation. Défaut : canaux web actifs, autres en observation.
ALLUSERSNonToujours 1 (installation machine). Posé par le MSI, inutile d'ajouter.

Déploiement par GPO

  1. Copier les fichiers DLPIA.admx et DLPIA.adml dans le Central Store du domaine (\\<domaine>\SYSVOL\<domaine>\Policies\PolicyDefinitions).
  2. Dans l'éditeur de gestion des stratégies de groupe, créer un GPO lié à l'unité d'organisation cible.
  3. Ouvrir Configuration ordinateur -> Stratégies -> Modèles d'administration -> MaelGard et renseigner les paramètres.
  4. Dans Configuration ordinateur -> Stratégies -> Paramètres du logiciel -> Installation de logiciel, publier le MSI pour l'ordinateur.
  5. Appliquer et vérifier le déploiement avec gpupdate /force sur un poste de test.
Catégories ADMX publiées
CatégorieChemin registre
AdministrationHKLM\SOFTWARE\Policies\DLPIA
AnalyseHKLM\SOFTWARE\Policies\DLPIA
CatalogueHKLM\SOFTWARE\Policies\DLPIA
CatégoriesHKLM\SOFTWARE\Policies\DLPIA
CanauxHKLM\SOFTWARE\Policies\DLPIA
DiagnosticHKLM\SOFTWARE\Policies\DLPIA
InterceptionHKLM\SOFTWARE\Policies\DLPIA
PolitiqueHKLM\SOFTWARE\Policies\DLPIA
StockageHKLM\SOFTWARE\Policies\DLPIA
SynchronisationHKLM\SOFTWARE\Policies\DLPIA
InterfaceHKLM\SOFTWARE\Policies\DLPIA
Mise à jourHKLM\SOFTWARE\Policies\DLPIA

Déploiement par Intune

Application Win32

  1. Encapsuler le MSI avec IntuneWinAppUtil.exe pour produire un fichier .intunewin.
  2. Dans Intune, créer une application Win32 et importer le .intunewin.
  3. Commande d'installation : msiexec /i Maelgard-<version>-x64.msi /qn SERVER_URL=... TENANT_ID=... ENROLL_TOKEN=... SERVER_CA=....
  4. Commande de désinstallation : msiexec /x <ProductCode> /qn UNINSTALL_TOKEN=....
  5. Règle de détection : code produit MSI.
  6. Affecter l'application à un groupe de postes et laisser Intune pousser l'installation.

Import ADMX

Dans Appareils -> Gérer les appareils -> Configuration -> Importer les ADMX, importer DLPIA.admx et le .adml dans la langue voulue. Les paramètres apparaissent ensuite dans un profil Modèles -> Modèles d'administration importés.

OMA-URI

Les paramètres peuvent aussi être poussés par OMA-URI avec le préfixe ./Device/Vendor/MSFT/Policy/Config/DLPIA~Policy~<catégorie>/<paramètre>. Utiliser cette voie pour un paramètre ponctuel ; préférer l'ADMX pour un paramétrage complet.

Contrôles après installation

Dans une console PowerShell élevée, vérifier que le service, les drivers et l'enrôlement sont en place.

$admin = "$env:ProgramFiles\MaelGard\dlpia-admin.exe"
Get-Service DlpIa
sc.exe query DlpIaWfp
sc.exe query DlpIaFlt
& $admin status | ConvertFrom-Json | ConvertTo-Json -Depth 8
  • Service DlpIa en état Running.
  • Driver DlpIaWfp en état RUNNING et minifiltre DlpIaFlt chargé.
  • Dans dlpia-admin status : driver.loaded=true, driver.service_alive=true, au moins une entrée dans driver.listen.
  • enrollment.device_id et enrollment.not_after présents.
  • Dossier %ProgramData%\MaelGard\ créé, lisible par SYSTEM seulement.
  • CA locale DLP-IA présente dans Cert:\LocalMachine\Root.

Désinstallation

Start-Process msiexec.exe -Wait -PassThru -ArgumentList @(
    '/x', 'C:\Deploiement\Maelgard-0.1.0-x64.msi',
    '/qn', '/l*v', 'C:\Deploiement\uninstall.log',
    "UNINSTALL_TOKEN=<jeton>"
)

La désinstallation retire les services, les drivers et la CA locale. Elle envoie un événement final au serveur si la connexion est disponible. Les données du poste sont conservées sous %ProgramData%\MaelGard\ sauf si l'option de purge est demandée.

Purge des données locales

Pour supprimer aussi les données, journaux et modèles téléchargés, ajouter PURGE=1 aux propriétés de la ligne msiexec /x. Les événements non remontés sont perdus.

Dépannage de l'installation

Codes de sortie MSI courants
CodeSignificationAction
0Succès.Vérifier avec dlpia-admin status.
1603Erreur fatale pendant l'installation.Consulter le journal passé à /l*v, chercher Return value 3.
1618Une autre installation est en cours.Attendre la fin de l'autre installeur et relancer.
1622Impossible d'ouvrir le fichier journal.Créer le dossier parent du journal avant la commande.
1625Installation interdite par stratégie.Vérifier les stratégies de restriction logicielle AppLocker ou SRP.
3010Succès, redémarrage demandé.Redémarrer pour terminer la mise en service.
Symptômes et actions
SymptômeVérification et action
Driver DlpIaWfp non chargé.Vérifier le certificat de signature et HVCI. Sur recette interne : Secure Boot désactivé et mode test actif.
Enrôlement refusé 401.Jeton expiré, épuisé ou tenant incorrect. Générer un nouveau jeton pour le tenant exact et relancer.
Alerte ca_removed au démarrage.Un autre produit retire la CA. Vérifier les antivirus et outils de nettoyage. La CA est remise automatiquement.
Journal MSI 1922 ou 1923.Service DlpIa impossible à créer ou à démarrer. Vérifier qu'aucune installation précédente ne persiste et relancer.
Edge affiche une erreur de certificat sur un site IA.Vérifier driver.loaded=true et la présence de la CA dans Cert:\LocalMachine\Root. Relancer Edge.
Signature de configuration invalide, policy_version=0 côté console.La clé publique du signer n'est pas dans le keyring. Réinstaller contre un enrôlement frais ou passer CONFIG_PUBKEY au MSI.

Les journaux détaillés sont dans %ProgramData%\MaelGard\logs\service.log et dans le journal MSI passé à /l*v. Les ouvrir avec un éditeur de texte, chercher les lignes ERROR et WARN.