Se connecter

tcc setup fait toute la première exécution en une seule commande : se connecter, enregistrer cet ordinateur comme appareil, mettre en place la clé qui déverrouille tes connexions, et télécharger ce dont il a besoin.

tcc setup

Il ouvre ton navigateur sur la page de connexion Trusted Codes, attend que tu termines là-bas, et continue de lui-même. Une fois terminé, il affiche ton code personnel, ce qui te confirme que ça a fonctionné.

Tu n’es pas obligé de lancer setup en premier. N’importe quelle commande qui a besoin d’un compte fera la même séquence avant de s’exécuter — le premier tcc code show sur une machine neuve te connecte, enregistre l’appareil et synchronise. setup existe pour que tu puisses le faire délibérément plutôt qu’au milieu d’autre chose.

Ce que fait la connexion

Le navigateur renvoie la session terminée vers un écouteur éphémère sur cette machine, sur l’adresse de boucle locale uniquement. Rien d’autre ne peut l’atteindre, et il s’arrête dès que la connexion est terminée.

Tes jetons sont conservés dans le trousseau du système d’exploitation, pas dans un fichier de ton répertoire personnel.

tcc auth status     # sommes-nous connectés, et en tant que qui
tcc auth login      # se connecter à nouveau
tcc auth logout     # effacer les jetons du trousseau

tcc auth token affiche le jeton d’accès actuel sur la sortie standard, pour le faire passer dans un autre outil. Traite-le comme un mot de passe.

Se connecter sur un serveur

Un serveur n’a pas de navigateur, donc tcc auth login ne peut pas en ouvrir un. Utilise plutôt le code du mail de connexion :

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

tcc demande au serveur d’envoyer le mail de connexion, puis te demande le code à six chiffres qu’il contient. Saisis le code à l’invite. Ce n’est jamais un argument de la ligne de commande, car les autres utilisateurs de la machine peuvent les lire.

Sur un serveur — le tcc construit sans l’application de bureau — une session dure au plus 12 heures à partir de la connexion. L’utilisation ne la prolonge pas. Ensuite le serveur y met fin, et chaque commande qui a besoin du compte s’arrête avec le code de sortie 77 et le dit :

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

Avec --json, le même refus est {"error":"CLI_SESSION_ENDED","reason":"cli_server_session_expired",…}. L’application de bureau et le tcc qui l’accompagne n’ont pas cette limite.

L’appareil

Se connecter ne suffit pas en soi. Tes secrets de connexion sont chiffrés de bout en bout, donc cet ordinateur a besoin de sa propre clé avant de pouvoir calculer quoi que ce soit.

tcc device status   # cet ordinateur est-il enregistré
tcc device register # l'enregistrer
tcc device list      # tous les appareils connectés à ce compte
tcc device remove <device-id>

tcc device list montre chaque appareil du compte, pas seulement celui-ci, et tcc device remove en déconnecte un — utilise-le quand tu n’as plus la machine.

Mots de récupération

Les mots de récupération permettent à un nouvel appareil d’accéder à des connexions qui existent déjà. Sans eux, une installation neuve peut se connecter mais ne peut rien lire.

Sur ton premier ou unique appareil, crée-les :

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

La langue peut être en, de, es, fr, it ou nl, et vaut en par défaut. Note les mots quelque part qui n’est pas cet ordinateur.

Sur un appareil ultérieur, saisis-les :

tcc device recover

tcc device regenerate-recovery émet un nouveau jeu de mots pour la même clé, pour le cas où tu penses que l’ancien jeu a été vu par quelqu’un d’autre.

Si setup s’arrête et t’indique que la clé existe mais que cet appareil n’y a pas accès, c’est le cas pour lequel tcc device recover existe.

Synchronisation

tcc sync            # télécharger les secrets de connexion, envoyer ceux qu'un pair n'a pas
tcc sync status      # quand elle a tourné pour la dernière fois, et combien est en cache
tcc sync clear        # effacer le cache local

Les commandes qui ont besoin de secrets se synchronisent d’elles-mêmes quand le cache a plus de cinq minutes, tu n’as donc rarement besoin d’appeler ceci. C’est utile juste après avoir accepté une invitation sur ton téléphone, quand tu ne veux pas attendre.

Changer de compte

tcc switch

Ceci efface la session en cours, l’enregistrement de l’appareil et tout le cache local, puis se connecte comme quelqu’un d’autre et met en place ce compte à partir de zéro. Ce n’est pas un basculement rapide entre deux comptes — la machine finit par ne détenir que les données d’un seul compte.

Se connecter comme un compte différent via tcc setup ou une commande ordinaire fait la même réinitialisation, et le dit avant de le faire.

Ton profil

tcc profile                       # l'afficher
tcc profile set-name "Ada Byron"
tcc profile set-language de

La langue définie ici est celle dans laquelle tes codes sont générés, sauf si une connexion ou un drapeau --lang en dit autrement.