Codes en verificatie

Je eigen codes

tcc code show

Toont je persoonlijke drie-woordencode en hoelang die geldig is. Voeg een verbindingsnaam toe om in plaats daarvan de code van die verbinding te krijgen — de naam wordt losjes gematcht, dus een deel ervan is al genoeg:

tcc code show mark
tcc code show mark --lang de

--lang overschrijft de taal voor die ene code. Zonder deze vlag gebruikt een verbinding de taal waarin de verbinding is aangemaakt, en gebruikt je persoonlijke code de taal uit je profiel.

tcc code list    # elke code die dit apparaat kan berekenen, in één tabel
tcc code next    # het huidige venster, en wanneer de volgende rotatie is

Codes worden op dit apparaat berekend uit geheimen die het al bezit. tcc code show vraagt geen server om de woorden, wat de reden is waarom het zelfs werkt zonder netwerk — mits het apparaat minstens één keer heeft gesynchroniseerd.

Drie woorden controleren

tcc verify amber cargo lantern

Dit controleert de drie woorden tegen de verbindingen die op dit apparaat zijn gecachet en vertelt je welke ervan matchte, of dat geen enkele dat deed — met het aantal verbindingen dat het kon controleren, zodat je “nee” kunt onderscheiden van “ik had er maar twee om naar te kijken”.

Het accepteert de huidige code en de vorige codes die de operator van je server nog accepteert — standaard één — en zegt welke overeenkwam. Een code die kort voor de wissel is gestuurd, komt dus nog overeen, gemarkeerd als vorige code, met de lokale tijd waarop die niet meer gold; vraag voor een bericht dat later wordt gelezen om een zegel. Bij een verbinding waarin elk lid een eigen code heeft, wordt elk lid gecontroleerd en noemt het antwoord dat lid. Je eigen code komt nooit overeen: die bewijst niets over wie de woorden stuurde.

De gewone vorm vraagt niets aan een server. Ze weet alleen wat dit apparaat bezit.

Ook de server vragen

tcc verify amber cargo lantern --public
tcc verify amber cargo lantern --public --country de

--public vraagt ook de openbare opzoeking, die dingen kan herkennen waarvan dit apparaat geen weet heeft — een baken, of een code die een provider heeft aangemaakt.

De twee antwoorden worden apart afgedrukt en nooit samengevoegd:

This device:
  No match among the 12 connections this device can check. 2 more cannot be checked here — sync, then try again.

The server:
  Match: ...

Die scheiding is met opzet. Een lokaal “geen match” betekent dat dit apparaat het niet kon vinden, niet dat de code vals is. Lees de twee regels als twee verschillende vragen.

--country is een hint voor de openbare opzoeking en neemt een landcode van twee letters. Ze geldt alleen samen met --public.

Een geslaagde openbare verificatie is ook wat je in staat stelt om iemand te gaan volgen — zie tcc trust follow in het commando-overzicht.

Zit iemand op Trusted Codes

tcc lookup someone@example.com

Beantwoordt of dat adres bij een account hoort, wat je wilt weten voordat je kiest tussen een uitnodiging en een gastcode.

Content verzegelen

Een zegel bewijst dat iets van jou afkomstig is.

tcc stamp text "Transfer approved by me"
tcc stamp clipboard

tcc stamp text neemt de content als argument en heeft de nuttigste vlaggen:

• --file <path> bindt een bestand aan het zegel. Het bestand wordt op deze machine gehasht en de hash is wat wordt verzegeld — het bestand zelf wordt nooit geüpload.
• --language <code> stelt de taal van de woorden in.
• --label <text> is de titel van het zegel. Die wordt met de tekst versleuteld en op het goedkeuringsscherm van de telefoon getoond.
• --require-approval houdt de handtekening vast totdat je ze op je telefoon goedkeurt.
• --ref <slug> verwijst naar een ander zegel, en mag herhaald worden.

De tekst, de titel en de bestandsnaam worden op deze machine versleuteld. Alleen wie de volledige link heeft, kan ze lezen. Onze server kan dat niet.

Er is geen e-mailoptie. Onze server heeft de tekst van een zegel nooit, dus kan hij er geen versturen: kopieer de link en stuur hem zelf. Met --require-approval wordt de tekst voor je account versleuteld voordat het verzoek deze machine verlaat, en alleen je telefoon opent het. tcc ask verzegelt niet: een zin die om een zegel vraagt, wordt geweigerd voordat er iets wordt verstuurd, en noemt in plaats daarvan tcc seal text "<text>" en tcc seal clipboard.

tcc stamp list           # wat je hebt verzegeld
tcc stamp export <id>    # een draagbaar bewijsdocument voor één zegel
tcc stamp revoke <id>    # er een intrekken

tcc stamp self maakt een zegel aan dat over jou gaat in plaats van over een bestand — “dit ben echt ik” — met een optionele --description die op de verificatiepagina wordt getoond, en een --language voor de woorden.

Zegels horen bij sommige plannen en niet bij andere, en het inhoudszegel en het zelfzegel zijn aparte mogelijkheden. Een commando waarvoor je geen recht hebt, zegt dat ook zo, in plaats van half te werken.