Anmelden

tcc setup erledigt den gesamten ersten Lauf in einem Befehl: anmelden, diesen Rechner als Gerät registrieren, den Schlüssel einrichten, der deine Verbindungen freischaltet, und herunterladen, was nötig ist.

tcc setup

Es öffnet deinen Browser auf der Anmeldeseite von Trusted Codes, wartet, bis du dort fertig bist, und macht dann von selbst weiter. Ist es fertig, gibt es deinen persönlichen Code aus, woran du erkennst, dass es funktioniert hat.

Du musst setup nicht zuerst ausführen. Jeder Befehl, der ein Konto braucht, erledigt dieselbe Abfolge, bevor er läuft — der erste tcc code show auf einem frischen Rechner meldet dich an, registriert das Gerät und gleicht ab. setup gibt es, damit du das bewusst tust statt mittendrin in etwas anderem.

Was die Anmeldung tut

Der Browser sendet die fertige Sitzung an einen kurzlebigen Listener auf diesem Rechner zurück, nur auf der Loopback-Adresse. Nichts sonst kann ihn erreichen, und er stoppt, sobald die Anmeldung abgeschlossen ist.

Deine Token liegen im Schlüsselbund des Betriebssystems, nicht in einer Datei in deinem Home-Verzeichnis.

tcc auth status     # sind wir angemeldet, und als wer
tcc auth login       # erneut anmelden
tcc auth logout      # Token aus dem Schlüsselbund löschen

tcc auth token gibt das aktuelle Zugriffstoken auf der Standardausgabe aus, zum Weiterleiten in ein anderes Werkzeug. Behandle es wie ein Passwort.

Anmelden auf einem Server

Ein Server hat keinen Browser, also kann tcc auth login keinen öffnen. Nimm stattdessen den Code aus der Anmeldemail:

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

tcc lässt den Server die Anmeldemail senden und fragt dich dann nach dem sechsstelligen Code darin. Gib den Code bei der Abfrage ein. Er ist nie ein Argument auf der Befehlszeile, denn die können andere Benutzer des Rechners lesen.

Auf einem Server – dem tcc, das ohne die Desktop-App gebaut ist – hält eine Sitzung höchstens 12 Stunden ab der Anmeldung. Nutzung verlängert sie nicht. Danach beendet der Server sie, und jeder Befehl, der das Konto braucht, bricht mit dem Exit-Code 77 ab und sagt das:

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

Mit --json lautet dieselbe Ablehnung {"error":"CLI_SESSION_ENDED","reason":"cli_server_session_expired",…}. Die Desktop-App und das tcc, das mit ihr kommt, haben diese Grenze nicht.

Das Gerät

Die Anmeldung allein reicht nicht. Deine Verbindungsgeheimnisse sind Ende-zu-Ende-verschlüsselt, deshalb braucht dieser Rechner einen eigenen Schlüssel, bevor er irgendetwas berechnen kann.

tcc device status   # ist dieser Rechner registriert
tcc device register # ihn registrieren
tcc device list      # jedes bei diesem Konto angemeldete Gerät
tcc device remove <device-id>

tcc device list zeigt jedes Gerät auf dem Konto, nicht nur dieses, und tcc device remove meldet eines ab — nutze es, wenn du den Rechner nicht mehr hast.

Wiederherstellungswörter

Wiederherstellungswörter sind der Weg, auf dem ein neues Gerät Zugang zu bereits bestehenden Verbindungen bekommt. Ohne sie kann sich eine frische Installation zwar anmelden, aber nichts lesen.

Auf deinem ersten oder einzigen Gerät legst du sie an:

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

Die Sprache kann en, de, es, fr, it oder nl sein und ist in der Vorgabe en. Schreib die Wörter irgendwo auf, das nicht dieser Rechner ist.

Auf einem späteren Gerät gibst du sie ein:

tcc device recover

tcc device regenerate-recovery gibt einen neuen Satz Wörter für denselben Schlüssel aus, für den Fall, dass du denkst, der alte Satz sei jemandem anderen zu Gesicht gekommen.

Bricht setup ab und sagt dir, der Schlüssel existiere, aber dieses Gerät habe keinen Zugang dazu, ist genau das der Fall, für den tcc device recover gedacht ist.

Abgleichen

tcc sync            # Verbindungsgeheimnisse herunterladen, alle hochladen, die einem Peer fehlen
tcc sync status      # wann es zuletzt lief, und wie viel zwischengespeichert ist
tcc sync clear        # den lokalen Zwischenspeicher verwerfen

Befehle, die Geheimnisse brauchen, gleichen von selbst ab, wenn der Zwischenspeicher älter als fünf Minuten ist, deshalb musst du das selten selbst aufrufen. Es ist nützlich direkt nach dem Annehmen einer Einladung auf deinem Telefon, wenn du nicht warten willst.

Konto wechseln

tcc switch

Das löscht die aktuelle Sitzung, die Geräteregistrierung und den gesamten lokalen Zwischenspeicher, meldet dich dann als jemand anderes an und richtet dieses Konto von Grund auf ein. Es ist kein schneller Wechsel zwischen zwei Konten — der Rechner hält am Ende nur die Daten eines einzigen Kontos.

Meldest du dich über tcc setup oder einen gewöhnlichen Befehl als ein anderes Konto an, geschieht derselbe Reset, und der Befehl sagt es dir vorher.

Dein Profil

tcc profile                       # es anzeigen
tcc profile set-name "Ada Byron"
tcc profile set-language de

Die hier gesetzte Sprache ist die, in der deine Codes erzeugt werden, sofern eine Verbindung oder ein --lang-Flag nichts anderes vorgibt.