Hop til hovedindhold

Din første enhed

Forudsætning

Denne side kræver en Matrix-homeserver (Synapse), som du eller en, du stoler på, driver, samt administratoradgang til den. Har du ingen, er denne vej ikke tilgængelig for dig — og intet andet i Lotti afhænger af den.

Hver enhed efter den første får sin parringskode fra en enhed, du allerede bruger — det forløb er Tilføj en enhed. Den første er anderledes: der er ingen anden enhed, der kan lave en kode. Lottis synkronisering er selvhostet, så den første kode kommer fra serversiden — oprettet af den, der driver din Synapse-homeserver.

Hvad provisioneringsværktøjet gør​

Lotti leverer en admin-CLI, Matrix-provisioneren, i repositoriet på tools/matrix_provisioner. Kørt af en homeserver-admin:

  1. opretter den en frisk Matrix-konto dedikeret til synkronisering,
  2. opretter det krypterede synkroniseringsrum, og
  3. skriver et provisioneringsbundle — den tekst, Lotti accepterer som parringskode — til en fil.

README'en ved siden af værktøjet dokumenterer engangsopsætningen, hvert argument og de sikre måder at levere admin-adgangskoden på. En minimal kørsel ser sådan ud:

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

Driver du ikke din egen homeserver, er dette trin ikke dit — bed den, der driver serveren, om bundlet, og behandl vejen, det når dig ad, med den omhu, der beskrives nedenfor.

Brug bundlet som din første parringskode​

På den enhed, der skal være din første, åbn Indstillinger → Synkroniseringsindstillinger → Enheder, og vælg Konfigurer synkronisering. Indsæt bundlets tekst i kodefeltet — på en telefon, hvor kameraet åbner først, vælger du Indsæt koden i stedet for at komme derhen. Gennemgå hvad koden beskriver, og forbind — for en første enhed er det hele rejsen. Der er ingen emoji-verificering her: den sammenligner to af dine enheder, og du har kun én. Ceremonien dukker op første gang, når du parrer din anden enhed med Tilføj en enhed.

Også værd at vide: at bruge et frisk provisioneringsbundle roterer kontoens adgangskode som en del af forbindelsen. Bundlefilen er brugt op efter første anvendelse — den gyldige adgang findes derefter kun på den enhed, og hver følgende enhed parres fra en eksisterende med Tilføj en enhed. Slet bundlefilen, så snart den første enhed er forbundet; en glemt kopi kan ikke længere logge ind, men der er ingen grund til at beholde den.

Indtil den første brug skal du behandle bundlet som en adgangskode: det logger ind på synkroniseringskontoen — hold det ude af chats, skærmbilleder og delte skærme.