florian.wildeandClaude Opus 5
b6fdd4f64a
Vier Anleitungen unter docs/betrieb/: Inbetriebnahme in der richtigen Reihenfolge, HTTPS mit nginx Proxy Manager sowie netbird als privates Netz, OIDC mit authentik samt Fehlerbildern, und Sicherung einschliesslich Zurueckspielen. Beim Aufschreiben zwei Fehler gefunden, die nur hinter einem Reverse Proxy auftreten: Die OIDC-Rueckkehradresse uebersah die im Dashboard eingetragene Adresse, und beim Einloesen des Codes wurde die interne Adresse verwendet - der Anbieter haette den Tausch abgelehnt. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.5 KiB
1.5 KiB
#029 Einrichtungsdokumentation
Status: erledigt Meilenstein: v0.19.0 Labels: doku Geschätzt: 3 h Tatsächlich: 0 h 40 min
Ziel
Anleitungen für alles, was rund um ProxLedger eingerichtet wird: HTTPS, OIDC mit authentik, Sicherung – und die richtige Reihenfolge, in der das geschehen muss.
Aufgaben
docs/betrieb/inbetriebnahme.md– von null zum meldenden Hostdocs/betrieb/reverse-proxy.md– nginx Proxy Manager und netbirddocs/betrieb/authentik.md– OIDC Schritt für Schritt, mit Fehlerbilderndocs/betrieb/sicherung.md– sichern und zurückspielen- Verweise aus README und Handbuch
Beim Schreiben gefunden
Zwei Stellen taugten für einen Betrieb hinter einem Reverse Proxy nicht:
- Die OIDC-Rückkehradresse kam allein aus
APP_URLund übersah die Dashboard-Adresse aus den Einstellungen. Wer nur letztere gesetzt hatte, bekam vom Anbieter einen Redirect URI Error. - Beim Einlösen des Codes wurde die Adresse der eingehenden Anfrage verwendet – hinter einem Proxy also die interne. Der Anbieter hat aber die öffentliche hinterlegt; der Tausch wäre gescheitert. Jetzt wird dieselbe öffentliche Adresse gebildet wie für die Weiterleitungen.
Entscheidung
Die Reihenfolge steht bewusst am Anfang der Inbetriebnahme: Adresse festlegen, dann Passkeys und Agents. Ein Passkey gilt nur für die Domäne, unter der er entstanden ist, und die Adresse steckt im Installations-Einzeiler. Wer das übergeht, macht beides zweimal.