New post about matrix migration
This commit is contained in:
parent
ffd1358f1f
commit
9d5708f0e5
2 changed files with 66 additions and 3 deletions
|
@ -29,7 +29,6 @@ GEM
|
|||
rouge (~> 3.0)
|
||||
safe_yaml (~> 1.0)
|
||||
terminal-table (~> 2.0)
|
||||
jekyll-paginate (1.1.0)
|
||||
jekyll-sass-converter (2.1.0)
|
||||
sassc (> 2.0.1, < 3.0)
|
||||
jekyll-sitemap (1.4.0)
|
||||
|
@ -68,7 +67,6 @@ PLATFORMS
|
|||
|
||||
DEPENDENCIES
|
||||
jekyll (>= 4.2.0)
|
||||
jekyll-paginate
|
||||
jekyll-sitemap
|
||||
racc
|
||||
redcarpet
|
||||
|
@ -76,4 +74,4 @@ DEPENDENCIES
|
|||
webrick (~> 1.7)
|
||||
|
||||
BUNDLED WITH
|
||||
2.2.15
|
||||
2.2.33
|
||||
|
|
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
layout: post
|
||||
slug: matrix-migrate-encrypted-room-to-a-clear-text-one
|
||||
status: published
|
||||
sitemap: true
|
||||
title: "Matrix: Migrate an encrypted room to a clear text one"
|
||||
description: Matrix E2EE does not work well with public roooms
|
||||
category: operation
|
||||
tags:
|
||||
---
|
||||
|
||||
Some time ago, the Matrix team was pushing hard E2EE and activated for all created rooms.
|
||||
Believing encryption was the future, we kept this default for all the rooms we created.
|
||||
But now that one of our room starts being popular, it appeares that E2EE does not work well with public rooms:
|
||||
1. the history is not available to newcomers
|
||||
2. we can not search the history of an encrypted room (or at least, I never managed to make it work even with the desktop app)
|
||||
3. notifications options are limited on mobile
|
||||
4. scaling issues
|
||||
5. and so on.
|
||||
|
||||
It seems that Matrix developpers are aware of these problems as now, if you create a "public room", you will not be asked to encrypt it at all.
|
||||
But for existing rooms, we have a problem: for security reasons, you can't disable encryption in a room.
|
||||
Our only option is to create a new room and to point the old one to the new one.
|
||||
Thankfully, Matrix has a feature named **Tombstone** that helps redirecting users from one room to another.
|
||||
This feature is used for room version upgrade, but we can "abuse" it to redirect people to a completely different room.
|
||||
|
||||
First, you must create a new clear text room.
|
||||
To provide the best experience to your users, take time to configure its picture, description, and so on.
|
||||
Now, go to your old room, remove all its aliases to be able to set them on the new room.
|
||||
You can set a new alias for your old room and send a message containing it on your new room, to "connect it with the old one", eg:
|
||||
|
||||
> Hi, this is the beginning of the history of this room. If you want to go back even more in time, check the old room: #myroom-old:example.tld
|
||||
|
||||
Finally, you need the identifier of your room. It starts with a `!`. For example: `!ARbIZeDKGloDOnjyyw:deuxfleurs.fr`.
|
||||
Keep it somewhere accessible, and we are done configuring our new room.
|
||||
|
||||
We can now prepare the tombstone for the old room.
|
||||
First, you should inform your users with a message, something like:
|
||||
|
||||
> Hi @room, we are migrating to a new room to fix some issues with this one.
|
||||
You will not be able to post new messages here, please follow the provided redirection to join the new room.
|
||||
Sorry for the inconvenience.
|
||||
|
||||
Now, open the developper tools in your old room by typing in the message box:
|
||||
|
||||
```
|
||||
/devtools
|
||||
```
|
||||
|
||||
*You can also open it by going in "Room Settings" -> "Advanced" -> "Open Devtools"*
|
||||
|
||||
A window must appear. Click on "Send Custom Event". Then click on the red button "Event" to create a "State Event".
|
||||
Put `m.room.tombstone` as the Event Type, keep the State Key field empty, and finally enter the following content (replace the example room ID by the one of your new room):
|
||||
|
||||
```json
|
||||
{
|
||||
"body": "We migrated to a cleartext rooms as E2EE does not work well with large public rooms",
|
||||
"replacement_room": "!ARbIZeDKGloDOnjyyw:deuxfleurs.fr"
|
||||
}
|
||||
```
|
||||
|
||||
And that's all, you have migrated your old encrypted room to a new clear text one!
|
||||
|
||||
If you want to explore all the possibilities offered by the developer tools, you can read [Matrix specification](https://spec.matrix.org/).
|
||||
For example, our tombstone event is documented here: [`m.room.tombstone`](https://spec.matrix.org/v1.2/client-server-api/#mroomtombstone)
|
Loading…
Reference in a new issue