87 lines
3.6 KiB
Markdown
87 lines
3.6 KiB
Markdown
# Starface Chat löschen
|
|
|
|
Kleines Bash-Script, das den kompletten UCC-Chatverlauf eines einzelnen
|
|
Starface-Users aus der internen Openfire-Chat-DB löscht. Nötig, weil Starface
|
|
in der App/Admin-UI selbst keine Möglichkeit bietet, den Chatverlauf eines
|
|
Users zu löschen — z.B. wenn ein Mitarbeiter das Unternehmen verlässt.
|
|
|
|
## Hintergrund
|
|
|
|
Starface nutzt für den UCC-Chat einen eingebetteten **Openfire-XMPP-Server**,
|
|
der dieselbe Postgres-Datenbank (`asterisk`) wie die restliche PBX verwendet.
|
|
Relevant sind zwei Tabellen (Openfire Monitoring-Plugin):
|
|
|
|
- `ofmessagearchive` — die eigentlichen Chat-Nachrichten (`fromjid`, `tojid`, `body`, `sentdate`, ...)
|
|
- `ofconversation` — Konversations-Header (Zeitraum, Nachrichtenanzahl je `conversationid`)
|
|
|
|
Es gibt **keine offizielle API** dafür — die Löschung passiert direkt per SQL
|
|
auf dem Starface-Server.
|
|
|
|
## Voraussetzungen
|
|
|
|
- SSH-Zugriff auf den Starface-Server (root oder ein User mit `sudo -u postgres`-Rechten)
|
|
- `psql` muss installiert sein (bei Starface Standard)
|
|
- Script liegt/läuft direkt **auf** dem Starface-Server (nicht remote per SQL-Tunnel)
|
|
|
|
## Nutzung
|
|
|
|
```bash
|
|
./delete_starface_chat.sh <user_id>
|
|
```
|
|
|
|
Beispiel — Mitarbeiter mit der Starface-Benutzer-ID `0022` verlässt das Unternehmen:
|
|
|
|
```bash
|
|
./delete_starface_chat.sh 0022
|
|
```
|
|
|
|
`<user_id>` ist die Starface-Benutzernummer/-ID wie sie intern als JID genutzt
|
|
wird (JID-Format `<user_id>@<starface-host>`) — einfach die Nummer/den
|
|
Login-Namen des Users angeben.
|
|
|
|
## Was das Script macht
|
|
|
|
1. Sucht alle Nachrichten in `ofmessagearchive`, bei denen der angegebene
|
|
User Absender **oder** Empfänger ist (`fromjid`/`tojid LIKE '<user_id>@%'`).
|
|
2. **Erstellt zuerst ein Backup** — CSV-Dump aller betroffenen Nachrichten und
|
|
Konversationen nach `/var/backups/starface_chat_backups/`, bevor irgendwas
|
|
gelöscht wird.
|
|
3. Löscht die betroffenen Zeilen aus `ofmessagearchive`.
|
|
4. Löscht die zugehörigen `ofconversation`-Einträge — aber **nur**, wenn nach
|
|
dem Löschen wirklich keine Nachricht mehr auf diese `conversationid`
|
|
verweist (Konversations-Header bleibt sonst stehen).
|
|
5. Gibt am Ende die verbleibende Nachrichtenanzahl für den User aus (sollte `0` sein).
|
|
|
|
Alles läuft in **einer Transaktion** (`BEGIN` / `COMMIT`) — entweder alles
|
|
oder nichts.
|
|
|
|
## Wichtige Einschränkung: gemeinsame Konversation
|
|
|
|
Openfire speichert eine Konversation zwischen zwei Usern als **eine
|
|
gemeinsame** Nachrichten-Historie — es gibt **keine getrennten Kopien** pro
|
|
Teilnehmer (kein "Postfach pro User").
|
|
|
|
Das heißt konkret: Löscht man z.B. User `0022`, der einen Chat mit User `0005`
|
|
hatte, verschwindet dieser Chat **für beide Seiten** — nicht nur bei `0022`.
|
|
Andere Chats von `0005` mit anderen Kollegen (ohne `0022`) bleiben davon
|
|
unberührt.
|
|
|
|
Es gibt technisch keinen Weg, "nur die Hälfte" eines Chats zu löschen, ohne
|
|
die Nachrichten zu duplizieren oder zu anonymisieren (Body/Name ersetzen statt
|
|
Zeile zu löschen) — das macht dieses Script bewusst nicht, da vollständige
|
|
Löschung (z.B. aus DSGVO-Gründen beim Austritt eines Mitarbeiters) hier das
|
|
Ziel war.
|
|
|
|
## Sicherheit
|
|
|
|
- Backup **vor** jeder Löschung, automatisch, ungefragt.
|
|
- Input-Validierung: `user_id` darf nur `A-Za-z0-9._-` enthalten (keine SQL-Injection über das Argument).
|
|
- `set -euo pipefail` — Script bricht bei jedem Fehler sofort ab.
|
|
- Bei `0` gefundenen Nachrichten: Script beendet sich ohne jede Aktion.
|
|
|
|
## Wiederherstellung aus dem Backup
|
|
|
|
Die CSV-Backups liegen unter `/var/backups/starface_chat_backups/` und lassen
|
|
sich bei Bedarf mit `\copy ... FROM ... WITH CSV HEADER` wieder in die
|
|
jeweilige Tabelle zurückspielen.
|