Iniciar sesión

tcc setup hace toda la primera ejecución en un solo comando: iniciar sesión, registrar este ordenador como dispositivo, configurar la clave que desbloquea tus conexiones, y descargar lo que necesita.

tcc setup

Abre tu navegador en la página de inicio de sesión de Trusted Codes, espera a que termines ahí, y continúa por su cuenta. Cuando termina, imprime tu código personal, que es cómo sabes que ha funcionado.

No tienes que ejecutar setup primero. Cualquier comando que necesite una cuenta hará la misma secuencia antes de ejecutarse — el primer tcc code show en una máquina nueva te inicia sesión, registra el dispositivo y sincroniza. setup existe para que puedas hacer eso de forma deliberada en lugar de en medio de otra cosa.

Qué hace el inicio de sesión

El navegador envía la sesión terminada a un receptor de corta vida en este ordenador, solo en la dirección de loopback. Nada más puede alcanzarlo, y se detiene en cuanto termina el inicio de sesión.

Tus tokens se guardan en el llavero del sistema operativo, no en un archivo de tu carpeta personal.

tcc auth status     # ¿hemos iniciado sesión, y como quién?
tcc auth login      # iniciar sesión de nuevo
tcc auth logout     # borrar los tokens del llavero

tcc auth token imprime el token de acceso actual por salida estándar, para encauzarlo a otra herramienta. Trátalo como una contraseña.

Iniciar sesión en un servidor

Un servidor no tiene navegador, así que tcc auth login no puede abrir uno. Usa en su lugar el código del correo de inicio de sesión:

tcc auth login --code --email tu@example.com

tcc pide al servidor que envíe el correo de inicio de sesión y después te pide el código de seis cifras que contiene. Escribe el código cuando te lo pida. Nunca es un argumento de la línea de órdenes, porque otros usuarios de la máquina pueden leerlos.

En un servidor —el tcc compilado sin la aplicación de escritorio— una sesión dura como máximo 12 horas desde el inicio de sesión. Usarla no la alarga. Después el servidor la termina, y cada orden que necesita la cuenta se detiene con el código de salida 77 y lo dice:

Signed out: a server session lasts at most 12 hours. Sign in again with: tcc auth login --code

Con --json el mismo rechazo es {"error":"CLI_SESSION_ENDED","reason":"cli_server_session_expired",…}. La aplicación de escritorio y el tcc que viene con ella no tienen este límite.

El dispositivo

Iniciar sesión no basta por sí solo. Los secretos de tus conexiones están cifrados de extremo a extremo, así que este ordenador necesita su propia clave antes de poder calcular nada.

tcc device status   # ¿está registrado este ordenador?
tcc device register # registrarlo
tcc device list      # todos los dispositivos con sesión en esta cuenta
tcc device remove <device-id>

tcc device list muestra todos los dispositivos de la cuenta, no solo este, y tcc device remove cierra la sesión de uno — úsalo cuando ya no tengas el ordenador.

Palabras de recuperación

Las palabras de recuperación son cómo un dispositivo nuevo consigue acceso a conexiones que ya existen. Sin ellas, una instalación nueva puede iniciar sesión pero no puede leer nada.

En tu primer o único dispositivo, créalas:

tcc device setup-recovery
tcc device setup-recovery --lang de

El idioma puede ser en, de, es, fr, it o nl, y por defecto es en. Anota las palabras en algún sitio que no sea este ordenador.

En un dispositivo posterior, introdúcelas:

tcc device recover

tcc device regenerate-recovery emite un juego de palabras nuevo para la misma clave, para cuando creas que alguien más ha visto el juego anterior.

Si setup se detiene y te dice que la clave existe pero este dispositivo no tiene acceso a ella, ese es el caso para el que existe tcc device recover.

Sincronizar

tcc sync            # descargar secretos de conexión, subir los que le falten a un par
tcc sync status     # cuándo se ejecutó por última vez, y cuánto hay en caché
tcc sync clear      # descartar la caché local

Los comandos que necesitan secretos sincronizan por su cuenta cuando la caché tiene más de cinco minutos, así que casi nunca hace falta llamar a esto. Es útil justo después de aceptar una invitación en tu teléfono, cuando no quieres esperar.

Cambiar de cuenta

tcc switch

Esto borra la sesión actual, el registro del dispositivo y toda la caché local, y luego inicia sesión como otra persona y configura esa cuenta desde cero. No es un cambio rápido entre dos cuentas — el ordenador termina guardando los datos de una sola cuenta.

Iniciar sesión como una cuenta distinta a través de tcc setup o un comando normal hace el mismo restablecimiento, y lo avisa antes de hacerlo.

Tu perfil

tcc profile                       # mostrarlo
tcc profile set-name "Ada Byron"
tcc profile set-language de

El idioma fijado aquí es en el que se generan tus códigos a menos que una conexión o un indicador --lang diga otra cosa.