Install the macOS agent
Status of the macOS port: milestone M0, no deliverable. Planned components, architecture choices, Apple signing and notarization path.
Why a dedicated port
macOS offers no WFP driver or minifilter equivalent to Windows. Transparent TCP interception uses an NETransparentProxyProvider as a System Extension. Agent file and process protection uses a second Endpoint Security System Extension. Both extensions require entitlements granted by Apple on request.
Feature parity with Windows is the goal. The UI is rewritten in SwiftUI for native integration (VoiceOver, menu bar, System Settings) and to avoid licensing constraints of ported toolkits.
Planned components
| Component | Name | Role |
|---|---|---|
| Service | macguard-svc | LaunchDaemon as root. TLS proxy, detection, policies, storage, telemetry, updates. |
| Network extension | MacGuardNetExt | System Extension NETransparentProxyProvider. Redirects outbound TCP to the service, blocks UDP 443. |
| Protection extension | MacGuardEndpointExt | System Extension Endpoint Security. Protects agent files and processes. |
| Menu agent | MacGuard.app | LaunchAgent, user session. Menu bar icon (NSStatusItem), IPC relay. |
| UI | MacGuard.app | SwiftUI windows. Decision, dashboard, administration (Authorization Services). |
| CLI tool | macguard-admin | Counterpart of dlpia-admin and linguard-admin. |
Planned delivery format
- Universal package: one
.pkgfor both Apple Silicon and Intel (arm64 and x86_64). - Signing: Developer ID certificate (Apple).
- Notarization: Apple notarization with
notarytooland stapling viastapler. - Minimum OS: macOS 14 (Sonoma) or newer.
- Fleet deployment: Jamf, Intune, Kandji, Mosyle. Configuration profile
.mobileconfigfor System Extension approval and the local root.
Required Apple entitlements
- Network Extension: granted on request, typical delay of a few weeks.
- Endpoint Security: granted on request, typical delay longer.
- System Extension install: required to install both extensions.
Next steps
- Open the publisher Apple Developer account.
- Request and secure the Network Extension, Endpoint Security and System Extension install entitlements.
- Milestone M1: Swift scaffolding, workspace, GitLab CI with macOS runners.
- Milestones M2 to M9: platform, interception, darwin detection (NERLite, OCR via Vision), SwiftUI UI, self-protection.
- Milestone M10: signed and notarized
.pkg, MDM profiles, updates.
To express a macOS interest and influence rollout priority, use the Contact page. Prospect feedback drives the priority of milestones M1 to M10.