mirror of
https://git.envs.net/envs/matrix-doc.git
synced 2024-10-01 11:55:35 +00:00
some modifications
This commit is contained in:
creme
parent
1994d8c2af
commit
35ed2b3f75
23
docs/faq.md
23
docs/faq.md
@ -5,7 +5,7 @@ date: 2020-08-02T21:26:25+02:00
|
||||
draft: false
|
||||
weight: 200
|
||||
---
|
||||
This is a collection of frequently asked questions and their answers. Some of the answers are not yet written. In these cases please ask in the matrix room ```#matrix-support:tu-dresden.de```.
|
||||
This is a collection of frequently asked questions and their answers. Some of the answers are not yet written. In these cases please ask in the matrix room `#envs:envs.net`.
|
||||
|
||||
* [Messages not readable](#message-not-readable)
|
||||
* [What is the difference between passphrase and recovery key?](#securityphrase-vs-securitykey)
|
||||
@ -17,7 +17,6 @@ This is a collection of frequently asked questions and their answers. Some of th
|
||||
* [I do not have a security key (recovery key)](#no-security-key)
|
||||
* [How do I change the passphrase for my key backup?](#change-securityphrase)
|
||||
* [How do I reset the secure backup if I have lost my security phrase AND my (saved and printed) security key?](#reset-securityphrase)
|
||||
* [Why is there no room "TU Dresden"? Who is allowed to create it?](#no-tud-room)
|
||||
* [How can I, as the administrator, delete many messages at once?](#delete-multiple-messages)
|
||||
* [Sometimes I see a room marked in bold and click on it, but I don't have the time to edit the content and any consequences for me immediately. How can I mark the room as "unread" again?](#mark-room-as-unread)
|
||||
* [What should I do if video or audio in a video conference does not work on a MacOS?](#apple-no-video)
|
||||
@ -28,7 +27,7 @@ This is a collection of frequently asked questions and their answers. Some of th
|
||||
|
||||
#### Messages not readable {#message-not-readable}
|
||||
* At least one verified session must be open at all times, the easiest way to do this is to set up the Desktop Client or Element on a smartphone. These programs can be closed and restarted without having to log in again. Otherwise, a verified Matrix session can be created in a private web browser window by logging into Matrix there and verifying this session from an existing one. This window can be closed after about five minutes. The keys are transferred to the other Matrix clients by the verification process. This creates a ghost session which is then always open. Then all other clients can be logged out. Otherwise messages which are received in the period without open matrix session cannot be read later. This is to be solved in the future by means of the function dehydrated devices.
|
||||
* Has the [Secure Backup]({{< relref "settings/#secure-backup" >}}) been set up properly?
|
||||
* Has the [Secure Backup](/secure-backup.md) been set up properly?
|
||||
* Messages remain unreadable when matrix sessions are created and then the web browser window is simply closed without logging out. Solution: only possible for new messages: read this documentation.
|
||||
|
||||
***
|
||||
@ -57,20 +56,20 @@ No, threads like in Mattermost or Slack are currently not existing in Matrix. Th
|
||||
|
||||
***
|
||||
#### I do not have a security key (recovery key) {#no-security-key}
|
||||
To do this, please check whether this has been set up at all. See [Secure backup]({{< relref "settings/#secure-backup" >}})
|
||||
To do this, please check whether this has been set up at all. See [Secure backup](/settings.md/#secure-backup)
|
||||
|
||||
***
|
||||
#### How do I change the passphrase for my key backup? {#change-securityphrase}
|
||||
* export the room keys for all matrix sessions except for one, which is still accessible, `Settings` -> `Security & Privacy` -> `Encryption`/`Cryptography`, here it is best to provide the matrix login password. Finally, log out by clicking on the user name in the upper left corner and log out. If you are asked whether you want the encrypted messages, click on 'I don't want my encrypted messages', because these keys have already been exported.
|
||||
* Under `Settings`-> `Security & Privacy` -> `Secure Backup` press first `Delete Backup`, afterwards the button `Reset` and may a clearing of the cache under `Settings`-> `Help & About` is necessary, as well a logging off and logging on again. If all this does not work, continue in the next point. The action was successful, if only the green 'Setup' button is displayed.
|
||||
* For all previously exported key backups, perform the manual import path
|
||||
* Set up a new security backup. See [Secure backup]({{< relref "settings/#secure-backup" >}})
|
||||
* Set up a new security backup. See [Secure backup](/settings.md/#secure-backup)
|
||||
|
||||
***
|
||||
#### How do I reset the secure backup if I have lost my security phrase AND my (saved and printed) security key? {#reset-securityphrase}
|
||||
Please execute the following:
|
||||
* export the room keys for all matrix sessions except for one, which is still accessible, `Settings` -> `Security & Privacy` -> `Encryption`/`Cryptography`, here it is best to provide the matrix login password. Finally, log out by clicking on the user name in the upper left corner and log out. If you are asked whether you want the encrypted messages, click on 'I don't want my encrypted messages', because these keys have already been exported.
|
||||
* [Delete]({{< relref "settings/#security--privacy" >}}) all sessions that are no longer accessible. the top one in bold is the current session, do not tick this one
|
||||
* [Delete](/settings.md/#security--privacy) all sessions that are no longer accessible. the top one in bold is the current session, do not tick this one
|
||||
* Log off the last session
|
||||
* Write a message to the ServiceDesk with a request to delete the security keys from the database.
|
||||
* Wait for the answer
|
||||
@ -80,11 +79,7 @@ Please execute the following:
|
||||
* Under `Settings`-> `Security & Privacy` -> `Secure Backup` look if there is a green button `Setup` and no red buttons. If there are still red buttons, press first `Delete Backup`, afterwards the button `Reset` and may a clearing of the cache under `Settings`-> `Help & About` is necessary, as well a logging off and logging on again. Also it may be necessary to press the red button `Reset` under `Settings`-> `Security & Privacy` -> `Cross-Signing`. The action was successful, if for 'Secure Backup' and 'Cross-Signing' only the green 'Setup' button is displayed.
|
||||
* If all this does not work reply to the ticket with a request for a jitsi meeting
|
||||
* For all previously exported key backups, perform the manual import path
|
||||
* Set up a new security backup. See [Secure backup]({{< relref "settings/#secure-backup" >}})
|
||||
|
||||
***
|
||||
#### Why is there no room "TU Dresden"? Who is allowed to create it? {#no-tud-room}
|
||||
All persons creating a room are administrative persons and are responsible for the room. Matrix is not yet designed for the exchange of thousands of members at the university. Should a central room be needed one day, its establishment and maintenance would certainly be the responsibility of the Rectorate and the Department of "Strategy & Communication".
|
||||
* Set up a new security backup. See [Secure backup](/settings.md/#secure-backup)
|
||||
|
||||
***
|
||||
#### How can I, as the administrator, delete many messages at once? {#delete-multiple-messages}
|
||||
@ -125,7 +120,7 @@ Due to an update on the Matrix server (28.03.2021), clients that have been logge
|
||||
<li>Make sure you have fulfilled at least one of the following prerequisites:</li>
|
||||
<ol type="a">
|
||||
<li>... an additional verified session (e.g. with the smartphone) is active and usable</li>
|
||||
<li>... the <a href="{{< relref "settings/#secure-backup" >}} ">Secure Backup</a> is set up and the security phrase or the security key are present</li>
|
||||
<li>... the <a href="/settings.md/#secure-backup">Secure Backup</a> is set up and the security phrase or the security key are present</li>
|
||||
<li>... you have exportet your room keys</li>
|
||||
</ol>
|
||||
<li>Log off and log on again within the client and use as Matrix <strong>homeserver</strong>: "<strong>tu-dresden.de</strong>"</li>
|
||||
@ -133,10 +128,10 @@ Due to an update on the Matrix server (28.03.2021), clients that have been logge
|
||||
<ol type="a">
|
||||
<li>... Verify the new session in the additional active session to start the key exchange between these sessions</li>
|
||||
<li>... Connect to the Secure Backup to get your message keys back</li>
|
||||
<li>... Import the room keys and set up the <a href="{{< relref "settings/#secure-backup" >}} ">Secure Backup</a></li>
|
||||
<li>... Import the room keys and set up the <a href="/settings.md/#secure-backup">Secure Backup</a></li>
|
||||
</ol>
|
||||
|
||||
**Annotations:**
|
||||
* Losing the room keys will result in the loss of your messages, as they can only be read by you and your communication participants. No admin can help with that.
|
||||
* Because of the new session, a red warning sign is subsequently displayed for all your previous messages. This is not an error, but just a little too dramatic information setting (further information can be found here: [external link](https://github.com/vector-im/element-web/issues/13701))
|
||||
* Because of the new session, a red warning sign is subsequently displayed for all your previous messages. This is not an error, but just a little too dramatic information setting (further information can be found here: [https://github.com/vector-im/element-web/issues/13701](https://github.com/vector-im/element-web/issues/13701))
|
||||
* If you only use Matrix on one device and you do not have access to your security phrase or security key you have to follow route c) to not loose your encrypted messages.
|
||||
|
||||
@ -3362,7 +3362,7 @@
|
||||
</g>
|
||||
</a>
|
||||
<a
|
||||
href="https://matrix.tu-dresden.de"
|
||||
href="https://matrix.envs.net"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
id="href_element">
|
||||
@ -3394,7 +3394,7 @@
|
||||
x="289.30502"
|
||||
y="171.15099"
|
||||
id="tspan612-8-4-1-6-9-9"
|
||||
style="font-size:2.46944px;font-family:sans-serif;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke-width:1">The TUD browser instance</tspan></text>
|
||||
style="font-size:2.46944px;font-family:sans-serif;text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke-width:1">the envs matrix-webclient</tspan></text>
|
||||
</g>
|
||||
</a>
|
||||
<a
|
||||
@ -3417,7 +3417,7 @@
|
||||
</g>
|
||||
</a>
|
||||
<a
|
||||
href="/en/clients/install_linux/"
|
||||
href="https://element.io/get-started"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
id="href_linux">
|
||||
|
||||
|
Before Width: | Height: | Size: 447 KiB After Width: | Height: | Size: 447 KiB |
@ -11,9 +11,7 @@ Matrix is a free and open, secure, decentralized protocol for real-time communic
|
||||
|
||||
<object data="images/matrix_interactive_en.svg" type="image/svg+xml" style="width: 1280px; max-width: 100%"></object>
|
||||
|
||||
In recent years, the need for supporting digital tools for team collaboration has increased. A central tool is a team chat. According to Wikipedia, a chat refers to "electronic communication by means of written text in real time, usually via the Internet". ([Source](https://en.wikipedia.org/wiki/Chat)). With a messenger team members can make each other aware of current information and especially share links (*hyperlinks* / *links*) for further collaboration (e.g. for finding appointments, collaborative writing, planning events, editing data, code, mind maps,). Due to the lack of a centralized offer so far, many teams at TU Dresden have been looking for their own solutions, some of which are privacy-critical or cannot be linked to other systems.
|
||||
|
||||
In order to meet the demand for real-time communication, the open communication protocol Matrix was introduced in a pilot operation at the TU Dresden at the end of 2018, after a comparative analysis of several potential solution options, and presented to the CIO in April 2019. In autumn 2019, the pilot operation was transferred to regular operation. e.g. [digital](https://invidious.13ad.de/AtkA-sE-9uU) [teaching](https://invidious.13ad.de/jEvKdFTKSxU) (Videos by Prof. Lasch) with Matrix in addition to the [OPAL](https://bildungsportal.sachsen.de/opal) application.
|
||||
In recent years, the need for supporting digital tools for team collaboration has increased. A central tool is a team chat. According to Wikipedia, a chat refers to "electronic communication by means of written text in real time, usually via the Internet". ([Source](https://en.wikipedia.org/wiki/Chat)). With a messenger team members can make each other aware of current information and especially share links (*hyperlinks* / *links*) for further collaboration (e.g. for finding appointments, collaborative writing, planning events, editing data, code, mind maps,).
|
||||
|
||||
## Topics
|
||||
|
||||
@ -39,18 +37,17 @@ In order to meet the demand for real-time communication, the open communication
|
||||
|
||||
### Questions and Contact
|
||||
|
||||
Please address general questions to the service desk envs.net:
|
||||
The ideal is to deal with problems in a transparent way, from which all others can learn. This can be done by describing the situation in the ENVS main room - here problems and solutions can be discussed together:
|
||||
|
||||
https://envs.net/impressum/
|
||||
|
||||
The ideal is to deal with problems in a transparent way, from which all others can learn. This can be done by describing the situation in the Matrix Support Room - here problems and solutions can be discussed together:
|
||||
|
||||
[https://matrix.to/#/#home:envs.net](https://matrix.to/#/#home:envs.net)
|
||||
|
||||
<span class="notice">
|
||||
For some anomalies you can try to empty the cache and reload everything: Settings > Help & About > Clear Cache and reload
|
||||
</span>
|
||||
[#envs:envs.net](https://matrix.to/#/#envs:envs.net)
|
||||
|
||||
<span class="warning">
|
||||
Current maintenance is announced in the matrix room [/TODO ADD MATRIX ROOM HERE]).
|
||||
For some anomalies you can try to empty the cache and reload everything:
|
||||
</span>
|
||||
|
||||
`Settings > Help & About > Clear Cache and reload`
|
||||
|
||||
<span class="warning">
|
||||
Current maintenance is announced in the matrix room [#home:envs.net](https://matrix.to/#/#home:envs.net) and
|
||||
[#status:envs.net](https://matrix.to/#/#status:envs.net).
|
||||
</span>
|
||||
|
||||
13
docs/why.md
13
docs/why.md
@ -17,17 +17,12 @@ There are many services and programs for instant electronic communication. Matri
|
||||
- Data protection: end-to-end encryption standard in 1:1 conversations and (group) rooms, can be switched off in the latter
|
||||
- Web application + desktop client + mobile apps available
|
||||
- The contacts on your own cell phone are not automatically passed on to third parties (no address book upload)
|
||||
- Connection to existing authentication systems (e.g. TU Dresden)
|
||||
- Connection to existing authentication systems
|
||||
- Existing successful security audit
|
||||
- Autonomy and control: locally installable (server location TU Dresden)
|
||||
- Autonomy and control: locally installable (selfhosted server by envs.net)
|
||||
- Recognize the presence status
|
||||
- Active further development
|
||||
- Up-and-coming use by other scientific institutions (e.g. lots of German universities)
|
||||
|
||||
Further informationen: https://matrix.org/faq/#intro
|
||||
Further informationen: [https://matrix.org/faq/#intro](https://matrix.org/faq/#intro)
|
||||
|
||||
Detailed explanation of technical terms: https://matrix.org/faq/#definitions
|
||||
|
||||
Institutions of higher education (e.g. universities) with a Matrix service:
|
||||
|
||||
<object data="../images/federation_map.svg" type="image/svg+xml" style="width: 600px; max-width: 100%"></object>
|
||||
Detailed explanation of technical terms: [https://matrix.org/faq/#definitions](https://matrix.org/faq/#definitions)
|
||||
|
||||
10
mkdocs.yml
10
mkdocs.yml
@ -8,9 +8,9 @@ theme: readthedocs
|
||||
|
||||
nav:
|
||||
- Home: index.md
|
||||
- Why: why.md
|
||||
- First Steps: first-steps.md
|
||||
- Important Settings: settings.md
|
||||
- Why Matrix?: why.md
|
||||
- First steps: first-steps.md
|
||||
- Important settings: settings.md
|
||||
- Clients / Instalation: clients.md
|
||||
- Messages: messaging.md
|
||||
- Rooms: rooms.md
|
||||
@ -19,12 +19,10 @@ nav:
|
||||
- Encryption: encryption.md
|
||||
- Integrations: integrations.md
|
||||
- FAQ: faq.md
|
||||
- Development: development.md
|
||||
|
||||
- Development: development.md
|
||||
|
||||
markdown_extensions:
|
||||
- toc:
|
||||
permalink: "#"
|
||||
baselevel: 1
|
||||
separator: "_"
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user