docs(betrieb): Einrichtung Schritt fuer Schritt dokumentieren (#029)
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>
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
# #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
|
||||
- [x] `docs/betrieb/inbetriebnahme.md` – von null zum meldenden Host
|
||||
- [x] `docs/betrieb/reverse-proxy.md` – nginx Proxy Manager und netbird
|
||||
- [x] `docs/betrieb/authentik.md` – OIDC Schritt für Schritt, mit Fehlerbildern
|
||||
- [x] `docs/betrieb/sicherung.md` – sichern und **zurückspielen**
|
||||
- [x] Verweise aus README und Handbuch
|
||||
|
||||
## Beim Schreiben gefunden
|
||||
Zwei Stellen taugten für einen Betrieb hinter einem Reverse Proxy nicht:
|
||||
|
||||
1. Die **OIDC-Rückkehradresse** kam allein aus `APP_URL` und übersah die Dashboard-Adresse aus den
|
||||
Einstellungen. Wer nur letztere gesetzt hatte, bekam vom Anbieter einen *Redirect URI Error*.
|
||||
2. 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.
|
||||
Reference in New Issue
Block a user