SysD Manager Proxy

Why

SysD Manager uses a privileged proxy daemon to perform system-level operations that require root access.

Context

The /usr/share/dbus-1/system.d/org.freedesktop.systemd1.conf file is a D-Bus policy configuration file used by systemd, the system and service manager for Linux. It defines access permissions for the org.freedesktop.systemd1 D-Bus interface, which is central to controlling and monitoring systemd-managed units, jobs, and system state.

Key Features:

Root Access: The root user is granted full access, including the ability to own the bus name and perform all operations.

Default User Access: Non-root users are denied direct access to most org.freedesktop.systemd1.Manager methods by default, but are allowed to perform read-only queries such as: GetUnit, ListUnits, ListJobs, GetUnitFileState, GetDefaultTarget, and others.

Controlled Modifications: Certain actions like StartUnit, StopUnit, EnableUnitFiles, or SetDefaultTarget are restricted and typically require polkit authorization.

How the Proxy works

• Architecture diagram or flow description (GUI → proxy → systemd)
• Proxy runs as root system service
• Polkit authorization check on every call
• auth_admin_keep: user prompted once per session

What operations go through the proxy

The ProxySwitcher shows that each operation is individually configurable. Users can choose per-operation whether to use the Proxy or fall back to default direct Polkit calls.

D-Bus Methods

• start
• stop
• restart
• clean
• freeze
• thaw
• enable-unit-file
• disable-unit-file
• reload-daemon
• create-drop-in

File action

• save-file
• revert-unit-file