Chat Identity – Concept

1
userId    → identifiziert den USER  – geräteübergreifend stabil
2
clientId  → identifiziert das GERÄT – userübergreifend stabil

1
Gerät (clientId: abc...)
2
  ├── User A (userId: xyz...)
3
  └── User B (userId: def...)
4
 
5
User A (userId: xyz...)
6
  ├── iPhone  (clientId: abc...)
7
  └── MacBook (clientId: ghi...)

1
Private Key  =  dein geheimer Schlüssel
2
                → verlässt nie das Gerät
3
                → wird niemals übertragen
4
                → damit werden Nachrichten "unterschrieben"
5
 
6
Public Key   =  dein öffentliches Schloss
7
                → kann jedem gegeben werden
8
                → Peers kennen dich dadurch
9
                → daraus wird die ID abgeleitet

1
privateKey existiert → publicKey immer ableitbar → ID immer gleich ✅
2
privateKey verloren  → neue ID – wie ein neuer SSH-Key             ⚠️

1
Erster Start auf diesem Gerät →
2
  Ed25519 Keypair generieren (Web Crypto API)
3
  privateKey → xpulse_identity_client_private_key  (localStorage, AES-GCM verschlüsselt)
4
  publicKey  → SHA-256(publicKey) = clientId
5
             → xpulse_identity_client_id            (localStorage)
6
             → xpulse_identity_client_public_key    (localStorage)

1
App startet →
2
  xpulse_identity_client_id vorhanden? →
3
    JA  → laden, verwenden – FERTIG, nie neu generieren
4
    NEIN → erster Start → Keypair generieren → speichern

1
Backup importieren → privateKey wiederhergestellt
2
                   → clientId reproduzierbar → Peers kennen das Gerät noch ✅

1
Erster Login / Registrierung →
2
  Ed25519 Keypair generieren (Web Crypto API)
3
  Eingaben: login + password + timestamp + UUID v4
4
  salt       → crypto.getRandomValues(32 bytes)
5
             → xpulse_identity_{userId}_salt        (localStorage)
6
  privateKey → xpulse_identity_{userId}_private_key (localStorage, AES-GCM verschlüsselt
7
                                                      mit PBKDF2(password + salt))
8
  publicKey  → SHA-256(publicKey) = userId
9
             → xpulse_identity_{userId}_public_key  (localStorage)

1
⚠️  userId DARF NIEMALS neu generiert werden solange Daten existieren.
2
⚠️  Datenverlust durch userId-Änderung ist inakzeptabel.
3
⚠️  Vor JEDEM Breaking Change: prüfen ob userId migriert werden muss.

1
App startet →
2
  xpulse_identity_{userId}_public_key vorhanden? →
3
    JA  → laden, verwenden – FERTIG, nie neu generieren
4
    NEIN → erster Start → Keypair + Salt generieren → speichern

1
xpulse_identity_{userIdA}_private_key   ← nur User A
2
xpulse_identity_{userIdB}_private_key   ← nur User B
3
xpulse_chat_{userIdA}_profile           ← nur User A
4
xpulse_chat_{userIdB}_profile           ← nur User B

1
Nachricht gesendet:
2
  senderId = userId    ← wer hat geschrieben?
3
  clientId = clientId  ← von welchem Gerät?

1
Chat mit Johnny:
2
  userId:   xyz...     ← immer gleich, egal welches Gerät
3
  clientId: abc...     ← iPhone
4
  clientId: ghi...     ← MacBook (wenn auch verbunden)

1
Ed25519 verfügbar (moderne Browser)?  → verwenden ✅
2
Nicht verfügbar?                       → Fallback: ECDSA (P-256)
3
                                         + Info-Hinweis in UI:
4
                                         "Dein Browser verwendet einen älteren
5
                                          Verschlüsselungsstandard.
6
                                          Ein Browser-Update wird empfohlen."

1
Verschlüsselungs-Key = PBKDF2(loginPassword + userSalt) → encryptionKey
2
 
3
privateKey speichern:
4
  AES-GCM encrypt(privateKey, encryptionKey) → localStorage
5
 
6
privateKey lesen:
7
  salt laden → PBKDF2(loginPassword + salt) → encryptionKey
8
  AES-GCM decrypt(encrypted, encryptionKey) → privateKey

1
Backup-Passwort Stärke-Indikator:
2
  < 8 Zeichen    → schwach  (roter Balken)
3
  8-12 Zeichen   → mittel   (gelber Balken)
4
  > 12 Zeichen   → stark    (grüner Balken)

1
Alt                          → Neu
2
────────────────────────────────────────────────────
3
xp_* Keys                   → xpulse_chat_* / xpulse_identity_*
4
kein Keypair                 → Ed25519 Keypair generieren
5
kein userId                  → SHA-256(publicKey) = userId
6
kein Salt                    → crypto.getRandomValues(32) = salt
7
kein verschlüsselter PK      → privateKey mit PBKDF2(pw + salt) verschlüsseln
8
Profil ohne neue Felder      → migrateProfile() – fehlende Felder ergänzen
9
Messages ohne v / id etc.    → migrateV0() im ChatConverter

1
✓ Keypair generierbar und verifizierbar?
2
✓ userId aus publicKey ableitbar?
3
✓ Salt generiert?
4
✓ privateKey verschlüsselbar und wieder entschlüsselbar? (Test-Runde)
5
✓ Alle Chat-IDs aus altem Format gefunden?
6
✓ Alle Messages pro Chat vollständig?
7
✓ Profil vollständig migriert?
8
✓ Alle Graveyard-Einträge übernommen?
9
✓ Neue Key-Struktur konsistent mit ADR-003?

1
⚠️  userId wird bei dieser Migration NEU generiert.
2
⚠️  Alle Chat-Daten werden unter die neue userId migriert.
3
⚠️  Erst wenn ALLE Checks bestanden sind wird der Switch durchgeführt.
4
⚠️  Bei Fehler: vollständiger Rollback, Original unangetastet.