DocumentationInstaller l'agent macOS

Installer l'agent macOS

Installer l'agent macOS

Statut du port macOS : jalon M0, pas de livrable. Composants prévus, choix d'architecture, parcours de signature Apple et notarisation.

Pourquoi un port dédié

macOS n'offre pas de driver WFP ni de minifiltre équivalents à Windows. L'interception transparente du TCP sortant passe par un NETransparentProxyProvider en System Extension. La protection des fichiers et des processus de l'agent passe par une seconde System Extension Endpoint Security. Ces deux extensions exigent chacune un entitlement attribué par Apple sur demande.

La parité fonctionnelle avec Windows est l'objectif. L'interface est réécrite en SwiftUI pour l'intégration native (VoiceOver, barre des menus, préférences système) et pour éviter les contraintes de licence des toolkits portés.

Composants prévus

Architecture cible macOS
ComposantNomRôle
Servicemacguard-svcLaunchDaemon root. Proxy TLS, détection, politiques, stockage, remontée, mises à jour.
Extension réseauMacGuardNetExtSystem Extension NETransparentProxyProvider. Redirige le TCP sortant vers le service, bloque l'UDP 443.
Extension de protectionMacGuardEndpointExtSystem Extension Endpoint Security. Protège les fichiers et les processus de l'agent.
Agent de menuMacGuard.appLaunchAgent, session utilisateur. Icône dans la barre des menus (NSStatusItem), relais IPC.
InterfaceMacGuard.appFenêtres SwiftUI. Décision, tableau de bord, administration (Authorization Services).
Outil CLImacguard-adminÉquivalent de dlpia-admin et linguard-admin.

Format de livraison prévu

  • Paquet universel : un .pkg unique pour Apple Silicon et Intel (arm64 et x86_64).
  • Signature : certificat Developer ID (Apple).
  • Notarisation : notarisation Apple avec notarytool et agrafage stapler.
  • Plancher système : macOS 14 (Sonoma) ou plus récent.
  • Déploiement de parc : Jamf, Intune, Kandji, Mosyle. Profil de configuration .mobileconfig pour l'approbation des System Extensions et de la racine locale.

Entitlements Apple requis

  • Network Extension : attribué sur demande, délai usuel de quelques semaines.
  • Endpoint Security : attribué sur demande, délai usuel plus long.
  • System Extension install : requis pour installer les deux extensions.

Prochaines étapes

  1. Ouverture du compte Apple Developer de l'éditeur.
  2. Demande et attribution des entitlements Network Extension, Endpoint Security, System Extension install.
  3. Jalon M1 : scaffolding Swift, workspace, CI GitLab avec runners macOS.
  4. Jalons M2 à M9 : plateforme, interception, détection darwin (NERLite, OCR Vision), interface SwiftUI, autoprotection.
  5. Jalon M10 : paquet .pkg signé et notarisé, profils MDM, mises à jour.

Pour exprimer un intérêt macOS et prioriser le déploiement, utiliser la page Contact. Les retours de prospection guident la priorité des jalons M1 à M10.