Install the Android agent
AndGuard 0.1.2 in preproduction: Android 10 and later, APK installation, setup (local VPN, certificate), enrollment and limits.
Prerequisites
- Android 10 (API 29) or later, arm64 processor (phones, tablets) or x86_64 (emulator).
- A screen lock: the agent's Administration screen requires it.
- A customer account that is a member of the tenant, and a single-use enrollment token created in the MaelGard console.
- No other active VPN app: Android allows only one VPN at a time.
Download and install
- Open the customer area on the device, Android tab, and download
MaelGard-Android-preprod.apk. Links are personal and expire: reload the page if needed. - Open the file from Downloads. On first install, Android asks you to allow installing apps from the browser or file manager you used.
- A newer version installs over the previous one: enrollment and settings are kept.
From a computer with the Android tools, installing over USB is equivalent:
adb install -r MaelGard-Android-preprod.apkSetup
The Protection tab lists the remaining steps; each shows "Done" once completed.
- Protection (VPN): "Turn on protection", then accept the VPN connection request. This VPN is local: it checks what goes to AI services, nothing leaves the device through it.
- Certificate: "Save the certificate", then in the security settings, Encryption & credentials → Install a certificate → CA certificate, and pick the file saved in Downloads. On a managed device, the EMM installs it instead of the user.
- AI apps (accessibility): optional, for native AI apps.
Enroll the device
- Administration tab, then confirm your identity with the device lock.
- "MaelGard server" section: server URL
https://agents.preprod.maelgard.fr, organisation (tenant identifier shown in the customer area) and enrollment token. - "Enroll this device". The device identifier and its certificate end date are shown; the device key stays in the security chip (StrongBox) or the phone's trusted environment, and cannot be exported.
Without enrollment, the agent still protects the device with the default policy; events then stay on the device.
Platform limits
- Only apps that accept user-installed certificates are inspected: Chrome, Edge, Samsung Internet. Firefox has not been checked yet.
- Native AI apps (ChatGPT, Gemini, Claude…) reject these certificates: their traffic is relayed without inspection, or blocked if the policy says so (
catalog.pinned_app_policy). - Locked always-on VPN is declared but not yet validated in acceptance testing.
Uninstall
Settings → Apps → MaelGard → Uninstall. The agent's data and device key are deleted; also remove the certificate under Encryption & credentials → User certificates. Revoke the device in the console if it is no longer used.