⚙️ 🤖 Notfall-Zugang: Token-Rotation, Wiederherstellung, Neuverifikation #13

Closed
opened 2026-11-16 09:15:08 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand ██████░░░░ Mittel — vier Unterbefehle, e2e-Erweiterung
Nutzen ████████░░ Hoch — ohne das ist ein geleaktes Token oder ein verlorener Store Handarbeit am Server
Bruchhäufigkeit ██░░░░░░░░ Selten — Notfall
Nachhaltigkeit ████████░░ Hoch — Ablauf einmal getestet, danach Routine
Dringlichkeit █████░░░░░ Mittel — erster Verbraucher läuft produktiv

Teil von #1 (Umfang „Notfall-Zugang (Token-Rotation, Neuverifikation)“).

Befund (Synapse 1.164.2, Quelltext)

  • Ein Login mit vorhandener Geräte-ID erzeugt ein neues Token für dasselbe Gerät, alte Tokens bleiben gültig (register_device_inner löscht nichts).
  • POST /logout mit dem alten Token löscht das ganze Gerät samt Schlüsseln — als Widerruf unbrauchbar.
  • Passwort setzen (/account/password, logout_devices Standard true) löscht alle anderen Geräte und alle Tokens außer dem anfragenden. Ein neues Passwort ist Pflicht, das bisherige ist erlaubt.
  • Cross-Signing-Schlüssel liegen heute nur im Krypto-Store. Store weg = Identität weg, alle Nutzer müssten neu verifizieren.

Umfang

Unterbefehl Zweck
botkern rotate-token Bot gestoppt; Login mit derselben Geräte-ID (gleiche Krypto-Identität), danach Passwort neu setzen (MATRIX_NEW_PASSWORD oder das bisherige) → alle anderen Tokens/Geräte widerrufen; neues Token nur auf stdout-Pipe
botkern recovery-key Bot gestoppt; Secret Storage + Schlüssel-Backup einrichten (oder Schlüssel erneuern); Wiederherstellungsschlüssel nur auf stdout-Pipe
botkern recover nach Store-Verlust: neues Gerät (botkern login), leerer Store, MATRIX_RECOVERY_KEY → Cross-Signing-Schlüssel holen, neues Gerät selbst signieren (Nutzer vertrauen weiter), altes Gerät widerrufen
botkern reset-identity ohne Wiederherstellungsschlüssel: neue Cross-Signing-Identität, Nutzer verifizieren neu per SAS

Gemeinsam: Wächter ohne Warten (läuft der Bot, sofort Abbruch), MATRIX_PASSWORD für die Server-Rückfrage, keine Secrets in Logs.

Abnahme (e2e, auch in e2e-verify)

  • Rotation: altes Token → 401, neues Token gleiche Geräte-ID, Echo im verschlüsselten Raum, Rotation bei laufendem Bot verweigert.
  • Recover: Store weggeschoben, neues Gerät, Bot-Identität bleibt beim Testnutzer verifiziert, neues Gerät gilt als verifiziert, altes Gerät gelistet nicht mehr.
  • Reset: Identität neu, Testnutzer verifiziert erneut per SAS.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `██████░░░░` | Mittel — vier Unterbefehle, e2e-Erweiterung | | Nutzen | `████████░░` | Hoch — ohne das ist ein geleaktes Token oder ein verlorener Store Handarbeit am Server | | Bruchhäufigkeit | `██░░░░░░░░` | Selten — Notfall | | Nachhaltigkeit | `████████░░` | Hoch — Ablauf einmal getestet, danach Routine | | Dringlichkeit | `█████░░░░░` | Mittel — erster Verbraucher läuft produktiv | Teil von #1 (Umfang „Notfall-Zugang (Token-Rotation, Neuverifikation)“). ## Befund (Synapse 1.164.2, Quelltext) - Ein Login mit vorhandener Geräte-ID erzeugt ein neues Token für dasselbe Gerät, **alte Tokens bleiben gültig** (`register_device_inner` löscht nichts). - `POST /logout` mit dem alten Token löscht das **ganze Gerät** samt Schlüsseln — als Widerruf unbrauchbar. - Passwort setzen (`/account/password`, `logout_devices` Standard `true`) löscht alle anderen Geräte und alle Tokens außer dem anfragenden. Ein neues Passwort ist Pflicht, das bisherige ist erlaubt. - Cross-Signing-Schlüssel liegen heute nur im Krypto-Store. Store weg = Identität weg, alle Nutzer müssten neu verifizieren. ## Umfang | Unterbefehl | Zweck | |---|---| | `botkern rotate-token` | Bot gestoppt; Login mit derselben Geräte-ID (gleiche Krypto-Identität), danach Passwort neu setzen (`MATRIX_NEW_PASSWORD` oder das bisherige) → alle anderen Tokens/Geräte widerrufen; neues Token nur auf stdout-Pipe | | `botkern recovery-key` | Bot gestoppt; Secret Storage + Schlüssel-Backup einrichten (oder Schlüssel erneuern); Wiederherstellungsschlüssel nur auf stdout-Pipe | | `botkern recover` | nach Store-Verlust: neues Gerät (`botkern login`), leerer Store, `MATRIX_RECOVERY_KEY` → Cross-Signing-Schlüssel holen, neues Gerät selbst signieren (Nutzer vertrauen weiter), altes Gerät widerrufen | | `botkern reset-identity` | ohne Wiederherstellungsschlüssel: neue Cross-Signing-Identität, Nutzer verifizieren neu per SAS | Gemeinsam: Wächter ohne Warten (läuft der Bot, sofort Abbruch), `MATRIX_PASSWORD` für die Server-Rückfrage, keine Secrets in Logs. ## Abnahme (e2e, auch in `e2e-verify`) - Rotation: altes Token → 401, neues Token gleiche Geräte-ID, Echo im verschlüsselten Raum, Rotation bei laufendem Bot verweigert. - Recover: Store weggeschoben, neues Gerät, Bot-Identität bleibt beim Testnutzer verifiziert, neues Gerät gilt als verifiziert, altes Gerät gelistet nicht mehr. - Reset: Identität neu, Testnutzer verifiziert erneut per SAS. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Erledigt mit e739257 (feat/13-notfall, gemergt nach dev).

Abnahme (VM) Ergebnis
Rotation bei laufendem Bot verweigert
rotate-token altes Token 401, neues Token 200, gleiche Geräte-ID, Echo ok
recovery-key Schlüssel nur als Pipe
recover nach Store-Verlust neues Gerät, Bot-Identität und Gerät beim Testnutzer weiter verifiziert, altes Token 401, Echo ok
reset-identity alte Verifizierung ungültig, erneute SAS-Verifizierung ok

nix build .#e2e und .#e2e-verify grün. Nebenbefund (pemmikan Fallen): nach reset-identity warnt der Bot über die gelöschte Backup-Version, bis recovery-key läuft.

🤖 angelegt von Claude v00 (API/Token holm)

Erledigt mit e739257 (`feat/13-notfall`, gemergt nach `dev`). | Abnahme (VM) | Ergebnis | |---|---| | Rotation bei laufendem Bot | verweigert | | `rotate-token` | altes Token 401, neues Token 200, gleiche Geräte-ID, Echo ok | | `recovery-key` | Schlüssel nur als Pipe | | `recover` nach Store-Verlust | neues Gerät, Bot-Identität und Gerät beim Testnutzer weiter verifiziert, altes Token 401, Echo ok | | `reset-identity` | alte Verifizierung ungültig, erneute SAS-Verifizierung ok | `nix build .#e2e` und `.#e2e-verify` grün. Nebenbefund (pemmikan Fallen): nach `reset-identity` warnt der Bot über die gelöschte Backup-Version, bis `recovery-key` läuft. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-16 10:27:21 +01:00
Sign in to join this conversation.
No description provided.