工程 · TourCheck
一本自己簽名的日誌
巡邏記錄只有在起爭議時才有價值:保險理賠、事件複盤、「證明夜間巡邏真的發生過」。如果資料庫是唯一的證據,那誰能改資料庫,誰就決定了發生了什麼。TourCheck 的回答是一本日誌:它不讓竄改變得不可能,而是讓竄改可見。
只寫一次,環環相鏈
每個事件:一次檢查點掃碼、一次巡邏開始、一起事故:只寫一次,永不更新。更正是新列,不是編輯。在這些列之上是一條雜湊鏈日誌:每筆記錄帶著一個雜湊,把自己綁定到上一筆記錄以及它所引用列的承載上:區塊鏈就是這麼做的,只是去掉了一切讓區塊鏈令人難受的部分。改寫歷史意味著把它之後的每筆記錄全部重算:而鏈頭存放在驗證者會注意到的地方。
重點不是竄改不可能;在一台自託管的機器上,沒有什麼是不可能的。重點是竄改會留下指紋。驗證會重算每個被引用列的承載雜湊:被有意抹掉的列驗證為 TOMBSTONED:故意的、可見的:而其他任何不一致驗證為 TAMPERED。「資料庫這麼說」變成「資料庫能證明」。
讓它站得住的規則
一輪紅隊演練把模糊的承諾變成了被強制執行的不變式:而最有意思的,是那些最無聊的:
- 巡邏狀態只有一個寫入者。只有一條程式碼路徑可以變更巡邏的狀態,在一個交易裡,而且每次變更都產生一筆註明誰關閉它的日誌記錄。控制器裡散落的一條 UPDATE 沒法悄悄改寫結果。
- 來源由伺服器裁決。事件的方式和站點範圍在伺服器端從綁定和成員關係解出。用戶端的聲明是驗證的輸入,從不原樣落庫:所以構造出來的請求沒法把自己的掃碼記到它不屬於的站點名下。
- 重送比對的是聲明,不只是 id。重複的用戶端事件 id 會和已存的承載雜湊、綁定備註、照片和時間戳逐項比對:一筆與原件不符的重送是不匹配,不是去重。
- 探測是有代價的。未知成員的嘗試消耗的是站點的鎖定計數器,所以探測不能被用來枚舉哪些成員存在:除非連被探測的東西一起鎖掉。
- 永遠一個鎖順序。先取巡邏列,再取鏈頭:絕不反過來。它存在是為了讓事件攝入和巡邏關閉不會互相鎖死;並行下的正確性也是一種完整性屬性。
證據住在存取即策略的地方
照片和產生的報告不進使用者可見的 Files 資料夾:它們住在 appdata 下,用應用程式管理的 id,授權按站點角色判定。這直接消滅了整整一類 bug:檔案權限免費附贈的「別的檢視者拿到 404,或者更糟,200」問題。按日錨定連無聊的情況也處理了:空鏈也產生一個有效錨點,所以「上週二什麼都沒發生」本身就是一句可證明的陳述。
這一切都不需要您信任我們。鏈驗證是您可以執行的程式碼,威脅模型寫在決策記錄裡,而 AGPL 意味著勞資會議、稽核師或一位多疑的管理員都能核實這本日誌是否做了這篇文章所說的事。無法被檢視的簽名功能不算簽名:只是裝飾。