DocumentationInstaller l'agent Android

Installer l'agent Android

Installer l'agent Android

AndGuard 0.1.2 en préproduction : Android 10 et ultérieur, installation de l'APK, mise en route (VPN local, certificat), enrôlement et limites.

Prérequis

  • Android 10 (API 29) ou ultérieur, processeur arm64 (téléphones, tablettes) ou x86_64 (émulateur).
  • Un verrouillage d'écran : l'écran Administration de l'agent l'exige.
  • Un compte client membre du tenant, et un jeton d'enrôlement à usage unique créé dans la console MaelGard.
  • Aucune autre application VPN active : Android n'autorise qu'un VPN à la fois.

Télécharger et installer

  1. Ouvrir l'espace client depuis l'appareil, onglet Android, et télécharger MaelGard-Android-preprod.apk. Les liens sont personnels et expirent : recharger la page au besoin.
  2. Ouvrir le fichier depuis Téléchargements. À la première installation, Android demande d'autoriser l'installation d'applications depuis le navigateur ou le gestionnaire de fichiers utilisé.
  3. Une version plus récente s'installe par-dessus la précédente : l'enrôlement et les réglages sont conservés.

Depuis un poste avec les outils Android, l'installation par câble est équivalente :

adb install -r MaelGard-Android-preprod.apk

Mise en route

L'onglet Protection liste les étapes restantes ; chacune indique « Fait » une fois terminée.

  1. Protection (VPN) : « Activer la protection », puis accepter la demande de connexion VPN. Ce VPN est local : il sert à vérifier ce qui part vers les services d'IA, rien ne quitte l'appareil par lui.
  2. Certificat : « Enregistrer le certificat », puis, dans les paramètres de sécurité, Chiffrement et identifiants → Installer un certificat → Certificat CA, et choisir le fichier enregistré dans Téléchargements. Sur un appareil géré, l'EMM l'installe à la place de l'utilisateur.
  3. Applications d'IA (accessibilité) : facultatif, pour les applications d'IA natives.

Enrôler l'appareil

  1. Onglet Administration, puis confirmer son identité avec le verrouillage de l'appareil.
  2. Section « Serveur MaelGard » : URL du serveur https://agents.preprod.maelgard.fr, organisation (identifiant de tenant affiché dans l'espace client) et jeton d'enrôlement.
  3. « Enrôler l'appareil ». L'identifiant de l'appareil et l'échéance de son certificat s'affichent ; la clé de l'appareil reste dans la puce de sécurité (StrongBox) ou l'environnement sécurisé du téléphone, non exportable.

Sans enrôlement, l'agent protège quand même l'appareil avec la politique par défaut ; les événements restent alors sur l'appareil.

Limites de la plateforme

  • Seules les applications qui acceptent les certificats installés par l'utilisateur sont inspectées : Chrome, Edge, Samsung Internet. Firefox n'a pas encore été vérifié.
  • Les applications d'IA natives (ChatGPT, Gemini, Claude…) refusent ces certificats : leur trafic est relayé sans inspection, ou bloqué si la politique le demande (catalog.pinned_app_policy).
  • Le VPN permanent verrouillé (Always-on) est déclaré mais pas encore validé en recette.

Désinstaller

Paramètres → Applications → MaelGard → Désinstaller. Les données de l'agent et sa clé d'appareil sont supprimées ; retirer aussi le certificat dans Chiffrement et identifiants → Certificats utilisateur. Révoquer l'appareil dans la console si l'appareil n'est plus utilisé.