DocumentationInstall the Windows agent

Install the Windows agent

Install the Windows agent

Deploy the MaelGard agent on Windows 11: silent MSI, public properties, GPO and Intune, post-install checks and removal.

The MaelGard agent for Windows ships as one MSI per architecture. It carries the service, the session agent, the UI, the admin tool, the WFP driver and the minifilter. A single MSI covers the whole endpoint.

Prerequisites

  • System: Windows 11 version 22H2 or newer, Pro, Enterprise or Education edition.
  • Architecture: x64 or ARM64. One MSI per architecture.
  • Runtime: .NET 10 Desktop Runtime for the UI (installed by the MSI if missing).
  • TPM: TPM 2.0 recommended for the non-exportable client key. CNG software with SYSTEM ACL as fallback.
  • Memory integrity (HVCI): supported by the signed driver.
  • Account: local administrator rights for installation.

Delivered files

Install package contents
FilePurpose
Maelgard-<version>-x64.msiComplete agent for x64 endpoints.
Maelgard-<version>-arm64.msiComplete agent for ARM64 endpoints.
DLPIA.admx, DLPIA.admlADMX and ADML templates for GPO and Intune (French, English).
gateway-root.pemGateway root to pin via the SERVER_CA property.

Silent install

From an elevated PowerShell console, the unattended install uses msiexec /qn with public properties.

$msi = 'C:\Deployment\Maelgard-0.1.0-x64.msi'
$caPem = 'C:\Deployment\gateway-root.pem'
$log = 'C:\Deployment\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://gateway.example.local:28443",
    "TENANT_ID=<tenant-id>",
    "ENROLL_TOKEN=<fresh-token>",
    "SERVER_CA=$serverCa"
)

Exit code 0 means success. The service starts and attempts enrollment in the background.

MSI public properties

Properties accepted by msiexec
PropertyRequiredPurpose
SERVER_URLYesMaelGard gateway URL, for example https://gateway.example.local:28443.
TENANT_IDYesCustomer tenant identifier (UUID).
SERVER_CAYesGateway root in PEM, base64-encoded on a single line.
ENROLL_TOKENYesSingle-use enrollment token.
CONFIG_PUBKEYNoEd25519 public key of the tenant configuration signer. Pre-loaded if provided, otherwise delivered by enrollment.
UNINSTALL_TOKENNoToken required for uninstall. Guards against unauthorized removal.
BROWSER_POLICIESNo1 deploys Edge/Chrome/Firefox policies (QUIC, ECH, DoH, Firefox roots). Default: 1.
CA_MODENolocal (default) or enterprise. Picks the inspection CA source.
CHANNELSNoList of channels active at install. Default: web channels active, others in observe.
ALLUSERSNoAlways 1 (per-machine install). Set by the MSI, no need to pass.

Deploy with GPO

  1. Copy DLPIA.admx and DLPIA.adml to the domain Central Store (\\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions).
  2. In the Group Policy Management Console, create a GPO linked to the target OU.
  3. Open Computer Configuration -> Policies -> Administrative Templates -> MaelGard and set the parameters.
  4. In Computer Configuration -> Policies -> Software Settings -> Software installation, publish the MSI for the computer.
  5. Apply and verify with gpupdate /force on a test endpoint.
Published ADMX categories
CategoryRegistry path
AdministrationHKLM\SOFTWARE\Policies\DLPIA
AnalysisHKLM\SOFTWARE\Policies\DLPIA
CatalogHKLM\SOFTWARE\Policies\DLPIA
CategoriesHKLM\SOFTWARE\Policies\DLPIA
ChannelsHKLM\SOFTWARE\Policies\DLPIA
DiagnosticsHKLM\SOFTWARE\Policies\DLPIA
InterceptionHKLM\SOFTWARE\Policies\DLPIA
PolicyHKLM\SOFTWARE\Policies\DLPIA
StorageHKLM\SOFTWARE\Policies\DLPIA
SyncHKLM\SOFTWARE\Policies\DLPIA
UIHKLM\SOFTWARE\Policies\DLPIA
UpdateHKLM\SOFTWARE\Policies\DLPIA

Deploy with Intune

Win32 app

  1. Wrap the MSI with IntuneWinAppUtil.exe to produce a .intunewin file.
  2. In Intune, create a Win32 app and import the .intunewin.
  3. Install command: msiexec /i Maelgard-<version>-x64.msi /qn SERVER_URL=... TENANT_ID=... ENROLL_TOKEN=... SERVER_CA=....
  4. Uninstall command: msiexec /x <ProductCode> /qn UNINSTALL_TOKEN=....
  5. Detection rule: MSI product code.
  6. Assign to a device group and let Intune push the install.

ADMX import

Under Devices -> Manage devices -> Configuration -> Import ADMX, import DLPIA.admx and the matching .adml. Settings appear in a Templates -> Imported administrative templates profile.

OMA-URI

Parameters can also be pushed via OMA-URI with the prefix ./Device/Vendor/MSFT/Policy/Config/DLPIA~Policy~<category>/<parameter>. Use this path for a single setting; prefer ADMX for a full configuration.

Post-install checks

From an elevated PowerShell console, verify the service, drivers and enrollment.

$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 in state Running.
  • Driver DlpIaWfp in state RUNNING and minifilter DlpIaFlt loaded.
  • In dlpia-admin status: driver.loaded=true, driver.service_alive=true, at least one entry in driver.listen.
  • enrollment.device_id and enrollment.not_after present.
  • Folder %ProgramData%\MaelGard\ created, readable by SYSTEM only.
  • Local CA DLP-IA present in Cert:\LocalMachine\Root.

Uninstall

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

Uninstall removes services, drivers and the local CA. It sends a final event to the server if a connection is available. Endpoint data stays under %ProgramData%\MaelGard\ unless purge is requested.

Purge local data

To also remove data, logs and downloaded models, add PURGE=1 to the properties on the msiexec /x line. Any un-reported events are lost.

Install troubleshooting

Common MSI exit codes
CodeMeaningAction
0Success.Verify with dlpia-admin status.
1603Fatal error during install.Read the log passed to /l*v, search for Return value 3.
1618Another installation is in progress.Wait for the other installer and retry.
1622Cannot open the log file.Create the log parent folder before the command.
1625Installation forbidden by policy.Check AppLocker or SRP restrictions.
3010Success, reboot required.Reboot to complete the service bring-up.
Symptoms and actions
SymptomCheck and action
Driver DlpIaWfp not loaded.Check signing certificate and HVCI. On internal evaluation: Secure Boot disabled and test mode active.
Enrollment refused 401.Token expired, exhausted or wrong tenant. Mint a new token for the exact tenant and retry.
ca_removed alert at startup.Another product removes the CA. Check antivirus and cleaners. The CA is reinstalled automatically.
MSI log 1922 or 1923.Service DlpIa cannot be created or started. Ensure no leftover install exists and retry.
Edge shows a certificate error on an AI site.Check driver.loaded=true and the CA under Cert:\LocalMachine\Root. Restart Edge.
Invalid config signature, policy_version=0 on the console.Signer public key missing from the keyring. Reinstall against a fresh enrollment or pass CONFIG_PUBKEY to the MSI.

Detailed logs live under %ProgramData%\MaelGard\logs\service.log and in the MSI log passed to /l*v. Open them in a text editor and search for ERROR and WARN.