Software:Techsupport: Unterschied zwischen den Versionen

Aus KIF
(Auf Matrix-Registrierungs-QR-Codes hinweisen)
 
(12 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<div style="float:right;margin-left:40px;">__TOC__</div>
<div style="float:right;margin-left:40px;">__TOC__</div>
<div style="border:1px solid #a4ffa9; background-color:#a4ffa9; margin-left:2em; width:7em; text-align:center;"><strong>Support</strong></div>
<div style="border:1px solid #a4ffa9; background-color:#f3fff3; margin-left:2em; margin-right: 2em; padding-left:1ex;">
Bei Fragen oder Problemen wendet euch gerne an den Matrix-Raum "KIF IT Support", erreichbar unter [https://matrix.to/#/#support:kif.rocks?via=kif.rocks&via=fachschaften.org&via=matrix.cccgoe.de #support:kif.rocks] (oder per Mail an [mailto:admin@kif.rocks admin@kif.rocks])
</div>


== Matrix (Chat) ==
== Matrix (Chat) ==
<div style="border:1px solid #ffa4a4; background-color:#ffa4a4; margin-left:2em; width:7em; text-align:center;"><strong>Achtung</strong></div>
<div style="border:1px solid #ffa4a4; background-color:#fff3f3; margin-left:2em; margin-right: 2em; padding-left:1ex;">
Aufgrund von Spam mussten wir die Registrierung auf kif.rocks schließen. In den Räumen des KIF-Cafe findet ihr QR-Codes mit einem Registrierungslink. Alternativ meldet euch bei [mailto:admin@kif.rocks admin@kif.rocks], wenn ihr einen Account haben wollt.
</div>
Matrix ist ein freies und offenes, sicheres, dezentralisiertes Protokoll für Echtzeit-Kommunikation, das auch unter dem Namen eines seiner nutzenden Programme, Element, bekannt ist.
Zur Nutzung benötigt ihr einen Account auf einem Matrix-Server (dem ''Homeserver'') und einen Client.
=== Homeserver ===
Der Homeserver speichert eure (ggf. verschlüsselten) Nachrichten und gibt euch eine ''Matrix-ID'' der Form <code>@login:server.tld</code>.


Die KIF IT bietet [https://matrix.kif.rocks matrix.kif.rocks] an, wo jede/r frei einen Account registrieren kann. Der Account ist dann der Form <code>@login:kif.rocks</code>.
Die KIF IT bietet [https://matrix.kif.rocks matrix.kif.rocks] an, wo jede/r frei einen Account registrieren kann. Die Matrix-ID hat dann die Form <code>@login:kif.rocks</code>.


Der KIF nah und für allgemeine Hochschulbelange bietet fachschaften.org auch [https://matrix.fachschaften.org matrix.fachschaften.org] an. Accounts dort sind frei für Hochschulangehörige und geben Zugang auf ein paar mehr Dienste (gitlab, nextcloud, …), mehr Infos unter [https://fachschaften.org fachschaften.org]. Der Account ist dann der Form <code>@login:fachschaften.org</code>.
Die FS Info der TU Dortmund bietet unter [https://fachschaften.org fachschaften.org] auch einen Homeserver an.
Accounts dort sind frei für Hochschulangehörige [https://account.fachschaften.org erstellbar] und geben auch Zugang auf ein paar mehr Dienste (u.a. GitLab & Nextcloud). Die Matrix-ID hat dann die Form <code>@login:fachschaften.org</code>.


=== Clients ===
=== Clients ===


Eine Übersicht der Clients gibt es auf [https://matrix.org/clients/ matrix.org/clients], wobei der Platzhirsch [https://about.riot.im Riot] ist, den gibt es auch in mobilen-, Desktop- und Browser-Varianten. Android Nutzern empfehlen wir statt Riot allerdings RiotX zu nutzen, RiotX ist quasi die nächste Version von Riot für Android, ist aber noch etwas zu nah an der blutigen Kante als dass es Riot komplett ersetzen könnte; Wir sind aber zuversichtlich, dass ihr damit klarkommt 😉
Für die kurzfristige Nutzung empfehlen wir Element im Browser, erreichbar für die o.g. Homeserver unter [https://element.kif.rocks element.kif.rocks] bzw. [https://element.fachschaften.org element.fachschaften.org].


Beim Einrichten eines anderen Clients als die Webclients unter matrix.kif.rocks bzw. matrix.fachschaften.org müsst ihr aufpassen, dass ihr einen eigenen Homeserver angeben müsst, und zwar <code>matrix.kif.rocks</code> bzw. <code>matrix.fachschaften.org</code>.
Wer Matrix dauerhaft nutzen möchte, sollte die entsprechenden nativen Anwendungen installieren, das ermöglicht z.B. auch die Suche in verschlüsselten Chats: <br>
 
Element Desktop ist für [https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe Windows], [https://packages.riot.im/desktop/install/macos/Element.dmg macOS] und [https://doc.matrix.tu-dresden.de/clients/install_linux/ Debian, Ubuntu, Fedora, Arch Linux & NixOS] verfügbar, die Element App gibt es für [https://play.google.com/store/apps/details?id=im.vector.app Android (Google Play)], [https://f-droid.org/packages/im.vector.app/ Android (F-Droid)] und [https://apps.apple.com/app/vector/id1083446067 iOS].
=== Accounts ===
'''Wichtig:''' Beim Einrichten der nativen Anwendungen darauf achten, als Homeserver <code>matrix.kif.rocks</code> bzw. <code>matrix.fachschaften.org</code> anzugeben!


==== Neuen Account anlegen ====
Unter [https://matrix.org/clients/ matrix.org/clients] finden sich auch weitere Clients, wobei diese nicht unbedingt alle Features vollständig implementieren.<br>
''Wir empfehlen die Nutzung von anderen Clients nur experimentierfreudigen Nutzer*innen, die bereits Erfahrung mit dem Protokoll haben!''


Einen Account kann man sich wie oben beschrieben für kif.rocks unter [https://matrix.kif.rocks matrix.kif.rocks] anlegen, für fachschaften.org muss man dann den Umweg über [https://fachschaften.org fachschaften.org] und den Account-Dienst gehen. In beiden Fällen möchten wir euch bitten eine E-Mailadresse bzw. eine korrekte E-Mailadresse anzugeben, die ist für Passwort-Resets usw. wichtig!
=== tl;dr ===
Du hast noch keinen Matrix-Account und willst einfach nur den Chat nutzen? Hier die Blitzanleitung:


Nachdem man sich in einem Client angemeldet hat wird man auch gebeten ein "Recovery-Passwort" einzugeben. Der Name ist leider nicht akkurat und nicht mehr komplett. Es handelt sich um ein Passwort für ein Secure Storage, das Encryption Keys usw. beinhaltet, mit diesem Passwort verschlüsselt auf dem Server gespeichert und zwischen den Clients geteilt wird. Theoretisch teilen sich die eigenen Clients auch über das "Emoji-Ketten-Vergleichen"-Cross-Signing dann das Key zu diesem Secure Storage, weil aber alle Clients noch nicht ganz auf dem gleichen Stand usw. klappt das manchmal und manchmal klappt das nicht 😅 Mehr Infos zu diesem Storage gibt's unter [https://github.com/matrix-org/matrix-doc/blob/master/proposals/1946-secure_server-side_storage.md Secure Secret Storage and Sharing] (sehr technisch).
# Account anlegen unter [https://element.kif.rocks element.kif.rocks]
#:'''Bitte eine gültige Mailadresse eingeben!'''
# Matrix-ID im Pretix eintragen
#* Sie hat die Form <code>@login:kif.rocks</code>
#* Du hast schon ein Ticket geklickt? Nutze den <code>Du kannst deine Bestellung unter folgender Adresse ändern und einsehen</code> Link aus der Bestätigungsmail um die Matrix-ID nachzutragen
# Die Matrix-IDs im Pretix werden regelmäßig in den Chatraum eingeladen. Im Zweifel bei der Orga nachfragen.
# Bei Fragen gerne im Raum "KIF IT Support" melden, erreichbar über die Raumliste von kif.rocks (In Element: Button "Räume erkunden" neben dem Suchfeld)


==== Bestehenden Account einrichten ====
Du hast schon einen Matrix-Account? Nutze die obige Anleitung, aber überspringe Schritt 1.


Bitte gebt eure Matrix-ID der Form <code>@login:example.com</code> im Pretix bei eurem Online-Ticket an, damit ihr zu den KIF Räumen hinzugefügt werden könnt. Um euer Ticket im Pretix zu bearbeiten und die ID hinzuzufügen könnt ihr entweder in euren Mails suchen nach <code>Du kannst deine Bestellung unter folgender Adresse ändern und einsehen</code>, oder im [https://tix.kif.rocks/480/ Pretix] ganz unten <code>Links erneut senden</code> klicken.
=== Erste Schritte & Verschlüsselung ===
Wir empfehlen die Lektüre des Abschnitts [https://doc.matrix.tu-dresden.de/settings/ Wichtige Einstellungen] der Matrix-Dokumentation der TU Dresden.<br>
Dort werden die Ende-zu-Ende-Verschlüsselung (E2EE) erläutert und wichtige Einstellungen zusammengefasst, die man nach dem ersten Anmelden prüfen sollte.


== BBB (Audio/Video/Präsentationen) ==
== BBB (Audio/Video/Präsentationen) ==
Zeile 47: Zeile 74:
In einfach: Kein Whitespace, aber Klammern diverser Art sind erlaubt, außerdem @, _ und |.
In einfach: Kein Whitespace, aber Klammern diverser Art sind erlaubt, außerdem @, _ und |.


== HackMD (Markdown Pads) ==
== HedgeDoc (Markdown Pads) ==
https://md.kif.rocks
https://md.kif.rocks
=== Accounts ===
=== Accounts ===

Aktuelle Version vom 29. Oktober 2021, 16:06 Uhr

Support

Bei Fragen oder Problemen wendet euch gerne an den Matrix-Raum "KIF IT Support", erreichbar unter #support:kif.rocks (oder per Mail an admin@kif.rocks)

Matrix (Chat)[Bearbeiten]

Achtung

Aufgrund von Spam mussten wir die Registrierung auf kif.rocks schließen. In den Räumen des KIF-Cafe findet ihr QR-Codes mit einem Registrierungslink. Alternativ meldet euch bei admin@kif.rocks, wenn ihr einen Account haben wollt.

Matrix ist ein freies und offenes, sicheres, dezentralisiertes Protokoll für Echtzeit-Kommunikation, das auch unter dem Namen eines seiner nutzenden Programme, Element, bekannt ist.

Zur Nutzung benötigt ihr einen Account auf einem Matrix-Server (dem Homeserver) und einen Client.

Homeserver[Bearbeiten]

Der Homeserver speichert eure (ggf. verschlüsselten) Nachrichten und gibt euch eine Matrix-ID der Form @login:server.tld.

Die KIF IT bietet matrix.kif.rocks an, wo jede/r frei einen Account registrieren kann. Die Matrix-ID hat dann die Form @login:kif.rocks.

Die FS Info der TU Dortmund bietet unter fachschaften.org auch einen Homeserver an. Accounts dort sind frei für Hochschulangehörige erstellbar und geben auch Zugang auf ein paar mehr Dienste (u.a. GitLab & Nextcloud). Die Matrix-ID hat dann die Form @login:fachschaften.org.

Clients[Bearbeiten]

Für die kurzfristige Nutzung empfehlen wir Element im Browser, erreichbar für die o.g. Homeserver unter element.kif.rocks bzw. element.fachschaften.org.

Wer Matrix dauerhaft nutzen möchte, sollte die entsprechenden nativen Anwendungen installieren, das ermöglicht z.B. auch die Suche in verschlüsselten Chats:
Element Desktop ist für Windows, macOS und Debian, Ubuntu, Fedora, Arch Linux & NixOS verfügbar, die Element App gibt es für Android (Google Play), Android (F-Droid) und iOS. Wichtig: Beim Einrichten der nativen Anwendungen darauf achten, als Homeserver matrix.kif.rocks bzw. matrix.fachschaften.org anzugeben!

Unter matrix.org/clients finden sich auch weitere Clients, wobei diese nicht unbedingt alle Features vollständig implementieren.
Wir empfehlen die Nutzung von anderen Clients nur experimentierfreudigen Nutzer*innen, die bereits Erfahrung mit dem Protokoll haben!

tl;dr[Bearbeiten]

Du hast noch keinen Matrix-Account und willst einfach nur den Chat nutzen? Hier die Blitzanleitung:

  1. Account anlegen unter element.kif.rocks
    Bitte eine gültige Mailadresse eingeben!
  2. Matrix-ID im Pretix eintragen
    • Sie hat die Form @login:kif.rocks
    • Du hast schon ein Ticket geklickt? Nutze den Du kannst deine Bestellung unter folgender Adresse ändern und einsehen Link aus der Bestätigungsmail um die Matrix-ID nachzutragen
  3. Die Matrix-IDs im Pretix werden regelmäßig in den Chatraum eingeladen. Im Zweifel bei der Orga nachfragen.
  4. Bei Fragen gerne im Raum "KIF IT Support" melden, erreichbar über die Raumliste von kif.rocks (In Element: Button "Räume erkunden" neben dem Suchfeld)

Du hast schon einen Matrix-Account? Nutze die obige Anleitung, aber überspringe Schritt 1.

Erste Schritte & Verschlüsselung[Bearbeiten]

Wir empfehlen die Lektüre des Abschnitts Wichtige Einstellungen der Matrix-Dokumentation der TU Dresden.
Dort werden die Ende-zu-Ende-Verschlüsselung (E2EE) erläutert und wichtige Einstellungen zusammengefasst, die man nach dem ersten Anmelden prüfen sollte.

BBB (Audio/Video/Präsentationen)[Bearbeiten]

https://bbb.fachschaften.org

Accounts[Bearbeiten]

Mumble (Audio)[Bearbeiten]

Serveradresse: mumble.fachschaften.org

Clients[Bearbeiten]

Win/Mac/Linux: https://www.mumble.info/downloads/

Achtung: Falls ihr keinen 1.3er Client habt, kommt es häufig zu Kompatibilitätsproblemen. Einen aktuellen Client gibt es unter den genannten URLs und als Snap und Flatpak.

iOS: https://apps.apple.com/dk/app/mumblefy/id858752232

Android: Maintained aber nur bei F-Droid: Mumla oder im Play Store aber unmaintained: Plumble

Hinweis für Android-Clients: Alte Android-Versionen (vermutlich kleiner 4.4) können das TLS von unserem Server nicht. Sorry :(.

Accounts[Bearbeiten]

Einfach einen Username aussuchen und nutzen. ;)

Usernames müssen folgenden Qt-Regex erfüllen: [-=\w\[\]\{\}\(\)\@\|\.]+
In einfach: Kein Whitespace, aber Klammern diverser Art sind erlaubt, außerdem @, _ und |.

HedgeDoc (Markdown Pads)[Bearbeiten]

https://md.kif.rocks

Accounts[Bearbeiten]