MediaWiki:Matrix

Aus Mitmachen
Zur Navigation springen Zur Suche springen

Was ist Matrix?

Matrix ist ein offenes, leichtgewichtiges Protokoll für dezentrale Echtzeitkommunikation.

Nach einer Evaluierungsphase ist GermanZero von Slack auf Matrix als unsere bevorzugte offene Diskussionsplattform gewechselt. Matrix stellt eine Verbesserung der Zugänglichkeit und Sicherheit für die GermanZero-Gemeinschaft dar und wir freuen uns über diesen Wechsel. Darüber hinaus laufen die GermanZero Matrix-Server mit 100% eneuerbarer Energiversorgung auf virtuellen, privaten Server in unserem Partner-Rechenzentrum datacenterlight.

Mitmachen bei GermanZero

Das Herz von GermanZero sind die Menschen. Wir stellen die Menschen an erste Stelle und tun unser Bestes, um die Vielfalt unserer Mitwirkenden zu erkennen, zu schätzen und zu respektieren. GermanZero begrüßt die Teilnahme aller, die unsere Mission teilen und dazu in gesunder sowie konstruktiver Weise innerhalb unserer Gemeinschaften beitragen wollen. Zu diesem Zweck erwarten wir, wie bei allen GermanZero-Räumen und -Veranstaltungen, dass die Teilnehmer*innen an unseren Matrix-Foren/Räumen die Richtlinien zur Teilnahme an der GermanZero-Gemeinschaft als Bedingung für die Teilnahme unterstützen und einhalten.

Bitte beachte, dass die große Mehrheit der Räume auf unserer Matrix-Instanz, nicht-öffentlich zugängliche Räume sind, die nicht anonym gelesen werden können. Die Teilnahme an Räumen wie GZ_000_allgemein wird für alle Raum-Teilnehmenden sichtbar sein. Weitere Informationen zu unseren Datenschutzrichtlinien findest Du in den Datenschutzhinweisen für Webseiten, Kommunikation und Cookies von GermanZero.

Matrix für euer Lokalteam

Als lokales Politik-Gesprächs- oder Klimaentscheid-Team könnt ihr Matrix auch für eure teaminterne Kommunikation verwenden und auf dem GermanZero Matrixserver Räume wie zum Beispiel einen Raum Klimaentscheid_Stadt für die bei eurem Klimaentscheid aktiven Menschen anlegen. Aus Datenschutzgründen ist es dafür notwendig, dass alle Nutzer*innen eurer Matrixräume die GermanZero Datenschutz- und Vertraulichkeitserklärung unterzeichnen und dass die Nutzungsregeln (siehe Abschnitt weiter unten) eingehalten werden.

Erste Schritte

Neu bei Matrix, neu bei GermanZero?

Ihr wollt euch aktiv bei für die Lokalteams bei GermanZero engagieren und euch mir anderen Aktiven austauschen? So bekommt ihr eure Matrix-Zugang:

  1. Schickt die unterschriebene Datenschutzvereinbarung an [nda@germanzero.de]
  2. HIER könnt ihr in unseren Matrixraum "Foyer" eintreten und "Elements" für euer Telefon oder euren Computer runterladen. (Dann müsst ihr Matrix nicht über euren Browser benutzen.)
  3. Meldet euch im Foyer zu Wort, z.B. mit: „Hallo, ich bin VORNAME und ich interessiere mich für BEREICH (Klimaentscheide | Politik-Gespräche | Design | …). Ich habe den Datenschutz-Zettel unterschrieben und an nda@germanzero.de geschickt. Könnt ihr mich in die richtigen Räume einladen?“
  4. Ihr werdet von der Bereichs-Zuständigen begrüßt und in die Räume eingeladen.
  5. Ihr werdet aus Foyer entfernt.


Was ist eine Matrix User ID?

Matrix-Benutzer-IDs (MXID) sind eindeutige Benutzer-IDs. Sie haben das Format @username:homeserver.tld (dieses Format wird verwendet, um sie nicht mit E-Mail-Adressen zu verwechseln).

In unserem wurde das Format @vorname.nachname:germanzero.org gewählt.

👉 TLD bedeutet übrigend Top Level Domain 🤓

Zugangsdaten erhalten?

Installiere dir bitte wie in der Mail mit deinen Zugangsdaten beschrieben Element-Desktop, um Matrix zu nutzen. Das vereinfacht vieles. Vor allem brauchst du dich in Element-Desktop nur einmal mit Benutzername(=deine Matrix-ID), Passwort und Sicherheitsschlüssel anzumelden. Anschliessend kannst du Elemen-Desktop ohne Abmeldung schliessen und ohne Anmeldung wieder öffnen.
  • Einen Step-By-Step Guide zur Anmeldung findest du hier: Matrix Guide
  • Sobald Du angemeldet bist, findest du die Räume, in die du eingeladen worden bist.
  • Neben spezifischen Räumen, die nach Art deiner Mitarbeit variieren können, sind dies vor allem die allgemeinen Klimaentscheid-Räume (siehe Abschnitt "Übersicht Matrixräume")

Matrix-Konto schon vorhanden?

  • Solltest du bereits über ein Matrix-Konto verfügen, kannst du uns über das Klimaentscheide-Büroteam ([[1]]) deine Matrix-ID zukommen lassen und wir laden dich in die für dich interessanten und relevanten Räume ein.
  • Erforderlich auch hier: Unterzeichnete Verschwiegenheitserklärung sowie Vor- und Nachname.

Du kannst unseren Räumen, wenn du eine Einladung in einen Raum erhalten hast, mit Matrix über die Element-Web-App, die native Element-Mobil-App für Ihre Plattform oder jeden anderen Matrix-Client beitreten. Die GermanZero IT stellt nur Support für die Element Clients zur Verfügung.

⚠️ Aktuell ist es nicht erlaubt, öffentliche Räume zu erstellen und dadurch mit anderen Matrix Homeservern zu teilen!

Nutzungsregeln

  • Der User "@root:germanzero.org" ist verpflichtend in jeden Room einzuladen, der einem Bereichszweck dient.
  • Nur so kann a) Support erfolgen und können b) weitere User*innen als bulk update hinzugefügt werden.
  • Räume mit mehr als 5 Personen erhalten verpflichtend einen Raumnamen.
  • Es ist selbstverständlich, dass diese 5 Personen-Grenze nicht dazu missbraucht wird, um Räumen keinen Namen geben zu müssen.
  • Es ist selbstverständlich, dass ohne Zustimmung der IT (Thomas Hutmacher) und Ehrenamts-Team von GermanZero keine weitere User*innen in Räume auf GZ-Matrixservern eingeladen werden.
  • Nutzer*innen müssen die GermanZero Datenschutz- und Vertraulichkeitsvereinbarung unterzeichnen.
  • Nicht abgestimmte Nutzer*innen werden gelöscht.
  • Weitere Nutzer*innen können in einem noch zu definierenden Prozess der IT zwecks Registrierung angemeldet werden. Dazu wird benötigt:
    • Vor- und Nachname
    • Mailadresse
  • Die Registrierung erfolgt so zeitnah wie möglich, ein Anspruch auf sofortige Zulassung besteht nicht - ggf. werden Benutzer*innen einmal/Woche registriert (noch zu definieren).
  • Alle Räume unterhalb des jeweiligen Bereichssegments sind mit der jeweiligen Bezeichnung zu versehen - Beispiel: GZ_500_neuer Raumname
  • Unverschlüsselte Räume können erstellt werden, sind aber mit der IT (Thomas Hutmacher) abzustimmen.
  • Trotz unserer besten Bemühungen kommt es gelegentlich zu Verhaltensweisen auf Matrix, die nicht mit unseren Richtlinien zur Teilnahme an der Community übereinstimmen. Wenn dir das passiert, wende dich bitte an die Raum-Administrator*innen/-moderator*innen.

Ändern von Konten

Du kannst zwar deinen "Anzeigenamen" in Matrix ändern, aber aufgrund von Low-Level-Design-Entscheidungen im Matrix-Protokoll können Konten weder umbenannt, noch können Kontonamen (=Matrix-ID) wiederverwendet werden und ihre Deaktivierung (falls erforderlich) ist dauerhaft. Für die meisten Matrix-Benutzer*innen stellt dies kein Problem dar.

Verbindung zur Matrix

Neue Nutzer*innen zulassen

Die Benutzer*innenregistrierung erfolgt durch die GermanZero IT unter Einbindung des Klimaentscheid-Büroteams.

  • Neue Ehrenamtsanfrage liegt vor
  • Klimaentscheid-Büroteam nimmt Kontakt mit der betreffenden Person auf
  • Interessierte Person unterzeichnet Vertraulichkeitserklärung (hat sie vorher durch Klimaentscheid-Büroteam erhalten)
  • Team Ehrenamt trägt neue Registrierungsanfrage in Liste ein (Erforderlich: Vor- und Nachname, gültige Mailadresse)
  • Registrierung der neuen Nutzer*innen in Matrix durch GermanZero IT (2x pro Woche, in der Regel Dienstags und Freitags; zu einem späteren Zeitpunkt wird auf 1x wöchentlich umgestellt)
  • Neue Benutzer*in erhält Zugangsdaten durch GermanZero IT
  • Einladung in die Klimaentscheid-Räume durch GermanZero IT
  • ggf. Einladung in weitere Räume durch die jeweiligen Raumadministrator*innen

Clients

Matrix unterstützt eine Vielzahl von Clients auf Web, Desktop und Mobilgeräten. Die Verbindung zum Web-Client kannst du problemlos über https://matrix.germanzero.de herstellen.

Zu den Clients, die derzeit von der GermanZero IT unterstützt werden, gehören:

Verbindungsparameter

Falls du von einem Client dazu aufgefordert wirst, deinen Homeserver anzugeben - here you go::

  • Homeserver GermanZero: https://matrix.germanzero.org

Solltest du dich nicht über einen Client wie etwa Element verbinden und dazu lieber einen Browser verwenden wollen, dann bist di hier richtig:

Diese Angaben werden in den meisten Clients automatisch für dich ausgefüllt, wenn du deinen vollständigen Benutzernamen (z.B. @martina.musterfrau:germanzero.org statt martina) in das Feld Benutzername eingibst.

Generell empfehlen wir dir, immer die Element Clients zu nutzen!

Einem Raum beitreten

Wenn Du mit dem GermanZero Matrix-Server verbunden bist, kannst du GermanZero-Räumen und auch Räumen auf anderen Matrix-Servern beitreten. Eine Mehrfachregistrierung wie z.B. bei Slack entfällt aufgrund des Föderationsprinzips von Matrix.

Es gibt mehrere verschiedene Möglichkeiten, einem Raum beizutreten:

  • Du kannst einem externen Link folgen
  • Du kannst Links innerhalb einer Diskussion auf Matrix folgen.
  • Du kannst eine Einladung von einem anderen Matrix-Mitglied erhalten.

Bitte beachten:

  • Momentan können GermanZero-Räume nur auf Einladung betreten werden.
  • Ob und wie sich dies ändert, wird zu einem späteren Zeitpunkt entschieden werden.

Einen Raum verlassen

Gehe dazu mit dem Cursor auf den Raumnamen, klicke die dann erscheinenden drei Punkt an und wähle aus dem aufklappenden Optionsmenü "Verlasse Raum" aus.

Raum Teilnehmer*innen

Sobald du einem Raum beigetreten bist, kannst du dir die Raumteilnehmer*innen anzeigen lassen, indem du auf das Personensymbol oben rechts klickst.

Anlegen eines neuen Raums

Wie du einen neuen Raum erstellen, hängt von deinem Client ab (Element-Hilfe).

Bei der Erstellung von Räumen kannst du entscheiden:

  • ob der neue Raum öffentlich auffindbar sein
  • oder eine Ende-zu-Ende-Verschlüsselung ("E2E") verwenden soll;
  • für öffentliche Räume, die für die Beteiligung der Gemeinschaft gedacht sind, empfehlen wir, E2E *nicht* zu aktivieren, da dies neuen Teilnehmern die Möglichkeit gibt, Scrollback zu sehen.
  • Ein öffentlicher Raum ist ein Raum, dem jeder ohne Einladung beitreten kann. D.h. die Option "nur Leute, die eingeladen wurden" ist nicht aktiviert.

Jeder Raum auf dem Server sollte auch das root-Konto (@root:germanzero.org) einladen und ihm die Admin-Rolle zuweisen. Dies hilft dir, den Raum zu verwalten und ermöglicht es den GermanZero IT dich bei diesem Prozess zu unterstützen.

👉Nutzungsregeln

Die Bereitstellung des Zugriffs auf das root-Konto ist ein zweistufiger Prozess:

  • Erteile die Einladung: @root:germanzero.org
  • Nachdem @root:germanzero.org dem Raum beigetreten ist, gewähre diesem Konto die Admin-Rolle.

Verschlüsselung

Erste Hilfe

Wenn du Nachrichten nicht lesen kannst, da es Probleme bei der Entschlüsselung gibt, ist den allermeisten Fällen einer der folgenden Punkte die Ursache:

  • Du greifst über den Browser auf Matrix zu. Nutze stattdessen bitte den Client Element-Desktop
  • Du loggst dich vor dem Schließen von Element-Desktop aus deinem Matrixaccount aus. Bitte NICHT ausloggen! Einfaches Schließen von Element-Desktop reicht aus.
  • Es handelt sich um Nachrichten in einem verschlüsselten Raum, die versendet wurden, bevor du Mitglied in diesem Raum warst. Dass du diese Nachrichten nicht lesen kannst ist normal und durch die Verschlüsselung bedingt.

Warum kann ich eine Nachricht nicht lesen?

Wenn du eine Nachricht nicht lesen kannst, liegt das daran, dass dein Gerät nicht über den richtigen Schlüssel verfügt.

Wenn dein Gerät nicht über den richtigen Schlüssel verfügt, gibt es drei Möglichkeiten, wie du an den richtigen Schlüssel gelangen kannst:

  • Stelle alle deine Schlüssel aus der Schlüsselsicherung wieder her
  • Anfordern des spezifischen Schlüssels von einem anderen Gerät über Schlüsselfreigabe
  • Hochladen von Schlüsseln aus einer manuellen Sicherung (fortgeschritten)

Was ist ein Key Backup?

Wenn die Schlüsselsicherung aktiviert ist, wird dein Gerät eine sichere Kopie seiner Schlüssel auf unserem Server aufbewahren. Um sicherzustellen, dass auf diese Schlüssel immer nur du Zugriff hast, werden sie auf deinem Gerät verschlüsselt, und zwar mit einem Schlüssel, den du entweder selbst speichern oder mit einer Passphrase sichern und auf unseren Server hochgeladen. Es ist wichtig zu verstehen, dass zum Schutz Ihrer Privatsphäre deine Schlüssel niemals unverschlüsselt unsere Systeme berühren.

Ist es sicher, meine Verschlüsselungsschlüssel auf Ihren Servern zu sichern?

Ja, deine Schlüssel werden verschlüsselt, bevor sie auf unsere Server hochgeladen werden, so dass wir sie niemals unverschlüsselt sehen.

Wie kann ich aus einer Schlüsselsicherung wiederherstellen?

Gehe zu Benutzereinstellungen -> Sicherheit & Datenschutz und klicke auf Restore from Backup (siehe auch Videobeispiel: Schlüssel wiederherstellen)

Wie kann ich den Schlüssel von einem anderen Gerät über die Schlüsselfreigabe anfordern?

Wenn Element eine Nachricht sieht, die es nicht entschlüsseln kann, fragt es automatisch Ihre anderen Geräte, ob sie eine Kopie des erforderlichen Schlüssels haben. Schlüssel werden automatisch für vertrauenswürdige Geräte freigegeben - wenn das Gerät mit dem Schlüssel dem Gerät, das den Schlüssel anfordert, nicht vertraut hat, wird das Gerät mit dem Schlüssel eine Eingabeaufforderung anzeigen, in der du aufgefordert wirst, die Schlüsselfreigabe manuell zu bestätigen.

Was ist ein 'Gerät'?

Aus historischen Gründen meint ein "Gerät" nicht dein Telefon oder deinen Laptop - in Wirklichkeit erstellst du jedes Mal, wenn du dich bei Matrix anmeldest, ein neues "Gerät" (und zerstörst es wieder, wenn du dich abmeldest).

HowTo

Übersicht Matrixräume

Allgemeine Klimaentscheid-Räume

Bei deiner Einladung zu Matrix erhältst automatisch du eine Einladung in alle folgenden Räume:

  • GZ_200_KE_Allgemein - Infos, die für die meisten Leute interessant sind und für die es keinen anderen passenden Raum gibt
  • GZ_200_KE_wer_wir_sind - Vorstellungsrunde
  • GZ_200_KE_Termine - Schwarzes Brett für Terminhinweise
  • GZ_200_KE_Fragen - Raum für allgemeine Fragen


Spezielle Klimaentscheid-Räume

In die nachfolgenden Räume wirst du nur auf Anfrage eingeladen. Wenn du zu einem bestimmten Raum eingeladen werden willst, schreibe bitte eine kurze Mail an klimaentscheid@germanzero.de:

  • GZ_200_KE_Medienspiegel - Links zu Medienberichten über die Klimaentscheide
  • GZ_200_KE_Dokumente - hier können Dokumente mit anderen Klimaentscheid-Gruppen geteilt werden
  • GZ_200_KE_Fragen_Recht - Raum für rechtliche Fragen im Kontext der Klimaentscheide
  • GZ_200_KE_Fundraising - für Fragen, Tipps & Trick zum Fundraising im Kontext der Klimaentscheide
  • GZ_200_KE_Umsetzung_Klimaneutralität - Wie können wir helfen, dass kommunale politische Beschlüsse zur Klimaneutralität anschließend auch wirklich umgesetzt werden?
  • GZ_200_KE_Filmprojekt - mehrere lokale KE-Teams arbeiten hier gemeinsam an einem Klimaentscheid-Video
  • GZ_200_Teamansprechpersonen - hier sollten zwei Personen aus eurem lokalen Klimaentscheid-Team vertreten sein

Weitere GermanZero-Räume:

In die nachfolgenden Räume wirst du nur auf Anfrage eingeladen. Wenn du zu einem bestimmten Raum eingeladen werden willst, schreibe bitte eine kurze Mail an klimaentscheid@germanzero.de:

#GZ_000_allgemein:germanzero.org - Allgemeine Diskussionen

#GZ_000_fragen:germanzero.org - Hier können Fragen zu IT, Webseite, Ehrenamt und vieles mehr geklärt werden

#GZ_000_wer_wir_sind:germanzero.org - Vorstellungsrunde :)

#GZ_000_kaffeekueche:germanzero.org - Small Talk, Raum für allerlei Blödsinn ;)

#GZ_000_termine:germanzero.org - Termin-Sammelstelle

#GZ_000_medienspiegel_zu_germanzero:germanzero.org - Was wird über uns in den Medien berichtet?

#GZ_000_links_to_read:germanzero.org - Interessante Links, die es zu lesen lohnen könnte

#GZ_000_links_to_watch:germanzero.org - Videos etc.

#GZ_000_links_to_share_and_like:germanzero.org - Liken & Teilen, wie der Name sagt

#GZ_000_bundestag_aktuell - Neues aus dem Bundestag bezüglich Klima, Energie, etc.

#GZ_000_Memo-News:germanzero.org - Hier gibt es ein wöchentliches, kompaktes Newsupdate zu GermanZero Aktivitäten etc.

Weitere Informationen

Weitere Informationen findest du in dem Dokument Matrix-Dokumentation. Bitte lass dich nicht von der hohen Seitenzahl des Dokuments abschrecken, die ist hauptsächlich durch die ausführliche Bebilderung mit Screenshots bedingt.

Tipps & Tricks

Es gibt in paar Kniffe, die die Nutzung von Matrix erheblich vereinfachen können.

  1. Bildschirmfoto 2021-03-11 um 13.02.11.png
    Räume favorisieren: Favorisierte Räume werden in der Raumliste unter einer Rubrik Favoriten gesammelt angezeigt. Dazu über die drei Punkte neben dem jeweiligen Raumnamen die Raumoptionen aufrufen und "Favorit" auswählen:
  2. Raumsortierung anpassen: Über die drei Punkte neben "Favoriten" und "Räume" lässt sich einstellen, dass die Räume nach Aktivität sortiert werden und Räume mit ungelesenen Nachrichten zuerst angezeigt werden:
    Bildschirmfoto 2021-03-11 um 12.57.57.png