Tu primer dispositivo

Requisito previo

Esta página necesita un homeserver Matrix (Synapse) que gestiones tú o alguien de tu confianza, además de acceso de administración. Si no tienes uno, esta ruta no está disponible para ti, y nada más en Lotti depende de ella.

Cada dispositivo después del primero recibe su código de emparejamiento de un dispositivo que ya usas — ese recorrido es Añadir un dispositivo. El primero es distinto: no hay otro dispositivo que pueda generar un código. La sincronización de Lotti es autoalojada, así que el primer código viene del lado del servidor — lo crea quien administra tu homeserver de Synapse.

Qué hace la herramienta de aprovisionamiento

Lotti incluye una CLI de administración, el aprovisionador de Matrix, en el repositorio en tools/matrix_provisioner. Ejecutada por un admin del homeserver:

1. crea una cuenta de Matrix nueva dedicada a la sincronización,
2. crea la sala de sincronización cifrada, y
3. escribe en un archivo un bundle de aprovisionamiento — el texto que Lotti acepta como código de emparejamiento.

El README junto a la herramienta documenta la puesta en marcha inicial, cada argumento y las formas seguras de pasar la contraseña de admin. Una ejecución mínima se ve así:

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

Si no administras tu propio homeserver, este paso no te toca a ti — pide el bundle a la persona que opera el servidor, y trata el camino por el que te llega con el cuidado descrito abajo.

Usar el bundle como primer código de emparejamiento

En el dispositivo que será tu primero, abre Ajustes → Ajustes de sincronización → Dispositivos y elige Configurar sincronización. Pega el texto del bundle en el campo de código — en el móvil, donde primero se abre la cámara, elige Pegar el código en su lugar para llegar ahí. Revisa lo que describe el código y conecta — ese es ya todo el recorrido para un primer dispositivo. Aquí no hay verificación con emojis: la verificación compara dos de tus dispositivos, y solo tienes uno. La ceremonia aparece por primera vez al emparejar tu segundo dispositivo con Añadir un dispositivo.

También merece la pena saberlo: consumir un bundle de aprovisionamiento nuevo rota la contraseña de la cuenta al conectar. El archivo del bundle queda gastado tras su primer uso — la credencial viva existe entonces solo en ese dispositivo, y cada dispositivo siguiente se empareja desde uno existente con Añadir un dispositivo. Borra el archivo del bundle en cuanto el primer dispositivo esté conectado; una copia rezagada ya no puede iniciar sesión, pero no hay motivo para conservarla.

Hasta ese primer uso, trata el bundle como una contraseña: inicia sesión en la cuenta de sincronización — mantenlo fuera de chats, capturas de pantalla y pantallas compartidas.

En Linux: iniciar sesión sin bundle

El requisito de arriba tiene una excepción. En Linux, Configurar la sincronización ofrece también Iniciar sesión con una cuenta de Matrix en su lugar, y la tarjeta del primer dispositivo en la página del código de emparejamiento lleva la misma opción. Introduce la dirección del servidor, tu ID de Matrix completo (como @nombre:example.com) y la contraseña de la cuenta: Lotti inicia sesión, crea por sí mismo la sala de sincronización cifrada en esa cuenta y aterriza en la misma pantalla de primer dispositivo en la que termina el camino del bundle. Sin administrador, sin herramienta, sin bundle — sirve cualquier cuenta de Matrix que controles, en tu propio servidor o en uno público.

Dos cosas que conviene saber. Usa una cuenta reservada para sincronizar, no una con la que chatees: la sala de sincronización es solo otra sala más de esa cuenta, y todo lo que escribas va a parar ahí. Y aquí la contraseña es tuya: se queda en el almacenamiento seguro de este dispositivo y nunca se rota, a diferencia del bundle de arriba. Solo la ve el servidor que indiques, además de los códigos de emparejamiento que crees después en Añadir un dispositivo: la llevan dentro, así que trátalos como las credenciales que son. Cada dispositivo posterior sigue emparejándose desde este con Añadir un dispositivo.