Accedere

tcc setup fa tutto il primo avvio in un unico comando: accedere, registrare questo computer come dispositivo, impostare la chiave che sblocca le tue connessioni, e scaricare ciò di cui ha bisogno.

tcc setup

Apre il tuo browser sulla pagina di accesso di Trusted Codes, aspetta che tu finisca lì, e continua da solo. Quando ha finito stampa il tuo codice personale, che è come sai che ha funzionato.

Non devi eseguire prima setup. Qualsiasi comando che ha bisogno di un account farà la stessa sequenza prima di girare — il primo tcc code show su una macchina nuova ti fa accedere, registra il dispositivo e sincronizza. setup esiste così puoi farlo deliberatamente invece che nel mezzo di qualcos’altro.

Che cosa fa l’accesso

Il browser rimanda la sessione conclusa a un listener a breve vita su questa macchina, solo sull’indirizzo di loopback. Nient’altro può raggiungerlo, e si ferma non appena l’accesso è completo.

I tuoi token sono conservati nel portachiavi del sistema operativo, non in un file nella tua home directory.

tcc auth status     # abbiamo effettuato l'accesso, e come chi
tcc auth login      # accedi di nuovo
tcc auth logout     # cancella i token dal portachiavi

tcc auth token stampa il token di accesso attuale sullo standard output, per incanalarlo in un altro strumento. Trattalo come una password.

Accedere su un server

Un server non ha un browser, quindi tcc auth login non può aprirne uno. Usa invece il codice della mail di accesso:

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

tcc chiede al server di inviare la mail di accesso, poi ti chiede il codice di sei cifre che contiene. Scrivi il codice quando viene richiesto. Non è mai un argomento della riga di comando, perché gli altri utenti della macchina possono leggerli.

Su un server — il tcc compilato senza l’applicazione desktop — una sessione dura al massimo 12 ore dall’accesso. L’uso non la allunga. Dopo, il server la chiude, e ogni comando che ha bisogno dell’account si ferma con il codice di uscita 77 e lo dice:

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

Con --json lo stesso rifiuto è {"error":"CLI_SESSION_ENDED","reason":"cli_server_session_expired",…}. L’applicazione desktop e il tcc che la accompagna non hanno questo limite.

Il dispositivo

Accedere non basta da solo. I segreti delle tue connessioni sono cifrati end-to-end, quindi questo computer ha bisogno di una propria chiave prima di poter calcolare qualsiasi cosa.

tcc device status   # questo computer è registrato
tcc device register # registralo
tcc device list      # ogni dispositivo con accesso effettuato su questo account
tcc device remove <device-id>

tcc device list mostra ogni dispositivo sull’account, non solo questo, e tcc device remove disconnette uno — usalo quando non hai più quella macchina.

Parole di recupero

Le parole di recupero sono come un dispositivo nuovo ottiene accesso a connessioni che già esistono. Senza di esse, un’installazione appena fatta può accedere ma non può leggere nulla.

Sul tuo primo o unico dispositivo, creale:

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

La lingua può essere en, de, es, fr, it o nl, e per impostazione predefinita è en. Scrivi le parole da qualche parte che non sia questo computer.

Su un dispositivo successivo, inseriscile:

tcc device recover

tcc device regenerate-recovery emette un nuovo insieme di parole per la stessa chiave, per quando pensi che il vecchio insieme sia stato visto da qualcun altro.

Se setup si ferma e ti dice che la chiave esiste ma questo dispositivo non ha accesso a essa, è il caso per cui esiste tcc device recover.

Sincronizzazione

tcc sync            # scarica i segreti delle connessioni, carica quelli che manca a un pari
tcc sync status     # quando è girata l'ultima volta, e quanto è in cache
tcc sync clear      # scarta la cache locale

I comandi che hanno bisogno di segreti si sincronizzano da soli quando la cache è più vecchia di cinque minuti, quindi raramente devi chiamare questo. È utile subito dopo aver accettato un invito sul tuo telefono, quando non vuoi aspettare.

Cambiare account

tcc switch

Questo cancella la sessione attuale, la registrazione del dispositivo e l’intera cache locale, poi accede come qualcun altro e imposta quell’account da zero. Non è un cambio rapido tra due account — la macchina finisce per detenere solo i dati di un account.

Accedere come account diverso tramite tcc setup o un comando ordinario fa lo stesso reset, e lo dice prima di farlo.

Il tuo profilo

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

La lingua impostata qui è quella in cui vengono generati i tuoi codici a meno che una connessione o un flag --lang non dica diversamente.