Je eerste apparaat

Vereiste

Deze pagina vereist een Matrix-homeserver (Synapse) die jij of iemand die je vertrouwt beheert, plus beheerderstoegang. Heb je die niet, dan is dit pad niet voor jou beschikbaar — en niets anders in Lotti hangt ervan af.

Elk apparaat na het eerste krijgt zijn koppelcode van een apparaat dat je al gebruikt — dat traject is Een apparaat toevoegen. Het eerste is anders: er is geen ander apparaat dat een code kan maken. Lotti's synchronisatie is self-hosted, dus de eerste code komt van de serverkant — gemaakt door degene die jouw Synapse-homeserver beheert.

Wat het provisioninggereedschap doet

Lotti levert een admin-CLI mee, de Matrix-provisioner, in de repository op tools/matrix_provisioner. Uitgevoerd door een homeserver-admin:

1. maakt het een vers Matrix-account aan, alleen voor synchronisatie,
2. maakt het de versleutelde synchronisatieruimte aan, en
3. schrijft het een provisioningbundle — de tekst die Lotti als koppelcode accepteert — naar een bestand.

De README naast het gereedschap documenteert de eenmalige installatie, elk argument en de veilige manieren om het admin-wachtwoord aan te leveren. Een minimale run ziet er zo uit:

cd tools/matrix_provisioner
python provision.py \
  --homeserver https://matrix.example.com \
  --admin-user admin \
  --username lotti_sync_user42 \
  --output-file bundle.txt

Beheer je geen eigen homeserver, dan is deze stap niet aan jou — vraag de beheerder van de server om de bundle, en behandel de weg waarlangs die jou bereikt met de zorg die hieronder staat.

De bundle als je eerste koppelcode gebruiken

Open op het apparaat dat je eerste apparaat moet worden Instellingen → Instellingen synchroniseren → Apparaten en kies Synchronisatie instellen. Plak de tekst van de bundle in het codeveld — op een telefoon, waar eerst de camera opent, kom je daar via Plak de code in plaats daarvan. Kijk na wat de code beschrijft en verbind — voor een eerste apparaat is dat meteen de hele reis. Emoji-verificatie is er hier niet: die vergelijkt twee van je apparaten, en je hebt er pas één. De ceremonie verschijnt voor het eerst wanneer je je tweede apparaat koppelt met Een apparaat toevoegen.

Ook goed om te weten: het gebruiken van een verse provisioningbundle roteert het accountwachtwoord tijdens het verbinden. Het bundlebestand is daarmee na het eerste gebruik verbruikt — het geldige inloggegeven bestaat dan alleen op dat apparaat, en elk volgend apparaat koppelt vanaf een bestaand apparaat met Een apparaat toevoegen. Verwijder het bundlebestand zodra het eerste apparaat verbonden is; een achtergebleven kopie kan niet meer inloggen, maar er is geen reden om die te bewaren.

Tot dat eerste gebruik behandel je de bundle als een wachtwoord: er kan mee worden ingelogd op het synchronisatieaccount — houd hem uit chats, schermafbeeldingen en gedeelde schermen.