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
| Fichier | Rôle |
|---|---|
Maelgard-<version>-x64.msi | Agent complet pour postes x64. |
Maelgard-<version>-arm64.msi | Agent complet pour postes ARM64. |
DLPIA.admx, DLPIA.adml | Modèles ADMX et ADML pour GPO et Intune (français, anglais). |
gateway-root.pem | Racine 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é | Obligatoire | Rôle |
|---|---|---|
SERVER_URL | Oui | URL de la passerelle MaelGard, par exemple https://agents.preprod.maelgard.fr. |
TENANT_ID | Oui | Identifiant du tenant client (UUID). |
SERVER_CA | Oui | Racine PEM de la passerelle, encodée en base64 sur une ligne. |
ENROLL_TOKEN | Oui | Jeton d'enrôlement à usage unique. |
CONFIG_PUBKEY | Non | Clé publique Ed25519 du signer de configuration du tenant. Pré-chargée si fournie, livrée automatiquement par l'enrôlement sinon. |
UNINSTALL_TOKEN | Non | Jeton exigé pour la désinstallation. Protège contre le retrait non autorisé. |
BROWSER_POLICIES | Non | Vaut 1 pour poser les stratégies Edge/Chrome/Firefox (QUIC, ECH, DoH, racines Firefox). Défaut : 1. |
CA_MODE | Non | local (défaut) ou enterprise. Choisit la source de la CA d'inspection. |
CHANNELS | Non | Liste des canaux activés à l'installation. Défaut : canaux web actifs, autres en observation. |
ALLUSERS | Non | Toujours 1 (installation machine). Posé par le MSI, inutile d'ajouter. |
Déploiement par GPO
- Copier les fichiers
DLPIA.admxetDLPIA.admldans le Central Store du domaine (\\<domaine>\SYSVOL\<domaine>\Policies\PolicyDefinitions). - Dans l'éditeur de gestion des stratégies de groupe, créer un GPO lié à l'unité d'organisation cible.
- Ouvrir Configuration ordinateur -> Stratégies -> Modèles d'administration -> MaelGard et renseigner les paramètres.
- Dans Configuration ordinateur -> Stratégies -> Paramètres du logiciel -> Installation de logiciel, publier le MSI pour l'ordinateur.
- Appliquer et vérifier le déploiement avec
gpupdate /forcesur un poste de test.
| Catégorie | Chemin registre |
|---|---|
| Administration | HKLM\SOFTWARE\Policies\DLPIA |
| Analyse | HKLM\SOFTWARE\Policies\DLPIA |
| Catalogue | HKLM\SOFTWARE\Policies\DLPIA |
| Catégories | HKLM\SOFTWARE\Policies\DLPIA |
| Canaux | HKLM\SOFTWARE\Policies\DLPIA |
| Diagnostic | HKLM\SOFTWARE\Policies\DLPIA |
| Interception | HKLM\SOFTWARE\Policies\DLPIA |
| Politique | HKLM\SOFTWARE\Policies\DLPIA |
| Stockage | HKLM\SOFTWARE\Policies\DLPIA |
| Synchronisation | HKLM\SOFTWARE\Policies\DLPIA |
| Interface | HKLM\SOFTWARE\Policies\DLPIA |
| Mise à jour | HKLM\SOFTWARE\Policies\DLPIA |
Déploiement par Intune
Application Win32
- Encapsuler le MSI avec
IntuneWinAppUtil.exepour produire un fichier.intunewin. - Dans Intune, créer une application Win32 et importer le
.intunewin. - Commande d'installation :
msiexec /i Maelgard-<version>-x64.msi /qn SERVER_URL=... TENANT_ID=... ENROLL_TOKEN=... SERVER_CA=.... - Commande de désinstallation :
msiexec /x <ProductCode> /qn UNINSTALL_TOKEN=.... - Règle de détection : code produit MSI.
- 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
DlpIaen étatRunning. - Driver
DlpIaWfpen étatRUNNINGet minifiltreDlpIaFltchargé. - Dans
dlpia-admin status:driver.loaded=true,driver.service_alive=true, au moins une entrée dansdriver.listen. enrollment.device_idetenrollment.not_afterprésents.- Dossier
%ProgramData%\MaelGard\créé, lisible par SYSTEM seulement. - CA locale
DLP-IAprésente dansCert:\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
| Code | Signification | Action |
|---|---|---|
0 | Succès. | Vérifier avec dlpia-admin status. |
1603 | Erreur fatale pendant l'installation. | Consulter le journal passé à /l*v, chercher Return value 3. |
1618 | Une autre installation est en cours. | Attendre la fin de l'autre installeur et relancer. |
1622 | Impossible d'ouvrir le fichier journal. | Créer le dossier parent du journal avant la commande. |
1625 | Installation interdite par stratégie. | Vérifier les stratégies de restriction logicielle AppLocker ou SRP. |
3010 | Succès, redémarrage demandé. | Redémarrer pour terminer la mise en service. |
| Symptôme | Vé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.