XMPP-Server: Unterschied zwischen den Versionen
Geierb (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Bg3992 (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
(98 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
==Ziel== |
==Ziel== |
||
Konkurrenzfähiger, zuverlässiger, selbst betriebener, erweiterbarer Instant |
Konkurrenzfähiger, zuverlässiger, selbst betriebener, erweiterbarer Instant Messenger mit allen derzeitig üblichen Funktionen. |
||
Bingo-Mitglieder sollen automatisch einen Zugang erhalten. |
|||
Für Bytwerk-Mitglieder soll es Accounts mit Wunschnamen geben. Bestehende Bytewerk-Zugänge sollen erhalten bleiben. |
|||
==Verantwortlich== |
==Verantwortlich== |
||
* [[Benutzer:sqozz|sqozz]] |
* [[Benutzer:sqozz|sqozz]] |
||
* [[Benutzer:Cfr34x|cfr34k]] |
* [[Benutzer:Cfr34x|cfr34k]] |
||
* [[Benutzer: |
* [[Benutzer:Geierb|Geierb]] |
||
== Benutzerzugänge == |
|||
==Ansatz== |
|||
XMPP (früher: Jabber) als Protokoll: Weit verbreitet, gute Clients verfügbar, Server ist Freie Software. |
|||
Jedes Bingo-Mitglied hat automatisch einen Account. |
|||
Auf der VM "xmpp.bytewerk.org" läuft bereits Prosody. Dessen Konfiguration wird korrigiert und fehlende Funktionen eingetragen. DNS-Einträge werden geprüft und ergänzt. Für Jingle wird ein TURN-Server installiert. |
|||
Die JID ist identisch zur Bingo-E-Mail-Adresse, das Passwort ist das Bingo-E-Mail-Passwort. |
|||
E-Mail-Aliase der Domains @bingo-ev.de und @bytewerk.org können ebenfalls als JIDs verwendet werden. |
|||
XMPP wird wie bisher auf der Domain "bytewerk.org" angeboten und zusätzlich auf "bingo-ev.de": |
|||
* Accounts für die '''bytewerk.org'''-Domain werden, wie bisher auch, lokal angelegt und verwaltet. |
|||
* Benutzer der '''bingo-ev.de'''-Domain sollen gegen den IMAP-Server "mail.bingo-ev.de" authentifiziert werden: Werden Benutzername und Passwort vom Mailserver bestätigt, so soll der Nutzer auch den XMPP-Server benutzen dürfen. Um es möglichst einfach zu halten soll auch die JID identisch zur E-Mail-Adresse sein. |
|||
Informationen für Anwender finden sich hier: https://xmpp.bytewerk.org/ |
|||
== Chaträume == |
|||
=== Grunsätzlich === |
|||
Jeder kann nach Belieben Chaträume anlegen. |
|||
=== Automatisch angelegte Chaträume === |
|||
==Benutzerzugänge== |
|||
Folgende Chaträume werden automatisch angelegt: |
|||
=== <wunschname>@bytewerk.org === |
|||
* [xmpp:bingo-users@conference.bingo-ev.de bingo-users@conference.bingo-ev.de] [https://conference.bingo-ev.de/muc_badge/bingo-users@conference.bingo-ev.de] |
|||
* [xmpp:bytewerk@conference.bytewerk.org bytewerk@conference.bytewerk.org] [https://conference.bytewerk.org/muc_badge/bytewerk@conference.bytewerk.org] |
|||
=== Badges === |
|||
Accounts werden auf Zuruf erstellt. |
|||
Badges für Chaträume können über https://conference.<DOMAIN>/muc_badge/<MUC-JID> abgerufen werden. |
|||
Beispiele: |
|||
Das Passwort kann direkt im XMPP-Client geändert werden. |
|||
* Das Badge für [xmpp:bytewerk@conference.bytewerk.org bytewerk@conference.bytewerk.org] kann über die URL https://conference.bytewerk.org/muc_badge/bytewerk@conference.bytewerk.org abgerufen werden und sieht so aus: [[Datei:MUC badge bytewerk.png|frameless|caption]] |
|||
* Das Badge für [xmpp:bingo-users@conference.bingo-ev.de bingo-users@conference.bingo-ev.de] kann über die URL https://conference.bingo-ev.de/muc_badge/bingo-users@conference.bingo-ev.de abgerufen werden und sieht so aus: [[Datei:MUC badge bingo-users.png|frameless|caption]] |
|||
=== IRC-Chat === |
|||
Webclient: https://xmpp.bytewerk.org/conversejs-bytewerk |
|||
Zum Betreten von IRC-Chats einfach einen neuen Chat mit dem Muster '''#CHANNEL%SERVER@biboumi.bytewerk.org''' anlegen. |
|||
Beispiel: |
|||
Um den Channel '''#pypy''' auf '''irc.libera.chat''' zu besuchen, einen neuen Chat mit der Adresse '''#pypy%irc.libera.chat@biboumi.bytewerk.org''' starten. |
|||
=== <Bingo-Benutzername>@bingo-ev.de === |
|||
Im XMPP-Client werden dann automatisch der Channel und der IRC-Server als Gesprächspartner hinzugefügt. |
|||
Jedes Bingo-Mitglied hat automatisch einen Account. |
|||
Sollten die Nachrichten des IRC-Servers stören: Diesen einfach als Gesprächspartner blockieren. |
|||
== XMPP-Clients == |
|||
Passwort ist das Bingo-E-Mail-Passwort, die JID ist identisch zur E-Mail-Adresse. |
|||
Es kann jeder XMPP-Client verwendet werden. Empfehlenswerte Clients für Android, iOS, Linux, Windows und MacOS sind auf https://xmpp.bytewerk.org/ aufgeführt. |
|||
=== Webclients === |
|||
Da zur Authentifizierung der Bingo-Mailserver benutzt wird, kann das Passwort nicht im XMPP-Client geändert werden. |
|||
Auf xmpp.bytewerk.org ist Converse.js installiert: |
|||
* [https://xmpp.bytewerk.org/conversejs-bingo XMPP-Webclient für @bingo-ev.de-Nutzer] |
|||
* [https://xmpp.bytewerk.org/conversejs-bytewerk XMPP-Webclient für @bytewerk.org-Nutzer] |
|||
Grundsätzlich kann sich jeder XMPP-Nutzer an jedem XMPP-Webclient anmelden. Je nach URL werden nur ein paar Voreinstellungen passend zur Domain gesetzt um die Benutzung von Converse.js zu erleichtern. |
|||
Webclient: https://xmpp.bytewerk.org/conversejs-bingo |
|||
=== Sonstige === |
|||
== Empfehlenswerte Clients == |
|||
In '''Thunderbird''' ist ein sehr einfacher Client (nur Text) integriert ("Konten" -> "Chat-Konto" hinzufügen). |
|||
* Android: Conversations.im, Quicksy.im |
|||
* iOS: Monal.im |
|||
* Windows/Linux/BSD: Gajim |
|||
* macOS: PSI |
|||
Für '''Nextcloud''' gibt es mit der [https://apps.nextcloud.com/apps/ojsxc ojsxc-App] einen sehr gut ausgestatteten webbasierten Client. |
|||
Ein sehr einfacher Client (nur Text, keine Gruppenchats) ist in '''Thunderbird''' eingebaut ("Chat-Konto"). |
|||
Für '''Nextcloud''' gibt es mit der ojsxc-App (https://apps.nextcloud.com/apps/ojsxc) einen sehr gut ausgestatteten webbasierten Client. |
|||
== Unterstützte Funktionen == |
== Unterstützte Funktionen == |
||
=== Übersicht === |
|||
* Gruppen |
|||
* Gruppen (öffentlich/privat/mit Einladung, moderiert/unmoderiert) |
|||
* Audio- und Videotelefonie |
* Audio- und Videotelefonie |
||
* Sprach- und Videonachrichten |
|||
* Ende-zu-Ende-Verschlüsselung |
* Ende-zu-Ende-Verschlüsselung |
||
* Dateiup- und Download (wird auch für Sprach- und Videonachrichten verwendet) - Dateigröße derzeit limitiert auf |
* Dateiup- und Download (wird auch für Fotos, Sprach- und Videonachrichten verwendet) - Dateigröße pro Upload derzeit limitiert auf 100 MByte. |
||
* Gleichzeitiges Verwenden mehrerer Clients |
* Gleichzeitiges Verwenden mehrerer Clients |
||
* Push |
|||
* IRC |
|||
[https://compliance.conversations.im/live/bytewerk.org/ 100% Compliance] zu Conversations |
|||
Dateien und Chatverläufe werden nach einem Monat vom Server gelöscht. |
|||
Die bei der Kommunikation mit einem bestimmten Gesprächspartner zur Verfügung stehenden Funktionen ergeben sich aus der Schnittmenge des Funktionsumfangs der beteiligten XMPP-Server und der XMPP-Clients. |
|||
=== Die Kosten der Freiheit === |
|||
Beispiel: Ist mein Gesprächspartner ein Shellskript, das mir eine Nachricht schickt wenn die Waschmaschine fertig ist, werde ich kein Videotelefonat mit dem Skript führen können auch wenn es der Server unterstützt. |
|||
Die oben genannten Funktionen stehen nicht immer zur Verfügung, weil sich die bei der Kommunikation mit einem bestimmten Gesprächspartner zur Verfügung stehenden Funktionen aus der Schnittmenge des Funktionsumfangs der beteiligten XMPP-Server und der XMPP-Clients ergeben :) |
|||
Beispiel: Ist mein Gesprächspartner ein Shellskript, das mir eine Nachricht schickt wenn die Waschmaschine fertig ist, dann werde ich mit diesem kein Videotelefonat führen können, selbst wenn es mein XMPP-Client und der Server unterstützt. |
|||
Obacht bei der Verwendung von mehreren Clients gleichzeitig: Eine Nachricht gilt als zugestellt, wenn sie an EINEM Client des Empfängers angekommen ist. Das kann bei wackeliger Internetverbindung dazu führen, dass Nachrichten scheinbar nicht zugestellt wurden - sie landen dann nur bei dem Gerät, dass online war. Nicht alle Clients prüfen beim Wieder-Online-Gehen, ob in der Zwischenzeit Nachrichten für den Benutzer eingetroffen sind, die bereits an einem anderen Client zugestellt wurden. Threema, Whatsapp usw. umgehen das, indem sie keine parallele Nutzung zulassen. |
|||
Wichtig bei der '''gleichzeitigen Verwendung von mehreren Clients''': Eine Nachricht gilt als zugestellt, wenn sie an EINEM Client des Empfängers angekommen ist. Das kann bei wackeliger Internetverbindung dazu führen, dass Nachrichten scheinbar nicht zugestellt wurden - sie landen dann nur bei dem Gerät, dass gerade online ist. Zwar prüfen die meisten XMPP-Clients beim Wieder-Online-Gehen, ob in der Zwischenzeit Nachrichten eingetroffen sind, aber eben nicht alle. |
|||
Ebenso ist undefiniert, was passiert, wenn ein Videoanruf gestartet werden soll, der Gesprächspartner aber mit mehreren Clients online ist, von denen nicht alle Videotelefonie unterstützen. |
|||
Threema, Whatsapp usw. machen es sich einfach: Die verbieten schlicht die parallele Nutzung sowie Fremd-Clients. |
|||
== Fortschritt == |
== Fortschritt == |
||
;2021-01: Neukonfiguration des bestehenden XMPP-Servers mit Korrektur der DNS-Einträge und Installation zusätzlicher benötigter Dienste |
;2021-01: Neukonfiguration des bestehenden XMPP-Servers mit Korrektur der DNS-Einträge und Installation zusätzlicher benötigter Dienste |
||
;2021-02: Implementierung abgeschlossen: |
;2021-02: Implementierung abgeschlossen: Statt 52% jetzt 100% "XMPP Specifications compliance" beim [https://compliance.conversations.im/server/bytewerk.org/ Conversations.im-Compliance-Test], A-Scores beim IM Observatory [https://www.xmpp.net/result.php?domain=bytewerk.org&type=client Client-] und [https://www.xmpp.net/result.php?domain=bytewerk.org&type=server Server]-Test |
||
;2021-02: Bingo-Domäne mit IMAP-Authentifizierung hinzugefügt, Conversejs aktualisiert |
;2021-02: Bingo-Domäne mit IMAP-Authentifizierung hinzugefügt, Conversejs aktualisiert |
||
;2021-08: Serverkonfiguration auf Ansible umgestellt, dabei kleine Fehler behoben, neue Funktionen hinzugefügt, Conversejs aktualisiert. |
|||
;2022-08: Push-Services für Monal IM aktiviert |
|||
==Probleme== |
|||
;2022-09: IRC-Transport |
|||
* Plattenplatz sehr gering |
|||
* keine IPv6-Unterstützung: Die Prosody-VM hat zwar eine IPv6-Adresse, diese ist aber nicht öffentlich erreichbar |
|||
* <del>Wenn Coturn als TURN-Server statt "nur" als STUN-Server durch Prosody benutzt wird, funktioniert Audio- und Videotelefonie nur noch mit bytewerk.org-Usern und nicht mehr mit Externen.</del> |
|||
* Verbindung mit Websocket funktioniert nicht (und ist darum deaktiviert): Verbindung wird aufgebaut, dann gibt's einen Timeout. |
|||
* Conversejs ist stellenweise etwas umständlich zu bedienen. So muss z.B. zum Anlegen eines MUC die komplette Domain des eigenen XMPP-Servers eingegeben werden. Um das zu umgehen gibt es jeweils eine Conversejs-URL für @bingo-ev.de und @bytewerk.org, bei der durch entsprechende Vorkonfiguration das Anlegen von MUCs auch ohne Eintippen des Domainnamens funktioniert. Mittelfristig kann Conversejs eventuell durch [https://github.com/movim/movim/ Movim] ersetzt werden. Movim ist allerdings Stand 2/2021 noch zu buggy (siehe Issues [https://github.com/movim/movim/issues/964], [https://github.com/movim/movim/issues/972], [https://github.com/movim/movim/issues/974]). |
|||
==ToDo== |
|||
* Testen! Insbesondere: Funktioniert alle XMPP. Funktionen auch mit Nutzern aus anderen Domänen? Verhalten sich Mobilgeräte wie erwartet? (iOS Pushnachrichten, Stromsparmodus, Verzögerungen,...) |
|||
* Mehr Plattenplatz |
|||
* Backup |
|||
* Monitoring |
|||
== Implementierung == |
|||
Auf der VM '''xmpp.bytewerk.org''' läuft: |
|||
* [https://prosody.im/ Prosody]: XMPP-Server |
|||
* [https://www.postgresql.org PostgreSQL]: Datenbank |
|||
* [https://github.com/coturn/coturn Coturn]: TURN und STUN (für Jingle/WebRTC benötigt, d.h. Audio-/Videotelefonie sowie Dateiübertragung von Client zu Client) |
|||
* [https://github.com/conversejs/converse.js ConverseJS]: Webclient |
|||
* [https://httpd.apache.org/ Apache2]: HTTPS-Reverse-Proxy für File-Up- und -Downloads, .well-known-URLs, BOSH und Websocket, Bereitstellung von ConverseJS |
|||
* [https://github.com/DigitaleGesellschaft/Anonip Anonip]: Wird zum Logging in Apache2 benutzt um in den Access-Logs die letzten Stellen der IP-Adressen auf 0 setzen. Liegt unter ''/usr/local/Anonip.git'' |
|||
* [https://certbot.eff.org Certbot]: Für TLS-Zertifikatsaktualisierung |
|||
* Crond: Um Certbot wöchentlich aufzurufen und täglich das Fileupload-Verzeichnis aufzuräumen |
|||
* [http://etckeeper.branchable.com etckeeper]: Zum Nachverfolgen von Konfigurationsänderungen (git im /etc-Verzeichnis) |
|||
=== DNS === |
|||
XMPP-Clients nutzen die SRV-Records, um anhand der JID-Domäne eines Nutzer den Server, die Components und deren Ports zu herauszufinden. |
|||
XMPP-Server nutzen die SRV-Records, um den zu einer Component gehörenden Server samt Ports herauszufinden. |
|||
Die A/AAAA-Einträge werden zum Erstellen der TLS-Zertifikate gebraucht. |
|||
==== Auszug aus dem Zonefile von bytewerk.org ==== |
|||
<pre> |
|||
xmpp.bytewerk.org. 300 IN A 94.142.219.72 # Prosody-Server, Coturn-Server, Apache2 |
|||
conference.bytewerk.org. 300 IN A 94.142.219.72 # MUC-Component, Apache2 |
|||
proxy.bytewerk.org. 300 IN A 94.142.219.72 # Proxy65-Component, Apache2 |
|||
upload.bytewerk.org. 300 IN A 94.142.219.72 # HTTP-Fileupload, Apache2 |
|||
pubsub.bytewerk.org. 300 IN A 94.142.219.72 # PubSub-Component, Apache2 |
|||
_xmpp-client._tcp.bytewerk.org. 300 IN SRV 0 5 5222 xmpp.bytewerk.org. # VirtualHost XMPP-Server, C2S |
|||
_xmpps-client._tcp.bytewerk.org. 300 IN SRV 0 5 5223 xmpp.bytewerk.org. # VirtualHost XMPP-Server, C2S Legacy SSL auf Port 5223 |
|||
_xmpp-server._tcp.bytewerk.org. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # VirtualHost XMPP-Server, S2S |
|||
_xmpp-server._tcp.conference.bytewerk.org. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # MUC-Component, S2S |
|||
_xmpp-server._tcp.proxy.bytewerk.org. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # Proxy65-Component, S2S |
|||
_xmpp-server._tcp.pubsub.bytewerk.org. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # PubSub-Component, S2S |
|||
_xmppconnect.bytewerk.org. 300 IN TXT "_xmpp-client-xbosh=https://xmpp.bytewerk.org/http-bind" # BOSH |
|||
_xmppconnect.bytewerk.org. 300 IN TXT "_xmpp-client-websocket=wss://xmpp.bytewerk.org/xmpp-websocket" # Websocket |
|||
</pre> |
|||
==== Auszug aus dem Zonefile von bingo-ev.de ==== |
|||
<pre> |
|||
conference.bingo-ev.de. 300 IN A 94.142.219.72 # MUC-Component, Apache2 |
|||
proxy65.bingo-ev.de. 300 IN A 94.142.219.72 # Proxy65-Component, Apache2 ("proxy.bingo-ev.de" ist bereits belegt) |
|||
upload.bingo-ev.de. 300 IN A 94.142.219.72 # HTTP-Fileupload, Apache2 |
|||
pubsub.bingo-ev.de. 300 IN A 94.142.219.72 # PubSub-Component, Apache2 |
|||
_xmpp-client._tcp.bingo-ev.de. 300 IN SRV 0 5 5222 xmpp.bytewerk.org. # VirtualHost XMPP-Server, C2S |
|||
_xmpps-client._tcp.bingo-ev.de. 300 IN SRV 0 5 5225 xmpp.bytewerk.org. # VirtualHost XMPP-Server, C2S Legacy SSL auf Port 5225 |
|||
_xmpp-server._tcp.bingo-ev.de. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # VirtualHost XMPP-Server, S2S |
|||
_xmpp-server._tcp.conference.bingo-ev.de. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # MUC-Component, S2S |
|||
_xmpp-server._tcp.proxy65.bingo-ev.de. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # Proxy65-Component, S2S |
|||
_xmpp-server._tcp.pubsub.bingo-ev.de. 300 IN SRV 0 5 5269 xmpp.bytewerk.org. # PubSub-Component, S2S |
|||
_xmppconnect.bingo-ev.de. 300 IN TXT "_xmpp-client-xbosh=https://xmpp.bytewerk.org/http-bind" # BOSH |
|||
_xmppconnect.bingo-ev.de. 300 IN TXT "_xmpp-client-websocket=wss://xmpp.bytewerk.org/xmpp-websocket" # Websocket |
|||
</pre> |
|||
=== Subdomains und Zertifikate === |
|||
'''''Prosody''''' benötigt Zertifikate für ALLE beteiligten Domains, also auch von bytewerk.org und bingo-ev.de. Components ohne Zertifikat funktionieren nicht mit externen Usern. |
|||
Mit "prosodyct check" kann geprüft werden ob alle Zertikate passend zu den DNS-Einträgen und zu den Components vorhanden sind (Ausnahme: Legacy-SSL). |
|||
Für Feinheiten lohnt sich ein Blick in "/var/log/prosody/prosody.err", besonders mit eingeschaltetem "debug"-Loglevel. |
|||
'''''Coturn''''' benötigt nur das Zertifikat von xmpp.bytewerk.org |
|||
'''''Apache2''''' betreibt vHosts für folgende Hostnamen und benötigt die entsprechenden Zertifikate: |
|||
* xmpp.bytewerk.org |
|||
* conference.bytewerk.org, pubsub.bytewerk.org, proxy.bytewerk.org, upload.bytewerk.org |
|||
* conference.bingo-ev.de, pubsub.bingo-ev.de, proxy65.bingo-ev.de, upload.bingo-ev.de |
|||
==== Zertifikat für bytewerk.org und bingo-ev.de ==== |
|||
Das bytewerk.org- und das bino-ev.de-Zertifikat wird nur von Prosody (nicht Apache2, nicht Coturn) benötigt. |
|||
Bei Änderungen/Aktualisierungen müssen sie manuell auf den Server kopiert und User "prosody" übereignet werden. |
|||
Danach muss Prosody mit "prosodyctl reload" neu geladen werden. |
|||
===== bytewerk.org: ===== |
|||
* /etc/prosody/certs/bytewerk.org/privkey.pem |
|||
* /etc/prosody/certs/bytewerk.org/fullchain.pem |
|||
===== bingo-ev.de: ===== |
|||
* /etc/prosody/certs/bingo-ev.de/privkey.pem |
|||
* /etc/prosody/certs/bingo-ev.de/fullchain.pem |
|||
===== Alle anderen Zertifikate ===== |
|||
Alle Zertifikate außer dem von bytewerk.org und bingo-ev.de werden von LetsEncrypt-Certbot erstellt und liegen unter ''/etc/letsencrypt''. |
|||
Das Renewal wird per wöchentlichem Cronjob von root mit ''/usr/bin/certbot renew'' durchgeführt. |
|||
Zertifikate: |
|||
* xmpp.bytewerk.org |
|||
* conference.bytewerk.org, pubsub.bytewerk.org, proxy.bytewerk.org, upload.bytewerk.org |
|||
* conference.bingo-ev.de, pubsub.bingo-ev.de, proxy65.bingo-ev.de, upload.bingo-ev.de |
|||
Nach einem erfolgten Renewal führt Certbot die Post-Renewal-Hooks ''/etc/letsencrypt/renewal-hooks/post/'' aus: |
|||
* apache2.sh: Apache2 neu laden |
|||
* coturn.sh: Zertifikate nach ''/etc/coturn/certs/'' kopieren, Rechte anpassen und Coturn neu starten |
|||
* prosody.sh: Zertifikate nach ''/etc/prosody/certs/'' kopieren, Rechte anpassen und Prosody neu laden |
|||
=== Fileupload === |
|||
Der in Prosody eingebaute HTTP-Server unterstützt nur den Upload von Dateien <= 10 MByte und funktioniert nicht mit einigen iOS-Clients (z.B. Monal, Siskin). |
|||
Um diese Probleme zu umgehen empfiehlt Prosody, stattdessen das Modul "mod_http_upload_external" zu verwenden. |
|||
Bei dem Modul wird dazu das PHP-Skript "share_v2.php" benutzt, das unter dem Apache-vHost "https://upload.bytewerk.org/share_v2.php" (bzw. https://upload.bingo-ev.org/share_v2.php) eingebunden ist und hochgeladene Dateien unter "/srv/var/prosody-upload/<DOMAIN>/" abspeichert. |
|||
Dateien, die älter als ein Monat sind, werden per täglichem Cronjob von root gelöscht. |
|||
=== XEP-0368: .well-known-URLs === |
|||
Der Webserver bytewerk.org muss per Reverse Proxy für die URL https://bytewerk.org/.well-known/host-meta(.json) auf http://xmpp.bytewerk.org/.well-known/... verweisen. Ein Redirect reicht nicht, da die CORS-Header in Prosody konfiguriert und gesetzt werden. Gleiches gilt für den bingo-ev.de-Webserver. |
|||
=== Prosody === |
|||
Kommentierte Konfigurationsdatei "/etc/prosody/prosody.cfg.lua" |
|||
Da beim Prosody-Paket von OpenSuse eine Menge benötigter Module fehlen, wurden die Module direkt aus dem Prosody-Mercuriual-Repository nach "/usr/local/lib/prosody-modules/" geklont |
|||
Zum Aktualisieren einfach "/usr/local/sbin/update-prosody-modules.sh" ausführen und Prosody mit "prosodyctl reload" neu laden. |
|||
=== Apache2 === |
|||
vHosts in "/etc/apache2/vhosts.d/" angelegt, sonst keine Änderungen. |
|||
* 01-set-servername.conf: Hostname auf xmpp.bytewerk.org setzen |
|||
* conference.bytewerk.org.conf: Nur Platzhalter für Certbot |
|||
* proxy.bytewerk.org.conf: Nur Platzhalter Certbot |
|||
* pubsub.bytewerk.org.conf: Nur Platzhalter Certbot |
|||
* upload.bytewerk.org.conf: Fileupload per mod_http_upload_external + share_v2.php |
|||
* xmpp.bytewerk.org.conf: Reverse-Proxy für BOSH, Websocket und für die von mod_http_altconnect erstellte .well-known-URIs |
|||
Alle vHosts außer upload.bytewerk.org leiten auf https://jabber.bytwerk.org um. |
|||
Für bingo-ev.de gibt es entsprechende vHosts. |
|||
=== Coturn === |
|||
Kommentierte Konfigurationsdatei "/etc/coturn/turnserver.conf" |
|||
==Verwandte Artikel== |
|||
==Files== |
==Files== |
||
Das Ansible-Playbook samt Inventory befinden sich hier: https://git.bingo-ev.de/infrastructure/xmpp |
|||
TBD |
|||
[[Category:Projekt]] |
[[Category:Projekt]] |
Aktuelle Version vom 31. Januar 2024, 20:41 Uhr
Ziel
Konkurrenzfähiger, zuverlässiger, selbst betriebener, erweiterbarer Instant Messenger mit allen derzeitig üblichen Funktionen.
Verantwortlich
Benutzerzugänge
Jedes Bingo-Mitglied hat automatisch einen Account.
Die JID ist identisch zur Bingo-E-Mail-Adresse, das Passwort ist das Bingo-E-Mail-Passwort.
E-Mail-Aliase der Domains @bingo-ev.de und @bytewerk.org können ebenfalls als JIDs verwendet werden.
Informationen für Anwender finden sich hier: https://xmpp.bytewerk.org/
Chaträume
Grunsätzlich
Jeder kann nach Belieben Chaträume anlegen.
Automatisch angelegte Chaträume
Folgende Chaträume werden automatisch angelegt:
Badges
Badges für Chaträume können über https://conference.<DOMAIN>/muc_badge/<MUC-JID> abgerufen werden.
Beispiele:
- Das Badge für bytewerk@conference.bytewerk.org kann über die URL https://conference.bytewerk.org/muc_badge/bytewerk@conference.bytewerk.org abgerufen werden und sieht so aus:
- Das Badge für bingo-users@conference.bingo-ev.de kann über die URL https://conference.bingo-ev.de/muc_badge/bingo-users@conference.bingo-ev.de abgerufen werden und sieht so aus:
IRC-Chat
Zum Betreten von IRC-Chats einfach einen neuen Chat mit dem Muster #CHANNEL%SERVER@biboumi.bytewerk.org anlegen.
Beispiel:
Um den Channel #pypy auf irc.libera.chat zu besuchen, einen neuen Chat mit der Adresse #pypy%irc.libera.chat@biboumi.bytewerk.org starten.
Im XMPP-Client werden dann automatisch der Channel und der IRC-Server als Gesprächspartner hinzugefügt. Sollten die Nachrichten des IRC-Servers stören: Diesen einfach als Gesprächspartner blockieren.
XMPP-Clients
Es kann jeder XMPP-Client verwendet werden. Empfehlenswerte Clients für Android, iOS, Linux, Windows und MacOS sind auf https://xmpp.bytewerk.org/ aufgeführt.
Webclients
Auf xmpp.bytewerk.org ist Converse.js installiert:
Grundsätzlich kann sich jeder XMPP-Nutzer an jedem XMPP-Webclient anmelden. Je nach URL werden nur ein paar Voreinstellungen passend zur Domain gesetzt um die Benutzung von Converse.js zu erleichtern.
Sonstige
In Thunderbird ist ein sehr einfacher Client (nur Text) integriert ("Konten" -> "Chat-Konto" hinzufügen).
Für Nextcloud gibt es mit der ojsxc-App einen sehr gut ausgestatteten webbasierten Client.
Unterstützte Funktionen
Übersicht
- Gruppen (öffentlich/privat/mit Einladung, moderiert/unmoderiert)
- Audio- und Videotelefonie
- Sprach- und Videonachrichten
- Ende-zu-Ende-Verschlüsselung
- Dateiup- und Download (wird auch für Fotos, Sprach- und Videonachrichten verwendet) - Dateigröße pro Upload derzeit limitiert auf 100 MByte.
- Gleichzeitiges Verwenden mehrerer Clients
- Push
- IRC
100% Compliance zu Conversations
Dateien und Chatverläufe werden nach einem Monat vom Server gelöscht.
Die Kosten der Freiheit
Die oben genannten Funktionen stehen nicht immer zur Verfügung, weil sich die bei der Kommunikation mit einem bestimmten Gesprächspartner zur Verfügung stehenden Funktionen aus der Schnittmenge des Funktionsumfangs der beteiligten XMPP-Server und der XMPP-Clients ergeben :)
Beispiel: Ist mein Gesprächspartner ein Shellskript, das mir eine Nachricht schickt wenn die Waschmaschine fertig ist, dann werde ich mit diesem kein Videotelefonat führen können, selbst wenn es mein XMPP-Client und der Server unterstützt.
Wichtig bei der gleichzeitigen Verwendung von mehreren Clients: Eine Nachricht gilt als zugestellt, wenn sie an EINEM Client des Empfängers angekommen ist. Das kann bei wackeliger Internetverbindung dazu führen, dass Nachrichten scheinbar nicht zugestellt wurden - sie landen dann nur bei dem Gerät, dass gerade online ist. Zwar prüfen die meisten XMPP-Clients beim Wieder-Online-Gehen, ob in der Zwischenzeit Nachrichten eingetroffen sind, aber eben nicht alle. Ebenso ist undefiniert, was passiert, wenn ein Videoanruf gestartet werden soll, der Gesprächspartner aber mit mehreren Clients online ist, von denen nicht alle Videotelefonie unterstützen. Threema, Whatsapp usw. machen es sich einfach: Die verbieten schlicht die parallele Nutzung sowie Fremd-Clients.
Fortschritt
- 2021-01
- Neukonfiguration des bestehenden XMPP-Servers mit Korrektur der DNS-Einträge und Installation zusätzlicher benötigter Dienste
- 2021-02
- Implementierung abgeschlossen: Statt 52% jetzt 100% "XMPP Specifications compliance" beim Conversations.im-Compliance-Test, A-Scores beim IM Observatory Client- und Server-Test
- 2021-02
- Bingo-Domäne mit IMAP-Authentifizierung hinzugefügt, Conversejs aktualisiert
- 2021-08
- Serverkonfiguration auf Ansible umgestellt, dabei kleine Fehler behoben, neue Funktionen hinzugefügt, Conversejs aktualisiert.
- 2022-08
- Push-Services für Monal IM aktiviert
- 2022-09
- IRC-Transport
Files
Das Ansible-Playbook samt Inventory befinden sich hier: https://git.bingo-ev.de/infrastructure/xmpp