Migrácia maticového účtu

Migrácia Matrix účtu z verejného servera na vlastnú inštanciu

Migrácia Matrix účtu z verejného servera (napr. matrix.org) na vlastnú Matrix inštanciu (napr. s použitím Synapse ako domovského servera) je možná, ale vyžaduje si starostlivé plánovanie, pretože ide o decentralizovaný a bezpečný systém. Chyby môžu viesť k strate prístupu k existujúcim chatom alebo šifrovacím kľúčom. Tento návod popisuje kroky na úspešnú migráciu účtu.

---

Autor nezodpovedá za tento návod. Návrhy na zlepšenie sú vítané.

---

Predpoklady

• Existujúci Matrix účet na verejnom serveri (napr. @používateľ:matrix.org).
• Vlastná Matrix inštancia, ktorá je správne nastavená (napr. s použitím Synapse, nginx, PostgreSQL a Let's Encrypt).
• Prístup k Matrix klientovi, napr. Element.
• Základné znalosti správy servera (napr. SSH, konfiguračné súbory).
• Záloha šifrovacích kľúčov starého účtu (pre end-to-end šifrovanie).
• Voliteľné: Prístup k exportovaným údajom starého účtu, ak to verejný server podporuje (napr. Element Matrix Services).

Krok za krokom návod

1. Nastavenie vlastnej Matrix inštancie

Pred začatím migrácie musí byť vlastná Matrix inštancia plne funkčná. Postupujte podľa týchto krokov:

1. Nainštalujte a nakonfigurujte Matrix domovský server (napr. Synapse) na serveri.
2. Uistite sa, že federácia je aktivovaná, a overte konfiguráciu pomocou Matrix Federation Tester.
3. Vytvorte nový používateľský účet na vlastnej inštancii pomocou príkazu:

register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008

 Zadajte používateľské meno (localpart), heslo a prípadne administrátorské práva.

2. Príprava starého účtu

1. Prihláste sa so starým účtom do Matrix klienta, ako je Element.
2. Exportujte šifrovacie kľúče pre end-to-end šifrované miestnosti:

 ** V Elemente: Prejdite na Nastavenia > Bezpečnosť a súkromie > Šifrovanie > Exportovať kľúče.
 ** Bezpečne uložte kľúče, pretože sú potrebné na prístup k šifrovaným chatom.

1. Zapíšte si všetky miestnosti, v ktorých je váš starý účet členom, pretože tieto bude potrebné manuálne alebo automaticky migrovať.

3. Migrácia účtu

Migrácia sa môže vykonať manuálne alebo pomocou nástroja. Tu popisujeme migračný nástroj od Element Matrix Services, ktorý proces zjednodušuje.

1. Vytvorenie nového účtu: Prihláste sa na svojej inštancii s novým účtom (napr. @používateľ:mojadoména.sk).
2. Odhlásenie zo starého účtu: Odhláste sa zo starého účtu vo všetkých aplikáciách.
3. Použitie migračného nástroja:

 ** Prejdite na Migračný nástroj Element Matrix Services.
 ** Prihláste sa so starým aj novým účtom.
 ** Nástroj automaticky pozve nový účet do všetkých miestností, v ktorých bol starý účet členom.
 ** Voliteľné: Aktivujte možnosť, aby starý účet opustil miestnosti, akonáhle sa nový účet pripojí.
 ** Migrujte metadáta, ako sú zobrazované meno a avatar, ak je to požadované.
 ** Poznámka: Ide o experimentálnu funkciu (Labs Feature), ktorá by sa mala používať opatrne.

1. Import šifrovacích kľúčov:

 ** V Elemente: Prejdite na Nastavenia > Bezpečnosť a súkromie > Šifrovanie > Importovať kľúče.
 ** Nahrajte predtým exportované kľúče na obnovenie prístupu k šifrovaným chatom.

4. Overenie migrácie

1. Skontrolujte, či je nový účet vo všetkých požadovaných miestnostiach.
2. Otestujte komunikáciu vo verejných aj súkromných miestnostiach.
3. Uistite sa, že šifrované chaty sú prístupné pomocou importovaných kľúčov.
4. Voliteľné: Deaktivujte starý účet na verejnom serveri, aby ste predišli zmätkom (napr. jeho vymazaním alebo deaktiváciou, ak to server podporuje).

5. Následné kroky

1. Informujte svoje kontakty o novej Matrix ID (@používateľ:mojadoména.sk).
2. Skontrolujte konfiguráciu servera (napr. TLS certifikáty pomocou SSL Labs) a federáciu.
3. Pravidelne zálohujte databázu vašej Matrix inštancie (napr. PostgreSQL zálohy).

Dôležité poznámky

• Bezpečnosť: Uistite sa, že vlastná inštancia je správne nakonfigurovaná s TLS certifikátmi (napr. Let's Encrypt) a bezpečným firewallom (napr. ufw).
• Šifrovanie: Bez exportovaných kľúčov môžu byť šifrované chaty stratené. Pred migráciou ich preto bezpodmienečne zálohujte.
• Federácia: Nová inštancia musí byť správne federovaná, aby mohla komunikovať s inými Matrix servermi.<ref name="web21" />
• Manuálna migrácia: Ak migračný nástroj nie je dostupný, môžete nový účet manuálne pozvať do všetkých miestností a potom starý účet opustiť. Tento proces je však časovo náročnejší.
• Riziká: Migrácia je citlivý proces. Chyby môžu viesť k tomu, že starý účet už nebude použiteľný. Vždy preto vytvárajte zálohy.

Ďalšie zdroje

• Matrix.org – Oficiálna stránka Matrix protokolu
• Element.io – Informácie o klientovi Element
• Matrix Federation Tester – Overenie federácie
• Návod na nastavenie Matrix Synapse