Managed Policy

Status: Available.

Enrol workstations with MezHub to manage local gateway policy centrally and upload local audit records to MezHub’s audit log. Unenrolled workstations can use the local gateway without a control plane.

Enrol a workstation

An administrator creates an enrolment token:

mezctl devices enroll-token --user <owner>

The workstation user enrols with the token provided by the administrator:

msh local enroll --server https://<your-mezhub> <token>

The server for workstation enrolment and managed policy is MezHub.

Manage policy

mezctl local-policy get
mezctl local-policy set -f policy.yaml
mezctl local-policy history

Managed policy is a full replacement, not a merge with the workstation’s local policy. Include every required protocol, inspect route, group and rule in the centrally managed document. See Policy Configuration for the YAML schema.

Availability and enforcement

After its first successful sync, an enrolled workstation keeps enforcing its last-known-good managed policy when MezHub is unreachable. It does not revert to local policy, and the cached policy has no enforcement expiry. A workstation that has enrolled but never synced keeps its frozen local policy until the first sync succeeds. Restore connectivity to receive policy updates.

Central audit

Local audit remains at ~/.mezite/local/audit.jsonl. When enrolled, audit records are also uploaded to MezHub’s audit log. See Local Audit Logging and Mezite Audit Logging.