Expand description
D-Bus bridge for container access to host services
Enables containers to transparently access D-Bus services (notifications, media controls, etc.) with fine-grained policy enforcement.
§Architecture
Container (GUI app)
│
▼ (ZMQ over vsock/TCP)
DbusBridgeService
│
├── PolicyClient.check(subject, resource, operation)
│ └── resource: "dbus:system:org.freedesktop.Notifications:Notify"
│
└── zbus Connection (system or session bus)
└── Forward permitted calls to actual D-Bus§Protocol
Containers send D-Bus requests via ZMQ:
Request: DbusRequest { bus, destination, path, interface, method, args }
Response: DbusResponse { result } or DbusError { name, message }§Policy Integration
Every D-Bus operation is checked against Casbin policy:
- Resource format:
dbus:<bus>:<destination>:<interface>:<member> - Operations:
call(methods),read(properties),write(properties),subscribe(signals)
§Example Policy
# Allow container to send desktop notifications
p, container:gui-app, dbus:session:org.freedesktop.Notifications:Notify, call, allow
# Allow reading media player properties
p, container:gui-app, dbus:session:org.mpris.MediaPlayer2.*:@*, read, allow
# Deny all D-Bus by default
p, container:*, dbus:*, *, deny§Usage
ⓘ
use hyprstream_workers::dbus::{DbusBridgeService, DbusBridgeConfig};
// Create the bridge service
let config = DbusBridgeConfig::default();
let bridge = DbusBridgeService::new(config).await?;
// Start as ZMQ service
let handle = bridge.start("ipc:///run/hyprstream/dbus-bridge.sock").await?;Structs§
- Allow
AllPolicy - Policy checker that allows everything (for testing)
- Dbus
Bridge Config - Configuration for the D-Bus bridge service
- Dbus
Bridge Service - D-Bus bridge service
- Dbus
Call Request - Request to call a D-Bus method
- Dbus
Call Response - Response from a D-Bus method call
- Dbus
Error - D-Bus error response
- Dbus
GetProperty Request - Request to get a D-Bus property
- Dbus
Resource - D-Bus resource identifier for policy checks
- Dbus
SetProperty Request - Request to set a D-Bus property
- Dbus
Signal - Signal received from D-Bus
- Dbus
Subscribe Request - Request to subscribe to a D-Bus signal
- Deny
AllPolicy - Default policy checker that denies everything (for testing)
Enums§
- BusType
- D-Bus bus type
- Dbus
Operation - D-Bus operation types for policy checks
- Dbus
Request - Unified D-Bus request type
- Dbus
Response - Unified D-Bus response type
- Dbus
Value - D-Bus value types supported by the bridge
Traits§
- Policy
Checker - Trait for policy checking (allows mocking in tests)
Functions§
- container_
subject - Build a subject identifier for policy checks