⚙️ 🤖 Instanz-Vorgabe per authorize-Parameter instance (Direktknopf social.saarland) #11

Closed
opened 2026-11-16 09:19:16 +01:00 by holm · 4 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ███░░░░░░░ Gering: ein Parameter, Konfigfeld, e2e-Test
Nutzen ██████░░░░ Mittel: Direktknopf für die Hausinstanz, ohne Eingabe
Dringlichkeit ████░░░░░░ Mittel: von wsm25-hosting angefragt, Holm will den Knopf
Sicherheitsrisiko █████░░░░░ Mittel: GET löst ohne Nutzereingabe eine Weiterleitung zu einer Instanz aus, darum nur erlaubte Hosts je Client

Auftrag

req v00-wsm25-hosting:0094 (wsm25-hosting#289). Holm 2026-11-16: „Mastodon-Logo -> plus direktlink auf social.saarland“.

Umsetzung

  • authorize-Endpunkt nimmt optional instance=<host> an (oidc-provider extraParams mit Prüffunktion).
  • Sicherheitsentscheid v00: Je Client in OIDC_CLIENTS gibt das Feld preset_instances vor, welche Hosts erlaubt sind. Die Liste ist Pflicht, sonst gilt der Parameter nicht. Ohne Liste wäre …/auth?client_id=<öffentlich>&instance=<beliebig> eine offene Weiterleitung über unsere Domain zu jeder Instanz, auch zu einer präparierten. Ein nicht erlaubter Wert wird schon am authorize-Endpunkt mit invalid_request abgelehnt.
  • Erlaubte Vorgabe: Das Formular wird übersprungen, danach dieselbe Logik wie beim Formular (Allow-/Denylist, Rate-Limits, ensureApp, PKCE, 303 zur Instanz).
  • Scheitert die Vorgabe (Denylist, Instanz nicht erreichbar, Rate-Limit), erscheint das Formular, vorbefüllt und mit Fehlermeldung.
  • Claims unverändert. e2e-Tests für Vorgabe, nicht erlaubten Wert und Fehlerfall.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███░░░░░░░` | Gering: ein Parameter, Konfigfeld, e2e-Test | | Nutzen | `██████░░░░` | Mittel: Direktknopf für die Hausinstanz, ohne Eingabe | | Dringlichkeit | `████░░░░░░` | Mittel: von wsm25-hosting angefragt, Holm will den Knopf | | Sicherheitsrisiko | `█████░░░░░` | Mittel: GET löst ohne Nutzereingabe eine Weiterleitung zu einer Instanz aus, darum nur erlaubte Hosts je Client | ## Auftrag req v00-wsm25-hosting:0094 (wsm25-hosting#289). Holm 2026-11-16: „Mastodon-Logo -> plus direktlink auf social.saarland“. ## Umsetzung - authorize-Endpunkt nimmt optional `instance=<host>` an (oidc-provider `extraParams` mit Prüffunktion). - **Sicherheitsentscheid v00:** Je Client in `OIDC_CLIENTS` gibt das Feld `preset_instances` vor, welche Hosts erlaubt sind. Die Liste ist Pflicht, sonst gilt der Parameter nicht. Ohne Liste wäre `…/auth?client_id=<öffentlich>&instance=<beliebig>` eine offene Weiterleitung über unsere Domain zu jeder Instanz, auch zu einer präparierten. Ein nicht erlaubter Wert wird schon am authorize-Endpunkt mit `invalid_request` abgelehnt. - Erlaubte Vorgabe: Das Formular wird übersprungen, danach dieselbe Logik wie beim Formular (Allow-/Denylist, Rate-Limits, ensureApp, PKCE, 303 zur Instanz). - Scheitert die Vorgabe (Denylist, Instanz nicht erreichbar, Rate-Limit), erscheint das Formular, vorbefüllt und mit Fehlermeldung. - Claims unverändert. e2e-Tests für Vorgabe, nicht erlaubten Wert und Fehlerfall. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Stand 2026-11-16: umgesetzt auf Branch feat/11-instanz-vorgabe (Commit 96e12bd, signiert, 38/38 Tests grün)

Punkt Stand
instance= + preset_instances (Pflicht) fertig
e2e: Vorgabe, nicht freigegebener Wert, gesperrte Vorgabe fertig
Doku docs/keycloak.md §5, README fertig
Merge nach dev erst wenn das Security-Audit #10 (Security-Audit v0.2.0) durch ist, damit sich der Code unter dem Audit nicht ändert
Release + Deploy nach dem Audit, auf Holms Go
Rückmeldung an wsm25-hosting resp v00-fedilogin:0094 mit Konfig-Vorgaben und dem Hinweis auf mögliche Konto-Doppel in Keycloak (zwei IdPs, gleicher Benutzername)

🤖 angelegt von Claude v00 (API/Token holm)

**Stand 2026-11-16: umgesetzt auf Branch `feat/11-instanz-vorgabe`** (Commit `96e12bd`, signiert, 38/38 Tests grün) | Punkt | Stand | |---|---| | `instance=` + `preset_instances` (Pflicht) | fertig | | e2e: Vorgabe, nicht freigegebener Wert, gesperrte Vorgabe | fertig | | Doku `docs/keycloak.md` §5, README | fertig | | Merge nach dev | erst wenn das Security-Audit [#10](https://forgejo.mueller.network/holm.tools.public/fedilogin/issues/10) (Security-Audit v0.2.0) durch ist, damit sich der Code unter dem Audit nicht ändert | | Release + Deploy | nach dem Audit, auf Holms Go | | Rückmeldung an wsm25-hosting | resp v00-fedilogin:0094 mit Konfig-Vorgaben und dem Hinweis auf mögliche Konto-Doppel in Keycloak (zwei IdPs, gleicher Benutzername) | > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Holm-Entscheid 2026-11-16: „5a“. Erst die Audit-Fixes #12–#15, dann zusammen mit diesem Issue als v0.3.0 veröffentlichen und deployen. Der Branch geht jetzt nach dev, weil das Audit abgeschlossen ist.

🤖 angelegt von Claude v00 (API/Token holm)

**Holm-Entscheid 2026-11-16: „5a“.** Erst die Audit-Fixes #12–#15, dann zusammen mit diesem Issue als v0.3.0 veröffentlichen und deployen. Der Branch geht jetzt nach dev, weil das Audit abgeschlossen ist. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

In Betrieb 2026-11-16 (v0.3.0, wsm25-hosting resp-0008, Holm-Go dort „67a 68a“)

Prüfung Ergebnis
Container healthy, Härtung aktiv, /healthz 200
Discovery code_challenge_methods_supported = ["S256"]
IdP social-saarland angelegt, PKCE S256, Client keycloak-zentonic-studio mit preset_instances: ["social.saarland"]
Knopf social.saarland Keycloak → fedilogin /auth?instance=social.saarland → direkt zu social.saarland/oauth/authorize, kein Formular
Doppel-Login First-Login-Flow „fediverse first login“ mit „Automatically set existing user“ an beiden fedilogin-IdPs; noch nicht gemessen

Offen bis zum Schließen: echter Login über den Knopf und Doppel-Login-Test (Holm).

🤖 angelegt von Claude v00 (API/Token holm)

**In Betrieb 2026-11-16** (v0.3.0, wsm25-hosting resp-0008, Holm-Go dort „67a 68a“) | Prüfung | Ergebnis | |---|---| | Container | healthy, Härtung aktiv, `/healthz` 200 | | Discovery | `code_challenge_methods_supported` = `["S256"]` | | IdP `social-saarland` | angelegt, PKCE S256, Client `keycloak-zentonic-studio` mit `preset_instances: ["social.saarland"]` | | Knopf social.saarland | Keycloak → fedilogin `/auth?instance=social.saarland` → direkt zu `social.saarland/oauth/authorize`, kein Formular | | Doppel-Login | First-Login-Flow „fediverse first login“ mit „Automatically set existing user“ an beiden fedilogin-IdPs; **noch nicht gemessen** | Offen bis zum Schließen: echter Login über den Knopf und Doppel-Login-Test (Holm). > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Abnahme 2026-11-16: bestanden (Holm „8a geht“, „8b ok“)

Test Ergebnis
8a: Login über den Knopf social.saarland bis zum Ende klappt
8b: dasselbe Konto danach über „Fediverse allgemein“ dasselbe Keycloak-Konto, keine Meldung „Konto existiert bereits“ (Auto-Link im Flow „fediverse first login“ greift)

In Betrieb seit v0.3.0. Das Studio-Design der Login-Seite gehört zu wsm25-hosting#289 und ist nicht Teil dieses Issues. Issue geschlossen.

🤖 angelegt von Claude v00 (API/Token holm)

**Abnahme 2026-11-16: bestanden** (Holm „8a geht“, „8b ok“) | Test | Ergebnis | |---|---| | 8a: Login über den Knopf social.saarland bis zum Ende | klappt | | 8b: dasselbe Konto danach über „Fediverse allgemein“ | dasselbe Keycloak-Konto, keine Meldung „Konto existiert bereits“ (Auto-Link im Flow „fediverse first login“ greift) | In Betrieb seit v0.3.0. Das Studio-Design der Login-Seite gehört zu wsm25-hosting#289 und ist nicht Teil dieses Issues. Issue geschlossen. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-16 11:03:24 +01:00
Sign in to join this conversation.
No description provided.