Changes for page Matrix

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.kahraman
	1	+XWiki.jelten

Content

...	...	@@ -1,172 +1,99 @@
1	1	{{toc/}}
2	2
3	3
4		-= Establishing a Matrix Chat =
	4	+== What is Matrix? ==
5	5
6	6
7		-There are two Matrix-Servers:
8		- 1 matrix.tum.de (LRZ-ID)
9		- 1 matrix.cit.tum.de (ITO-ID)
	7	+[[image:https://element.io/images/Ui-grad-homepage.png||height="677" width="942"]]
10	10
11		-You can log in any of them with the appropriate ID and password.
12		-The Matrix Server is available as web but also as client. It can be found as web interface under the following links:
13	13
14		-[[matrix.cit.tum.de (ITO- ID)>>url:https://matrix.cit.tum.de/#/welcome]]
	10	+[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
15	15
16		-[[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]]
17		-
18		-
19		-[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
20		-
21		-
22		-[[image:matrixdownload.png]]
23		-
24		-
25		-== Log in ==
26		-
27		-
28		-=== Log in to the web interface with TUM login data ===
29		-
30		-
31		-
32		-(% class="box" %)
33		-(((
34		-webpage: https:~/~/matrix.tum.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}}!
35	35	)))
36		-
37		-(% class="box" %)
38		-(((
39		-ID: LRZ-ID (without @mytum.de or @tum.de)
	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.
40	40	)))
41	41
42		-(% class="box" %)
43		-(((
44		-Password: LRZ/TUM Password
45		-)))
46		-
47		-(% class="box" %)
48		-(((
	22	+So people have their **account on one server** but can write messages **to anyone on other servers**.
49	49
50		-)))
51	51
52		-[[image:tumaccountlogineng1.png]]
	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.
53	53
	29	+== Home Server ==
54	54
	31	+Messages are stored and synced between home servers.
55	55
	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:
56	56
57		-[[image:tumaccountlogineng2n.png]]
	36	+* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
	37	+* **matrix.tum.de** for TUM accounts: @username:tum.de
58	58
59		-=== Log in to the web interface with cit.tum login data ===
	39	+You only need to use one account and can communicate with any other homeserver of the world.
60	60
61		-(% class="box" %)
62		-(((
63		-webpage: https:~/~/matrix.cit.tum.de
64		-)))
	41	+If you don't have a CIT or TUM account, you can use a **public** homeserver instead:
65	65
66		-(% class="box" %)
67		-(((
68		-ID: ITO-ID (without @cit.tum.de)
69		-)))
	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/]] 🤩
70	70
71		-(% class="box" %)
72		-(((
73		-Password: cit.tum Password
74		-)))
	47	+To use your home server, you have to **use a client** that communicates with your homeserver.
75	75
	49	+== Clients ==
76	76
77		-== [[image:rbgaccountlogineng1.png]] ==
	51	+[[Element>>https://element.io/]] is our client of choice.
78	78
79		-== [[image:rbgaccountlogineng2.png]] ==
	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]]
80	80
81		-== Create new chat room ==
	59	+(% class="wikigeneratedid" %)
	60	+Make sure the **home server is set correctly** to your provider!
82	82
83		-
84		-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		-
86		-
87		-[[image:addroom1.png]]
88		-
89		-
90		-
91		-[[image:addroom3.png]]
92		-
93		-
94		-
95		-
96		-
97		-The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
98		-
99		-
100		-
101		-== Invite into the chat room ==
102		-
103		-
104		-**Requirement**: The member which is been invited has registered once on the Matrix Server.
105		-
106		-**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.
107		-
108		-If you want to invite new members to the room, click the button **Invite to this room**.
109		-
110		-[[image:addroom4.png]]
111		-
112		-
113		-Enter followings in the opened window:
114		-
115		-**For ITO Accounts**: e.g. @musterma:cit.tum.de
116		-
117	117	(% class="box infomessage" %)
118	118	(((
119		-@ITO-ID:cit.tum.de
	64	+**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
120	120	)))
121	121
122		-**For TUM Accounts: **e.g. @lr89rbg:tum.de
123		-
124	124	(% class="box infomessage" %)
125	125	(((
126		- @lrz-ID:tum.de
	69	+**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
127	127	)))
128	128
129		-**For other Accounts: ** e.g. @musterma:matrix.org
130	130
131		-(% class="box infomessage" %)
132		-(((
133		- name, email address, username  @username:domain
134		-)))
	73	+== Using Element for Matrix ==
135	135
136		-and send the invitation to the e-mail address of the person to be invited.
137	137
	76	+Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
138	138
139		-[[image:invitetotestroom.png]]
	78	+You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world.
140	140
141		-The invitation will appear in the matrix chat window and must be accepted.
142	142
	81	+== Invitation of TUM Users ==
143	143
	83	+When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
144	144
145		-=== invite to the private chat ===
	85	+**For CIT Accounts**:
146	146
147		-
148		-**Requirement**: The member which is been invited has registered once on the Matrix Server.
149		-
150		-
151		-You can also privatly chat with other 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.
152		-
153		-[[image:startchat1.png||width="1000"]]
154		-
155		-
156		-Enter followings in the opened window:
157		-
158		-**For ITO Accounts**: e.g. @musterma:cit.tum.de
159		-
160	160	(% class="box infomessage" %)
161	161	(((
162		-@ITO-ID:cit.tum.de
	89	+@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
163	163	)))
164	164
165		-**For TUM Accounts: **e.g. @lr89rbg:tum.de
	92	+**For TUM Accounts:**
166	166
167	167	(% class="box infomessage" %)
168	168	(((
169		- @lrz-ID:tum.de
	96	+ @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
170	170	)))
171	171
172	172	**For other Accounts: ** e.g. @musterma:matrix.org
...	...	@@ -173,19 +173,18 @@
173	173
174	174	(% class="box infomessage" %)
175	175	(((
176		- name, email address, username  @username:homeserver
	103	+ @username:domain
177	177	)))
178	178
179		-and send the invitation to the e-mail address of the person to be invited.
	106	+The invitation will then appear in the Matrix client of the just-added user and must be accepted.
180	180
181	181
182		-[[image:invitepeople1.png||width="1000"]]
	109	+== Secure Backup ==
183	183
	111	+Since end-to-end encryption stores decryption **keys only on clients** (the "end"), logging out of the last client would mean loosing all messages.
184	184
185		-[[image:invitepeople2.png||width="1000"]]
	113	+Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase.
186	186
	115	+Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed.
187	187
188		-The invitation will appear in the element chat window and must be accepted.
189		-
190		-
191		-----
	117	+More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓