Ingénierie · TourCheck
Un journal de ronde qui se signe lui-même
Un journal de ronde ne vaut quelque chose qu'au moment du litige, la demande d'assurance, l'analyse d'incident, le « prouvez que la ronde de nuit a eu lieu ». Si la base de données est la seule preuve, quiconque peut modifier la base décide de ce qui s'est passé. La réponse de TourCheck est un journal qui rend la falsification visible plutôt qu'impossible.
Écrire une fois, tout chaîner
Chaque événement, le scan d'un point de contrôle, le début d'une ronde, un incident, est écrit une fois et jamais modifié. Les corrections sont de nouvelles lignes, pas des éditions. Au-dessus de ces lignes se trouve un journal chaîné par hachage: chaque entrée porte un hash qui la lie à l'entrée précédente et à la charge de la ligne qu'elle référence, à la manière d'une blockchain moins tout ce qui rend une blockchain insupportable. Réécrire l'histoire, c'est recalculer chaque entrée qui suit, et la tête de chaîne est stockée là où un vérificateur la remarque.
L'objectif n'est pas que la falsification soit impossible. Rien ne l'est sur une machine auto-hébergée. L'objectif est qu'elle laisse des empreintes. La vérification recalcule le hash de charge de chaque ligne référencée: une ligne effacée volontairement se vérifie comme TOMBSTONED, intentionnel, visible, tandis que toute autre incohérence se vérifie comme TAMPERED. « La base le dit » devient « la base peut le prouver ».
Les règles qui le font tenir
Un passage d'équipe rouge a transformé la vague promesse en invariants appliqués, et les intéressants sont les ennuyeux:
- Un seul rédacteur pour le statut de ronde. Un seul chemin de code peut faire basculer le statut d'une ronde, dans une transaction, et chaque transition produit une entrée de journal nommant qui l'a clôturée. Aucun UPDATE perdu dans un contrôleur ne peut réécrire silencieusement un résultat.
- Le serveur décide de la provenance. La méthode et la portée de site d'un événement sont résolues côté serveur à partir de l'affectation et de l'appartenance. Les déclarations du client sont des entrées de validation, jamais stockées telles quelles, une requête forgée ne peut pas attribuer son scan à une station qui n'est pas la sienne.
- Le rejeu compare les déclarations, pas seulement les ids. Un id d'événement client répété est confronté au hash de charge stocké, à la note liante, à la photo et à l'horodatage, un rejeu en désaccord avec l'original est une incohérence, pas une déduplication.
- Les sondes coûtent à l'attaquant. Les tentatives avec membre inconnu consomment le compteur de verrouillage de la station, si bien que le sondage ne peut pas servir à énumérer les membres existants sans aussi verrouiller ce qui est sondé.
- Un seul ordre de verrouillage, toujours. La ligne de ronde d'abord, puis la tête de chaîne, jamais l'inverse. Il existe pour que l'ingestion d'événements et la clôture de ronde ne puissent pas se bloquer mutuellement. L'exactitude sous concurrence est aussi une propriété d'intégrité.
Les preuves vivent là où l'accès est une politique
Les photos et les rapports générés ne vont pas dans des dossiers Files visibles par l'utilisateur, ils vivent dans appdata sous des identifiants gérés par l'app, l'autorisation étant décidée par le rôle sur le site. Cela tue toute une classe de bogue: le problème « les autres lecteurs reçoivent un 404 ou, pire, un 200 » offert par les permissions de fichiers. L'ancrage au niveau du jour gère aussi le cas ennuyeux: une chaîne vide produit quand même une ancre valide, donc « rien ne s'est passé mardi dernier » est lui-même une affirmation prouvable.
Rien de tout cela n'exige de nous faire confiance. La vérification de chaîne est du code que vous pouvez exécuter, le modèle de menace est écrit dans les dossiers de décision, et l'AGPL signifie qu'un comité d'entreprise, un auditeur ou un admin sceptique peut vérifier que le journal fait ce que ce billet affirme. Les fonctionnalités de signature qu'on ne peut pas inspecter ne sont pas des signatures, ce sont des décorations.