# HORST Secret Chat

Privat bleibt privat. Kostenloser, quelloffener Messenger für Direktchats und private Gruppen,
Text, Fotos, Dateien und Sprachmemos. Benutzername statt Telefonnummer oder E-Mail-Adresse.

**Stand 0.6.5: Entwicklungsfassung, nicht zur vertraulichen Produktivkommunikation freigegeben.**
Der Protokollentwurf ist neu und nicht unabhängig auditiert. Standardisierte
Kryptografie-Bausteine machen die gesamte Anwendung nicht automatisch sicher.
Aktuelle Einschränkungen: [docs/RELEASE-STATUS.md](docs/RELEASE-STATUS.md).

## Enthalten

- Weboberfläche für den PC und Capacitor-Projekte für Android und iOS.
- Deutsch, Englisch, Französisch, Spanisch, Portugiesisch und Arabisch mit RTL.
- Direktchats per genauem Benutzernamen, ohne Suchhistorie. Kontakte werden nach
  dem ersten Nachrichtenaustausch ausschließlich lokal behalten.
  Jeder Teilnehmer kann den gesamten Direktchat für beide löschen.
- Sprachmemos bis fünf Minuten mit Vorschau vor dem verschlüsselten Versand.
- Private Einladungen per Benutzername oder Einmal-Link, maximal 32 Mitglieder.
  Nach Annahme signiert das verbundene Gründergerät den Beitritt automatisch.
  Kein zweites Antippen durch den Gründer; ohne sein verbundenes Gerät wartet der Beitritt.
- Gruppenfrist von einer Minute bis sieben Tagen; Absender können die Frist verkürzen.
- Alternativ dauerhafte Gruppen. Eine zusätzliche lokale Gruppen-PIN ist bei
  jeder Nachrichtenfrist optional.
- App-PIN ab vier nicht trivialen Ziffern, empfohlen sechs oder mehr; erneute
  Sperre nach 30 Minuten außerhalb der App und bei vollständigem Neustart.
- Eigenen Nachrichten lang drücken: Löschung für alle bei nächster Verbindung.
- Gruppeneinladungen per genauem Benutzernamen oder einmal verwendbarem Link.
- Android-FCM für neutrale neue Nachrichten, ohne dauerhaften Vordergrunddienst.
  Reale Vordergrund- und Hintergrundbenachrichtigungen sind mit 0.6.2 auf beiden
  Xiaomi-Testgeräten nachgewiesen; Systemlautstärke und Ruhemodus bleiben wirksam.
- Nativer Android-Tor-Fallback zum eigenen Relay bei gestörter HTTPS-Verbindung;
  Eigene Onion-Abfragen sind auf beiden Xiaomi nachgewiesen; iOS-Adapter noch offen.
  Tor umgeht Netzsperren, repariert keinen ausgefallenen Relay. Siehe docs/TOR-FALLBACK.md.
- Texte und Dateien bis 10 MiB, verschlüsselt einschließlich Dateiname und Gruppenname.
- Kameraaufnahme direkt im Chat mit Vorschau als Anhang vor dem Senden.
  Die Kamera läuft nur in der geöffneten Aufnahmeansicht; kein Ton wird aufgenommen.
- Integrierte Tastatur mit QWERTZ/QWERTY-Umschaltung, Akzenten und mehrzeiligem,
  mitwachsendem Textfeld. Einfügen aus der Zwischenablage nur auf eigene Aktion.
  Bei aktivierter integrierter Tastatur geht die Eingabe nicht an eine externe
  Bildschirmtastatur; das schützt nicht vor einem kompromittierten Betriebssystem.
- Ungelesene Chats sind lokal markiert, ohne serverseitige Lesebestätigungen.
- ML-KEM-1024 für einmalige Empfängerschlüssel, ML-DSA-87 für Identitäten und
  Signaturen, AES-256-GCM für Nachrichten und Anhänge. Die Zahl 1024 bezeichnet
  hier den ML-KEM-Parametersatz, nicht 1024 Bit garantierte Quantensicherheit.
- Ausschluss sperrt Serverzugriff sofort; unveränderte Clients entfernen die
  lokale Gruppe beim nächsten erfolgreichen Abgleich. Ohne aktuelle Verbindung
  wird die Anzeige spätestens nach 30 Sekunden gesperrt.
- Blockieren, Meldungen ohne Chatinhalte und Kontolöschung.
- Offline-Wiederherstellung durch 128 Zufallsbytes in genau 256 Hex-Zeichen.
  Der Code ersetzt den aktiven Gerätezugang, entschlüsselt keine fremden Chats
  und stellt keine gelöschten Nachrichten wieder her.

## Lokal starten

Node.js 24 verwenden. Abhängigkeiten sind im Lockfile festgehalten.

```sh
npm ci
npm test
npm run dev
```

Die Entwicklung startet Vite und einen separaten lokalen Relay-Prozess.
Für die verschlüsselte Browserablage ist ein sicherer Browserkontext erforderlich:
HTTPS oder localhost. Die Vorschau unter einer gewöhnlichen HTTP-Domain ist
deshalb auf die Darstellung beschränkt. Testkonten ausschließlich mit Testdaten.

```sh
npm run build
SMCHAT_DATA=/var/lib/horst-secret-chat npm run server
```

Der Server bindet standardmäßig nur an 127.0.0.1:8789. Für native Builds muss
`VITE_API_ORIGIN` vor dem Web-Build auf den tatsächlich eingerichteten HTTPS-Relay
gesetzt werden, danach `npx cap sync`. Die Testoberfläche und der Relay sind unter `https://chat.horst-fahrt.de/`
erreichbar. Android benötigt JDK 25 und Android SDK 37.1 (Zielversion 36);
iOS benötigt einen Mac mit passender Xcode-Version und Apple-Signierung.

## Daten und Löschung

Der Relay hält ausschließlich bereits Ende-zu-Ende-verschlüsselte Nachrichten
in einem dauerhaften SQLite-Zwischenspeicher und im Arbeitsspeicher,
bis alle jeweiligen Empfänger bestätigt haben oder die Frist abläuft. Nach
Bestätigung wird die betreffende Empfängerhülle entfernt. Der gemeinsame
verschlüsselte Inhalt bleibt nur so lange erhalten, wie ein anderer Empfänger
ihn noch benötigt. Nicht abgelaufene Zustellungen überstehen einen Dienstneustart.
Empfangsbestätigungen löschen die gespeicherten Empfängerhüllen; nach der letzten
Bestätigung wird auch der Chiffretext gelöscht. SQLite verwendet secure_delete.
Es bleibt keine abgeschlossene Zustellhistorie und kein Nachrichtenhash zurück.
Die signierte Nachrichtenkennung ist an die einmalige Sendevormerkung gebunden.
Der Sender sieht „gesendet“, keine Lese- oder dauerhaften Zustellquittungen.
Geht die Versandantwort verloren, kann nach bereits erfolgter Löschung keine
verbindliche Zustellbestätigung nachgeliefert werden.

SQLite enthält technische Kontodaten: Benutzername, öffentliche Schlüssel,
signierte Gruppenmitgliedschaften, Sitzungshashes, öffentliche Empfangsschlüssel,
Einladungen und optional Push-Kennungen. Meldungen enthalten Kontokennungen und
einen ausgewählten Grund, keine Nachrichtentexte; sie verfallen nach 30 Tagen.
Gelöschte Konten hinterlassen eine minimale Sperrkennung gegen Reaktivierung
durch alte Geräteschlüssel. Das ist Datenminimierung, kein Betrieb ohne jede
personenbeziehbare technische Information.

Der Anwendungscode führt keine Zugriffsprotokolle und speichert keine IP-Adressen.
Reverse Proxy, Hosting, Betriebssystem, Backups, Swap und Crash-Dumps müssen vor
Betrieb zusätzlich geprüft werden. Die Netzwerkverbindung verarbeitet IP-Adressen
technisch; wir behaupten keine IP-Anonymität gegenüber Hostern, Apple, Google oder Providern.

Exportierte Dateien, Bildschirmfotos, Gerätekompromittierung und veränderte Clients
liegen außerhalb der Löschkontrolle. Die lokale Verschlüsselung ersetzt keine
vollständige Gerätesicherheit oder nachgewiesene forensische Löschung. Android
speichert den lokalen Vault ab 0.4 mit einem nicht exportierbaren Keystore-Schlüssel.
Jeder geänderte Speicherstand bekommt einen neuen Schlüssel; erst nach gesichertem
Schreiben wird der vorherige entfernt. Die Hardwareabsicherung hängt vom Gerät ab.
Browser und noch nicht gebautes iOS verwenden rotierende WebCrypto-Schlüssel im
App-/Browserprofil. Details und Restmetadaten: [docs/METADATA.md](docs/METADATA.md).

## Projekteigentümer und Beiträge

`rabbi1384` ist für den mit `SMCHAT_OWNER_ACCOUNT` festgelegten öffentlichen
Root-Schlüssel reserviert. Die Schreibweise allein verleiht keine Administratorrechte.
Auch `Sonja_B` (intern `sonja_b`) ist für einen eigenen öffentlichen Root-Schlüssel
über `SMCHAT_SONJA_ACCOUNT` reserviert. Beide haben dieselben Projekt-Adminrechte.
Die beiden Wiederherstellungsschlüssel sind getrennt auf dem Eigentümerrechner
erzeugt worden. Dieses Quellpaket enthält keinerlei private Schlüssel.
Niemand erhält einen Generalschlüssel für fremde Nachrichten.

Quellcode und Dokumentation sollen auf den Servern von S&M Future angeboten werden,
ohne GitHub. Lizenz: **AGPL-3.0-only**, vollständiger Text in [LICENSE](LICENSE).
Abhängigkeiten behalten ihre eigenen Lizenzen. Sicherheitsmeldungen zunächst ohne
private Nutzerinhalte an info@smfuturegmbh.de; für vertrauliche Details zuvor einen
geeigneten verschlüsselten Übermittlungsweg abstimmen. Es ist noch kein öffentlicher
Sicherheitskontakt-Schlüssel eingerichtet. Prüfberichte müssen Version, Prüfumfang,
Datum und offene Befunde nennen; Quelloffenheit ist kein bestandenes Audit.

## Eigener Onion-Zugang

Tor Browser kann denselben Relay unter
http://ijzavx2bs6nhvcxsmefk5jpwqrih3faajxvzkicvlu2iquc3kkcconqd.onion/
verwenden. Die Weboberfläche sendet API-Aufrufe an ihren eigenen Ursprung. Die
Android-App nutzt den eigenen HTTPS-Relay und bei Netzproblemen denselben Relay
über den integrierten Tor-Zugang. Es gibt weder
Föderation noch eine Auswahl fremder Server. Der Tor-Dienst ist eine getrennte
private Installation; Sicherheitsupdates seiner Pakete müssen überwacht werden.

## Ergänzungen ab 0.5

Android nutzt im bestehenden Firebase-Projekt nur Firebase Messaging. Analytics
und BigQuery-Zustellmetriken sind deaktiviert. Die Android-Konfiguration enthält
öffentliche App-/Projektkennungen; private Dienstkontoschlüssel gehören ausschließlich
in die geschützte Serverkonfiguration. FCM erhält Zieltoken, generischen Hinweis
und technische Zustelldaten, weder Absender noch Chat-ID, Nachrichtentext oder Datei.
Google kennt unter anderem Gerät-/Verbindungsdaten und Zustellzeitpunkte; dies ist
kein metadatenfreier Kanal. Ein zusammengefasster Hinweis kann bis zu 24 Stunden
zwischengespeichert werden und bei bereits verfallener Nachricht verspätet erscheinen.
Der eigene Relay bleibt alleiniger Transport der verschlüsselten Chatinhalte.

Kontakte löschen entfernt den Direktchat für beide und Nachrichten dieses Autors
in Gruppen aus der eigenen Ansicht. Andere Gruppenmitglieder behalten ihre Kopien.
Eigene Nachrichten lassen sich für alle löschen. Signierte Löschbefehle enthalten
minimale Nachrichten-/Gruppen-/Autorkennungen und offene Zielgeräte, bis alle bestätigt
haben oder die Nachricht abläuft. Bei dauerhaft gespeicherten Nachrichten besteht
keine automatische Frist für diese noch nötigen Löschbefehle. Gruppenausschluss,
Gruppen- und Kontolöschung räumen nicht mehr relevante Ziele auf.

Dauerhafte Gruppen speichern Nachrichten lokal bis zur ausdrücklichen Löschung.
Der Relay hält unzugestellte Inhalte trotzdem höchstens sieben Tage. Jedes Mitglied
kann unabhängig davon eine eigene lokale Gruppen-PIN setzen; eine zusätzliche lokale ML-KEM/AES-Verschlüsselung
schützt Gruppeninhalte unabhängig von der App-PIN. Die App-PIN verschlüsselt den
gesamten Vault zusätzlich mittels PBKDF2-SHA256 (600000 Iterationen) und AES-256-GCM.
Vierstellige PINs haben geringe Entropie; Verzögerungen und Geräteschlüssel ersetzen
keinen Schutz gegen ein vollständig kompromittiertes Endgerät.

Einladungen per Link verfallen nach 24 Stunden und werden atomar genau einem Konto
zugeordnet. Einladungen an Benutzernamen sind an das Zielkonto gebunden und können
angenommen oder abgelehnt werden. Das verbundene Gründergerät bestätigt angenommene Einladungen automatisch anhand
der serverseitig bestätigten Beitrittsanfrage. Eine lokale Kopie der versendeten
Einladung ist dafür nicht mehr nötig. Ab 0.6.5 können andere aktuelle Mitglieder noch vorhandenen Verlauf und signierte
Gruppennamen Ende-zu-Ende verschlüsselt übertragen, auch nach einem Gerätewechsel
in Direktchats. Ablaufzeiten bleiben erhalten; kein Serverarchiv und keine lokale
Altgeräte-Archivkopie. Details und Grenzen: [docs/PEER-HISTORY.md](docs/PEER-HISTORY.md).

Die iOS-Fortsetzung und tatsächliche Build-/Einreichungsgrenzen stehen in
[docs/IOS-CONTINUATION.md](docs/IOS-CONTINUATION.md).
