Skip to main content

Module dbus

Module dbus 

Source
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§

AllowAllPolicy
Policy checker that allows everything (for testing)
DbusBridgeConfig
Configuration for the D-Bus bridge service
DbusBridgeService
D-Bus bridge service
DbusCallRequest
Request to call a D-Bus method
DbusCallResponse
Response from a D-Bus method call
DbusError
D-Bus error response
DbusGetPropertyRequest
Request to get a D-Bus property
DbusResource
D-Bus resource identifier for policy checks
DbusSetPropertyRequest
Request to set a D-Bus property
DbusSignal
Signal received from D-Bus
DbusSubscribeRequest
Request to subscribe to a D-Bus signal
DenyAllPolicy
Default policy checker that denies everything (for testing)

Enums§

BusType
D-Bus bus type
DbusOperation
D-Bus operation types for policy checks
DbusRequest
Unified D-Bus request type
DbusResponse
Unified D-Bus response type
DbusValue
D-Bus value types supported by the bridge

Traits§

PolicyChecker
Trait for policy checking (allows mocking in tests)

Functions§

container_subject
Build a subject identifier for policy checks