Engineering · TourCheck
Un registro che si firma da solo
Un registro delle ronde vale solo nella controversia, la richiesta di risarcimento, la revisione dell'incidente, il «dimostrate che il giro di notte è avvenuto». Se il database è l'unica prova, chi può modificare il database decide cosa è successo. La risposta di TourCheck è un giornale che rende visibile la manomissione invece che impossibile.
Si scrive una volta, si concatena tutto
Ogni evento, una scansione dei punti di controllo, l'inizio di una ronda, un incidente, si scrive una volta e non si aggiorna mai. Le correzioni sono righe nuove, non modifiche. Sopra quelle righe sta un giornale a catena di hash: ogni voce porta un hash che la lega alla voce precedente e al payload della riga a cui si riferisce, come fa una blockchain meno tutto ciò che rende una blockchain insopportabile. Riscrivere la storia significa ricalcolare ogni voce successiva, e la testa della catena è conservata dove un verificatore se ne accorge.
Il punto non è che manomettere sia impossibile. Niente lo è su una macchina self-hosted. Il punto è che manomettere lascia impronte. La verifica ricalcola l'hash del payload di ogni riga referenziata: una riga cancellata di proposito verifica come TOMBSTONEDcodeTAMPERED, intenzionale, visibile, mentre qualunque altra cosa incoerente verifica come code. «Lo dice il database» diventa «il database può provarlo».
Le regole che lo tengono in piedi
Un passaggio di red team ha trasformato la vaga promessa in invarianti applicati, e quelli interessanti sono quelli noiosi:
- Un solo scrittore per lo stato della ronda. Un solo percorso di codice può far transitare lo stato di una ronda, dentro una transazione, e ogni transizione produce una voce di giornale che nomina chi l'ha chiusa. Nessuna UPDATE vagante in un controller può riscrivere in silenzio un esito.
- Il server decide la provenienza. Metodo e scope di sito di un evento sono risolti lato server da binding e appartenenza. Le affermazioni del client sono input di validazione, mai memorizzate alla lettera, così una richiesta costruita ad arte non può attribuire la sua scansione a una postazione a cui non appartiene.
- Il replay confronta le affermazioni, non solo gli id. Un id evento client ripetuto è controllato contro l'hash del payload memorizzato, la nota di binding, la foto e il timestamp, un replay che non concorda con l'originale è un mismatch, non un dedupe.
- Le sonde costano all'attaccante. I tentativi con membri sconosciuti bruciano il contatore di lockout della postazione, quindi sondare non serve a enumerare quali membri esistono senza bloccare anche la cosa sondata.
- Un solo ordine di lock, sempre. Prima la riga della ronda, poi la testa della catena, mai invertito. Esiste perché ingest degli eventi e chiusura della ronda non possano deadlockarsi a vicenda. La correttezza sotto concorrenza è anche una proprietà di integrità.
Le prove vivono dove l'accesso è una policy
Foto e report generati non vanno nelle cartelle Files visibili agli utenti, vivono in appdata con id gestiti dall'app, con l'autorizzazione decisa dal ruolo sul sito. Questo uccide un'intera classe di bug: il problema «gli altri visualizzatori prendono un 404 o, peggio, un 200» che arriva gratis con i permessi sui file. L'ancoraggio a livello di giorno copre anche il caso noioso: una catena vuota produce comunque un'ancora valida, così «martedì scorso non è successo niente» è esso stesso un'affermazione dimostrabile.
Niente di tutto questo richiede di fidarsi di noi. La verifica della catena è codice che potete eseguire, il threat model è scritto nei decision record, e l'AGPL significa che una rappresentanza dei lavoratori, un revisore o un admin scettico possono controllare che il registro faccia quello che questo post dice. Funzioni di firma che non si possono ispezionare non sono firme, sono decorazioni.