Il tuo primo dispositivo
Questa pagina richiede un homeserver Matrix (Synapse) gestito da te o da qualcuno di cui ti fidi, oltre all'accesso come amministratore. Se non ne hai uno, questo percorso non è disponibile per te — e nient'altro in Lotti dipende da esso.
Ogni dispositivo dopo il primo riceve il codice di associazione da un dispositivo che usi già — quel percorso è Aggiungi un dispositivo. Il primo è diverso: non c'è nessun altro dispositivo che possa generare un codice. La sincronizzazione di Lotti è self-hosted, quindi il primo codice arriva dal lato server — creato da chi gestisce il tuo homeserver Synapse.
Cosa fa lo strumento di provisioning
Lotti include una CLI di amministrazione, il provisioner Matrix, nel
repository in
tools/matrix_provisioner.
Eseguita da un admin dell'homeserver:
- crea un account Matrix nuovo dedicato alla sincronizzazione,
- crea la stanza di sincronizzazione cifrata, e
- scrive in un file un bundle di provisioning — il testo che Lotti accetta come codice di associazione.
Il README accanto allo strumento documenta la configurazione iniziale, ogni argomento e i modi sicuri di fornire la password admin. Un'esecuzione minima è così:
cd tools/matrix_provisioner
python provision.py \
--homeserver https://matrix.example.com \
--admin-user admin \
--username lotti_sync_user42 \
--output-file bundle.txt
Se non gestisci un homeserver tuo, questo passaggio non spetta a te — chiedi il bundle a chi opera il server, e tratta il percorso con cui ti arriva con la cura descritta sotto.
Usare il bundle come primo codice di associazione
Sul dispositivo che diventerà il tuo primo, apri Impostazioni → Impostazioni di sincronizzazione → Dispositivi e scegli Configura la sincronizzazione. Incolla il testo del bundle nel campo del codice — su un telefono, dove prima si apre la fotocamera, scegli Incolla invece il codice per arrivarci. Rivedi cosa descrive il codice e connettiti — per un primo dispositivo il percorso finisce qui. Non c'è verifica con le emoji: la verifica confronta due dei tuoi dispositivi, e ne hai uno solo. La cerimonia compare per la prima volta quando associ il secondo dispositivo con Aggiungi un dispositivo.
Vale anche la pena sapere: consumare un bundle di provisioning fresco ruota la password dell'account al momento della connessione. Il file del bundle è quindi esaurito dopo il primo uso — la credenziale viva esiste solo su quel dispositivo, e ogni dispositivo successivo si associa da uno esistente con Aggiungi un dispositivo. Elimina il file del bundle appena il primo dispositivo è connesso; una copia rimasta in giro non può più accedere, ma non c'è motivo di tenerla.
Fino a quel primo uso, tratta il bundle come una password: accede all'account di sincronizzazione — tienilo fuori da chat, screenshot e schermi condivisi.