Skip to content

Security: mahmutaunal/NotifyBridge

Security

docs/SECURITY.md

Security

NotifyBridge is designed to work locally and securely.

Local Network Only

Notifications are sent directly from Android to macOS over the local network.

NotifyBridge does not use:

  • Cloud servers
  • Remote relay services
  • Analytics backends
  • Push notification infrastructure

Pairing Secret

During QR pairing, the Android app stores a shared secret generated by the Mac app.

This secret is used for encryption and request signing.

Encryption

Notification payloads are encrypted using:

AES-256-GCM

The notification title and body are not sent as plain JSON over the network.

Request Signing

Requests are signed using:

HMAC-SHA256

Each request includes:

  • Timestamp
  • Nonce
  • Signature

The Mac verifies the signature before decrypting the payload.

Replay Protection

Requests include a timestamp and nonce. The Mac rejects expired requests to reduce replay risk.

Threat Model

NotifyBridge protects against casual local network inspection and unauthorized notification posting without the pairing secret.

It is not intended to replace enterprise-grade device management or end-to-end authenticated identity infrastructure.

There aren't any published security advisories