DocumentationInstall the Android agent

Install the Android agent

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

  1. 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.
  2. Open the file from Downloads. On first install, Android asks you to allow installing apps from the browser or file manager you used.
  3. 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.apk

Setup

The Protection tab lists the remaining steps; each shows "Done" once completed.

  1. 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.
  2. 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.
  3. AI apps (accessibility): optional, for native AI apps.

Enroll the device

  1. Administration tab, then confirm your identity with the device lock.
  2. "MaelGard server" section: server URL https://agents.preprod.maelgard.fr, organisation (tenant identifier shown in the customer area) and enrollment token.
  3. "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.