Aanmelden

tcc setup doet de hele eerste run in één commando: aanmelden, deze computer als apparaat registreren, de sleutel instellen die je verbindingen ontgrendelt, en downloaden wat nodig is.

tcc setup

Het opent je browser op de aanmeldpagina van Trusted Codes, wacht tot je daar klaar bent, en gaat dan zelf verder. Is het klaar, dan toont het je persoonlijke code, wat je vertelt dat het werkte.

Je hoeft setup niet eerst uit te voeren. Elk commando dat een account nodig heeft, doorloopt dezelfde stappen voordat het draait — de eerste tcc code show op een verse machine meldt je aan, registreert het apparaat en synchroniseert. setup bestaat zodat je dat bewust kunt doen in plaats van midden in iets anders.

Wat aanmelden doet

De browser stuurt de afgeronde sessie terug naar een kortstondige listener op deze machine, alleen op het loopback-adres. Niets anders kan hem bereiken, en hij stopt zodra de aanmelding voltooid is.

Je tokens worden bewaard in de sleutelhanger van het besturingssysteem, niet in een bestand in je home-map.

tcc auth status     # zijn we aangemeld, en als wie
tcc auth login      # opnieuw aanmelden
tcc auth logout     # de tokens uit de sleutelhanger wissen

tcc auth token drukt het huidige toegangstoken af naar standaarduitvoer, om naar een andere tool door te sluizen. Behandel het als een wachtwoord.

Aanmelden op een server

Een server heeft geen browser, dus tcc auth login kan er geen openen. Gebruik in plaats daarvan de code uit de aanmeldmail:

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

tcc laat de server de aanmeldmail sturen en vraagt je daarna om de code van zes cijfers erin. Typ de code bij de vraag. Het is nooit een argument op de opdrachtregel, want die kunnen andere gebruikers van de machine lezen.

Op een server — de tcc die zonder de desktop-app is gebouwd — duurt een sessie hoogstens 12 uur vanaf het aanmelden. Gebruik maakt haar niet langer. Daarna beëindigt de server haar, en elke opdracht die het account nodig heeft stopt met exitcode 77 en zegt dat:

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

Met --json is dezelfde weigering {"error":"CLI_SESSION_ENDED","reason":"cli_server_session_expired",…}. De desktop-app en de tcc die erbij hoort hebben deze grens niet.

Het apparaat

Aanmelden alleen is niet genoeg. Je verbindingsgeheimen zijn end-to-end versleuteld, dus deze computer heeft een eigen sleutel nodig voordat hij iets kan berekenen.

tcc device status   # is deze computer geregistreerd
tcc device register # registreer hem
tcc device list     # elk apparaat dat bij dit account is aangemeld
tcc device remove <device-id>

tcc device list toont elk apparaat op het account, niet alleen dit ene, en tcc device remove meldt er een af — gebruik dit wanneer je de machine niet meer hebt.

Herstelwoorden

Herstelwoorden zijn hoe een nieuw apparaat toegang krijgt tot verbindingen die al bestaan. Zonder ze kan een verse installatie zich wel aanmelden, maar niets lezen.

Maak ze aan op je eerste of enige apparaat:

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

De taal mag en, de, es, fr, it of nl zijn, en staat standaard op en. Schrijf de woorden ergens op dat niet deze computer is.

Voer ze op een later apparaat in:

tcc device recover

tcc device regenerate-recovery geeft een nieuwe set woorden uit voor dezelfde sleutel, voor wanneer je denkt dat de oude set door iemand anders is gezien.

Stopt setup en vertelt het je dat de sleutel bestaat maar dit apparaat er geen toegang toe heeft, dan is dat het geval waarvoor tcc device recover bedoeld is.

Synchroniseren

tcc sync            # verbindingsgeheimen downloaden, uploaden wat een peer nog mist
tcc sync status     # wanneer het laatst draaide, en hoeveel er gecachet is
tcc sync clear      # de lokale cache weggooien

Commando’s die geheimen nodig hebben, synchroniseren vanzelf wanneer de cache ouder is dan vijf minuten, dus je hoeft dit zelden aan te roepen. Het is nuttig direct na het accepteren van een uitnodiging op je telefoon, wanneer je niet wilt wachten.

Wisselen van account

tcc switch

Dit wist de huidige sessie, de apparaatregistratie en de hele lokale cache, meldt je daarna aan als iemand anders en stelt dat account vanaf nul in. Het is geen snelle schakelaar tussen twee accounts — de machine houdt uiteindelijk de gegevens van maar één account over.

Aanmelden als een ander account via tcc setup of een gewoon commando doet dezelfde reset, en zegt dat voordat het gebeurt.

Je profiel

tcc profile                       # toon het
tcc profile set-name "Ada Byron"
tcc profile set-language de

De taal die hier wordt ingesteld, is de taal waarin je codes worden gegenereerd, tenzij een verbinding of een --lang-vlag iets anders zegt.