Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 26.1
edited by Aysegül Omus
on 2023/08/23 19:14
Change comment: There is no comment for this version
To version 40.1
edited by Stefan Schwalb
on 2023/08/28 20:39
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kahraman
1 +XWiki.schwalb
Content
... ... @@ -1,117 +1,99 @@
1 1  {{toc/}}
2 2  
3 3  
4 -= Establishing a Matrix Chat =
4 += What is Matrix? =
5 5  
6 6  
7 +[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]]
7 7  
8 -== What is matrix? ==
9 9  
10 +[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
10 10  
11 -Matrix is a chat system very similar to E-Mail. People have their account on one server but can write messages to anyone on other servers. For example @someprofessor:tum.de can communicate with @someresearcher:lmu.de.
12 +* You need to register an account at a provider (e.g. tum.de, or lmu.de)
13 +* Whatever your provider is, you can talk to people using other providers
14 +** (((
15 +For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}!
16 +)))
17 +* (((
18 +In the same way you can use Outlook or Thunderbird with the same email account, you can use different Matrix apps for the same Matrix account!
19 +Several apps exist, but we're going to go with "[[Element>>https://element.io/]]" for the sake of simplicity, as it's among the most fully-featured Matrix apps on the market.
20 +)))
12 12  
13 -You can create end-to-end encrypted personal or group chats that are not stored and dependent on a central authority like most other tools (ms teams, whatsapp, zoom, ...) . All your messages are synced between all your devices - web clients, desktop clients, smartphone apps. For additional security, encryption keys of contacts can be verified and then stored as trusted.
22 +So people have their **account on one server** but can write messages **to anyone on other servers**.
23 +
14 14  
25 +**Personal or group chats** are[[ end-to-end encrypted>>https://en.wikipedia.org/wiki/End-to-end_encryption]] and **not dependent on a central authority** like most other tools (MS Teams, WhatsApp, Zoom, ...) - anyone can host a Matrix server.
26 +All your messages are **synced** between all your devices - web clients, desktop clients, smartphone apps.
27 +For additional security, encryption keys of contacts can be verified and then stored as trusted.
15 15  
16 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
29 +== Home Server ==
17 17  
18 -[[image:matrixdownload.png||height="284" width="575"]]
31 +Messages are stored and synced between home servers.
19 19  
33 +A user typically has **one account** on one homeserver.
34 +You can use any homeserver of your choice - however **for TUM**, [[ITO>>doc:CIT.ITO.WebHome]] offers two homeservers:
20 20  
36 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
37 +* **matrix.tum.de** for TUM accounts: @username:tum.de
21 21  
22 -== Log in to the web interface ==
39 +You only need to use one account and can communicate with any other homeserver of the world.
23 23  
41 +If you don't have a CIT or TUM account, you can use a **public** homeserver instead:
24 24  
25 -=== With TUM login data ===
43 +* matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]]
44 +* or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]]
45 +* or, [[host your own homeserver>>https://matrix-org.github.io/synapse/latest/]] 🤩
26 26  
47 +To use your home server, you have to **use a client** that communicates with your homeserver.
27 27  
28 -(% class="box" %)
29 -(((
30 -Webpage: https:~/~/matrix.tum.de
31 -)))
49 +== Clients ==
32 32  
33 -(% class="box" %)
34 -(((
35 -ID: LRZ-ID (without @mytum.de or @tum.de)
36 -)))
51 +[[Element>>https://element.io/]] is our client of choice.
37 37  
38 -(% class="box" %)
39 -(((
40 -Password: LRZ/TUM Password
41 -)))
53 +* [[Desktop Client>>https://element.io/download]] (easily provided in [[your Linux distribution of choice>>https://repology.org/project/element-desktop]])
54 +* In your web browser:
55 +** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]]
56 +** [[matrix.tum.de>>https://matrix.tum.de]]
57 +* [[On your smartphone>>https://element.io/download]]
42 42  
43 -[[image:tumaccountlogineng1.png||height="329" width="582"]]
59 +(% class="wikigeneratedid" %)
60 +Make sure the **home server is set correctly** to your provider!
44 44  
45 -
46 -[[image:tumaccountlogineng2n.png||height="362" width="589"]]
47 -
48 -=== With cit.tum login data ===
49 -
50 -(% class="box" %)
62 +(% class="box infomessage" %)
51 51  (((
52 -Webpage: https:~/~/matrix.cit.tum.de
64 +**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
53 53  )))
54 54  
55 -(% class="box" %)
67 +(% class="box infomessage" %)
56 56  (((
57 -ID: ITO-ID (without @cit.tum.de)
69 +**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
58 58  )))
59 59  
60 -(% class="box" %)
61 -(((
62 -Password: cit.tum Password
63 -)))
64 64  
73 +== Using Element for Matrix ==
65 65  
66 -[[image:Screenshot 2023-08-23 at 18.16.21.png||height="474" width="609"]]
67 67  
76 +Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
68 68  
69 -[[image:rbgaccountlogineng2.png||height="377" width="608"]]
78 +You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world.
70 70  
71 71  
72 -== ==
81 += Invitation of TUM Users =
73 73  
74 -== Create new chat room ==
83 +When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
75 75  
76 -If you want to create a new chat room, first click the **+**-Button next to **Rooms** in the program or on the web inferface and then enter the name of the chat room. You can also block users on other servers from joining the room or enable encryption. You can't change these settings later.
85 +**For CIT Accounts**:
77 77  
78 -[[image:addroom1.png||height="311" width="622"]]
79 -
80 -
81 -The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
82 -
83 -[[image:addroom3.png||height="738" width="617"]]
84 -
85 -
86 -== Invite into the chat ==
87 -
88 -There are two types of chat, personal or group chat. You can create either personal or group chats.
89 -
90 -For group chats, you can click the button **Invite to this room** to invite people to that chat. You can also privatly chat with other people in Matrix. If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
91 -
92 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
93 -
94 -**Note**: If you have only released the room for the cit.tum or tum user, only people who are registered on the cit.tum or tum server can access this room.
95 -
96 -
97 -[[image:addroom4.png||height="636" width="616"]]
98 -
99 -[[image:startchat1.png||height="202" width="633"]]
100 -
101 -Enter followings in the opened window:
102 -
103 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
104 -
105 105  (% class="box infomessage" %)
106 106  (((
107 -@ITO-ID:cit.tum.de
89 +@CIT-ID:cit.tum.de     (e.g. @cooluser:cit.tum.de)
108 108  )))
109 109  
110 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
92 +**For TUM Accounts:**
111 111  
112 112  (% class="box infomessage" %)
113 113  (((
114 - @LRZ-ID:tum.de
96 + @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
115 115  )))
116 116  
117 117  **For other Accounts: ** e.g. @musterma:matrix.org
... ... @@ -118,7 +118,21 @@
118 118  
119 119  (% class="box infomessage" %)
120 120  (((
121 - name, email address, username  @username:domain
103 + @username:domain
122 122  )))
123 123  
124 -and send the invitation to the e-mail address of the person to be invited. The invitation will appear in the matrix chat window and must be accepted.
106 +The invitation will then appear in the Matrix client of the just-added user and must be accepted.
107 +
108 +**Search for User Names**
109 +
110 +To add a user to the user directory, he must become a member of a public chat room on the server, e.g. [[https:~~/~~/matrix.to/#/#announcements:tum.de>>https://matrix.to/#/#announcements:tum.de]] on matrix.tum.de, or share a private chat. Only after that his name will be displayed in the search field for persons.
111 +
112 += Secure Backup =
113 +
114 +Since end-to-end encryption stores decryption **keys only on clients** (the "end"), logging out of the last client would mean loosing all messages.
115 +
116 +Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase.
117 +
118 +Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed.
119 +
120 +More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓