Matrix Server und Bridges

28 Januar 2022

Allgemeines über Matrix

(Danke an Manuel!)

Important
Matrix ist ein förderiertes System (vergleichbar mit E-Mail), daher möglichst NICHT bei Matrix.org registrieren! Bei Bedarf stelle ich Accounts auf https://matrix.plocki.org zur Verfügung.

Projekt-Übersicht:

Bridge Status Bot Limitationen

Signal

Up and running

@signalbot:plocki.org

Telegram

Up and Running

@telegrambot:plocki.org

Threema

Nicht geplant

XMPP

Nicht geplant

Whatsapp

Up and running

@whatsappbot:plocki.org

Twitter

Offline

@twitterbot:plocki.org

Steam

Offline

@_steampuppet_bot:plocki.org

Vorbereitung

Zugriff auf Bridge

Kontaktiert mich mit eurer Matrix-ID (@username:domain.com) mit der Bitte um Freischaltung, dann werde ich euren Account aktivieren.

Double-Puppeting / Token generieren

Brücken benötigen idealerweise Zugriff auf:

  1. den Account des entfernten Protokolls (zwingend)
    nach erfolgreichem Login können Nachrichten über Matrix empfangen und gesendet werden

  2. den eigenen Matrix Account (optional, aber empfohlen)
    nach erfolgreichem Login kann Matrix auch Nachrichten anzeigen, welche von dem eigenen, nativen Client gesendet werden. Dies ist auch nötig, um Notizen an sich selbst zu senden (wie es z.B. bei Signal möglich ist)

Dieses Prinzip nennt sich Double-Puppeting.

Um 2) möglich zu machen, benötigt jede Bridge einen eigenen Access-Token, welchen man von seinem Server generieren lassen kann. Leider gibt es derzeit noch keine schönere Möglichkeit, als über folgendes Bash-Script (curl und jq werden benötigt):

myuser=username
mypasswd="strenggeheim"
mydevice="fancybridge"
myserver="matrix.org"

curl -XPOST -d '{
    "identifier": { "type": "m.id.user", "user": "'"$myuser"'" },
    "password": "'"$mypasswd"'",
    "type": "m.login.password",
    "device_id": "'"$mydevice"'"
}' "https://$myserver/_matrix/client/r0/login" | jq -r '.access_token'

Brücken

Signal

40

Anleitung

  1. Signal Bridge einladen in unverschlüsselten Raum: @signalbot:plocki.org

  2. In diesem Chat (Managment-Raum) eingeben: link

  3. Mit Signal App den QR-Code scannen. Ab jetzt kommen alle neuen Signal-Nachrichten in Matrix an.

  4. Idealerweise noch double puppeting einrichten mit: login-matrix <access token> (siehe oben)

Hinweise und Einschränkungen

  • Voice- und Video-Chat werden derzeit nicht unterstützt.

  • eingehende Nachrichten bekommt ihr automatisch

  • ausgehende Nachrichten sind momentan möglich über Kommando im Protal-Raum mit:

pm +49NUMBER

Internationales Format verwenden!

Telegram

40

Anleitung

  1. Telegram Bridge einladen in unverschlüsselten Raum: @telegrambot:plocki.org

  2. Im diesem Chat (Managment-Raum) eingeben: link-qr

  3. Mit Telegram-App den QR-Code scannen. Ab jetzt kommen alle neuen Telegram-Nachrichten in Matrix an.

  4. Idealerweise noch double puppeting einrichten mit: login-matrix <access token> (siehe oben)

Hinweise und Einschränkungen

  • Voice- und Video-Chat werden derzeit nicht unterstützt.

  • eingehende Nachrichten bekommt ihr automtisch

  • ausgehende Nachrichten sind momentan möglich über Kommando im Portal-Raum mit:

pm +49NUMBER

Internationales Format verwenden!

Threema

40

Nicht geplant

Whatsapp

40
Important
Der native Whatsapp-Client muss auf dem Smartphone aktiv bleiben. Andernfalls erfolgt ein logout alle 2-4 Wochen seitens Whatsapp.
Important
WhatsApp ist dafür bekannt, dass es Konten sperrt, die zu verdächtig sind!!!

Anleitung

  1. Whatsapp Bridge einladen in unverschlüsselten Raum: @whatsappbot:plocki.org

  2. Im diesem Chat (Managment-Raum) eingeben: login

  3. Mit Whatsapp-App den QR-Code scannen. Ab jetzt kommen alle neuen Whatsapp-Nachrichten in Matrix an.

  4. Idealerweise noch double puppeting einrichten mit: login-matrix <access token> (siehe oben)

Anhang