Browser-Push einrichten (Web Push / VAPID)¶

Kamerplanter kann Pflegeerinnerungen und andere Benachrichtigungen als Browser-Push auf Desktop und Mobilgerät zustellen — auch wenn die App gerade nicht geöffnet ist. Dieser Kanal (channel_key: "pwa") basiert auf dem Web-Push-Standard und benötigt ein VAPID-Schlüsselpaar, das der Betreiber einmalig erzeugt und im Backend hinterlegt.

Was sind VAPID-Schlüssel?¶

VAPID (Voluntary Application Server Identification) identifiziert den sendenden Server gegenüber den Push-Diensten der Browser (Google FCM, Mozilla, Apple). Das Schlüsselpaar besteht aus:

Beide Schlüssel gehören zusammen: Ein einmal erzeugtes Paar bleibt für die gesamte Lebensdauer der Instanz gültig. Ein Wechsel des Public Keys macht alle bestehenden Browser-Abonnements ungültig — Nutzer müssten Browser-Push erneut aktivieren.

Überblick¶

flowchart LR
    GEN["1. Schlüsselpaar<br/>erzeugen"] --> SECRET["2. Als Secret/<br/>Env eintragen"]
    SECRET --> BE["3. Backend aktiviert<br/>PWA-Kanal"]
    BE -->|Public Key via API| BROWSER["4. Browser<br/>abonniert Push"]

Schritt 1 — Schlüsselpaar erzeugen¶

Erzeuge das Paar einmalig auf einem beliebigen Rechner. Es gibt zwei gleichwertige Wege:

npx web-push generate-vapid-keys

Public Key:
BNm... (87 Zeichen, Base64url)

Private Key:
8Kv... (Base64url)

pip install pywebpush
python3 - <<'PY'
from py_vapid import Vapid
from py_vapid.utils import b64urlencode
from cryptography.hazmat.primitives import serialization

v = Vapid()
v.generate_keys()
pub_raw = v.public_key.public_bytes(
    serialization.Encoding.X962,
    serialization.PublicFormat.UncompressedPoint,
)
priv_raw = v.private_key.private_numbers().private_value.to_bytes(32, "big")
pub, priv = b64urlencode(pub_raw), b64urlencode(priv_raw)
assert pub_raw[0] == 0x04 and len(pub_raw) == 65 and len(pub) == 87, "invalid public key"
assert len(priv_raw) == 32 and len(priv) == 43, "invalid private key"
print("VAPID_PUBLIC_KEY =", pub)
print("VAPID_PRIVATE_KEY=", priv)
PY

Notiere beide Schlüssel — der Private Key wird nach dem Erzeugen nicht erneut angezeigt.

echo -n '<PUBLIC_KEY>' | tr '_-' '/+' | base64 -d 2>/dev/null | wc -c

Schritt 2 — Schlüssel im Backend eintragen¶

Der Browser-Push-Kanal wird über drei Umgebungsvariablen konfiguriert. Alle drei müssen gesetzt sein, sonst bleibt der Kanal deaktiviert (siehe Fehlerbehebung).

VAPID_PUBLIC_KEY=BNm...
VAPID_PRIVATE_KEY=8Kv...
VAPID_CONTACT_EMAIL=mailto:admin@example.com

apiVersion: v1
kind: Secret
metadata:
  name: kamerplanter-vapid
type: Opaque
stringData:
  VAPID_PUBLIC_KEY: "BNm..."
  VAPID_PRIVATE_KEY: "8Kv..."
  VAPID_CONTACT_EMAIL: "mailto:admin@example.com"

Schritt 3 — Backend neu starten¶

Damit die neuen Variablen geladen werden, das Backend neu starten:

docker compose up -d --force-recreate backend

kubectl rollout restart deployment/kamerplanter-backend

Beim Start registriert das Backend den PWA-Kanal automatisch, sobald alle drei Variablen vorhanden sind.

Schritt 4 — Einrichtung prüfen¶

1. Public Key wird ausgeliefert — der Endpunkt liefert den konfigurierten Schlüssel zurück:

curl https://<deine-instanz>/api/v1/t/<tenant-slug>/notifications/pwa/vapid-public-key
# {"vapid_public_key": "BNm..."}

1. In der App aktivieren — als Nutzer einloggen, Einstellungen → Benachrichtigungen öffnen und Browser-Push aktivieren. Der Browser fragt nach der Benachrichtigungs-Erlaubnis. Steht dort „Nicht konfiguriert", ist eine der drei Variablen leer oder das Backend wurde nicht neu gestartet.

2. Testnachricht senden — über die Schaltfläche „Testbenachrichtigung" in den Benachrichtigungseinstellungen prüfen, ob eine Push-Meldung ankommt.

Fehlerbehebung¶

Verwandte Themen¶

• Umgebungsvariablen — Referenz aller VAPID_*-Variablen
• Home Assistant Integration — alternativer Benachrichtigungskanal
• Pflegeerinnerungen — Auslöser für die meisten Push-Benachrichtigungen