Zum Hauptinhalt springen

Dein erstes Gerät

Voraussetzung

Diese Seite setzt einen Matrix-Homeserver (Synapse) voraus, den du oder jemand, dem du vertraust, betreibt, samt Administratorzugang dazu. Ohne einen solchen steht dir dieser Weg nicht offen – und nichts anderes in Lotti hängt davon ab.

Jedes Gerät nach dem ersten bekommt seinen Pairing-Code von einem Gerät, das du bereits nutzt — dieser Ablauf ist Gerät hinzufügen. Das erste ist anders: Es gibt kein anderes Gerät, das einen Code erzeugen könnte. Lottis Synchronisierung ist selbst gehostet, der erste Code kommt deshalb von der Serverseite — erstellt von der Person, die deinen Synapse-Homeserver betreibt.

Was das Provisionierungswerkzeug tut​

Lotti liefert ein Admin-CLI mit, den Matrix-Provisioner, im Repository unter tools/matrix_provisioner. Von einem Homeserver-Admin ausgeführt:

  1. erstellt es ein frisches Matrix-Konto nur für die Synchronisierung,
  2. erstellt den verschlüsselten Sync-Raum und
  3. schreibt ein Provisionierungs-Bundle — den Text, den Lotti als Pairing-Code akzeptiert — in eine Datei.

Das README neben dem Werkzeug dokumentiert die einmalige Einrichtung, jedes Argument und die sicheren Wege, das Admin-Passwort zu übergeben. Ein minimaler Aufruf sieht so aus:

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

Wenn du keinen eigenen Homeserver betreibst, ist dieser Schritt nicht deiner — bitte die Person, die den Server betreibt, um das Bundle, und behandle den Weg, auf dem es dich erreicht, mit der unten beschriebenen Sorgfalt.

Das Bundle als ersten Pairing-Code verwenden​

Öffne auf dem Gerät, das dein erstes werden soll, Einstellungen → Synchronisierungseinstellungen → Geräte und wähle Sync einrichten. Füge den Text des Bundles in das Codefeld ein — auf dem Telefon, wo sich zuerst die Kamera öffnet, kommst du mit Code stattdessen einfügen dorthin. Prüfe, was der Code beschreibt, und verbinde — das ist für ein erstes Gerät bereits die ganze Reise. Eine Emoji-Verifizierung gibt es hier nicht: Sie vergleicht zwei deiner Geräte, und du hast erst eins. Die Zeremonie tritt zum ersten Mal auf, wenn du dein zweites Gerät über Gerät hinzufügen koppelst.

Ebenfalls wissenswert: Das Einlösen eines frischen Provisionierungs-Bundles rotiert das Kontopasswort beim Verbinden. Die Bundle-Datei ist nach dem ersten Gebrauch verbraucht — die gültigen Zugangsdaten existieren dann nur auf diesem Gerät, und jedes weitere Gerät koppelt sich über Gerät hinzufügen an ein vorhandenes. Lösche die Bundle-Datei, sobald das erste Gerät verbunden ist; eine liegengebliebene Kopie kann sich nicht mehr anmelden, aber es gibt keinen Grund, sie zu behalten.

Bis zu diesem ersten Gebrauch behandle das Bundle wie ein Passwort: Es meldet sich am Sync-Konto an — halte es aus Chats, Screenshots und geteilten Bildschirmen heraus.

Unter Linux: anmelden ohne Bundle​

Die Voraussetzung oben hat eine Ausnahme. Unter Linux bietet Sync einrichten zusätzlich Stattdessen mit einem Matrix-Konto anmelden an, und die Karte für das erste Gerät auf der Seite mit dem Pairing-Code trägt dieselbe Option. Gib die Serveradresse, deine vollständige Matrix-ID (etwa @name:example.com) und das Kontopasswort ein — Lotti meldet sich an, erstellt den verschlüsselten Sync-Raum in diesem Konto selbst und landet auf demselben Bildschirm für das erste Gerät, auf dem auch der Bundle-Weg endet. Kein Admin, kein Werkzeug, kein Bundle — jedes Matrix-Konto, das du kontrollierst, reicht, auf deinem eigenen Homeserver oder einem öffentlichen.

Zwei Dinge sind wissenswert. Nimm ein Konto, das nur für Sync da ist, keins, mit dem du chattest: Der Sync-Raum ist einfach ein weiterer Raum in diesem Konto, und alles, was du schreibst, landet darin. Und dein Passwort gehört hier dir — es bleibt im sicheren Speicher dieses Geräts und wird nie rotiert, anders als beim Bundle oben. Nur der Server, den du eingibst, sieht es — und die Pairing-Codes, die du später unter Gerät hinzufügen erstellst: Sie enthalten es, behandle sie also als die Zugangsdaten, die sie sind. Jedes weitere Gerät koppelt sich weiterhin über Gerät hinzufügen an dieses an.