Kolaboro / Controleren / Offline controle
Offline controle
Eén bestand, in Python (alleen standaardbibliotheek) of Node, dat onze dagelijkse hashketen, Ed25519-handtekeningen, projectcertificaten en buildverklaringen controleert met alleen bestanden die je hebt opgeslagen. Geen netwerk nodig.
Bijgewerkt op 19 nov 2026
Download het script, sla de bestanden op die je wilt controleren (bijvoorbeeld met curl) en draai het, als je wilt, op een computer zonder netwerk. De publieke sleutel staat in het script en op /.well-known/kolaboro-keys.json; vergelijk ze één keer.
Beide versies doen dezelfde controles en geven dezelfde antwoorden. Exitcode 0 betekent dat alles is geslaagd.
Download
- /open/kolaboro_offline_verify.py Python 3.8+, stdlib only
- /open/kolaboro-offline-verify.mjs Node 18+, no packages
Zo gebruik je het
Snapshotketen: elke kop van de dagelijkse hashketen opnieuw berekenen, en de SHA-256 van elke opgeslagen kopie (.gz-kopieën worden uitgepakt).
curl -O https://kolaboro.com/data/snapshots/index.json
curl -O https://kolaboro.com/data/snapshots/2026-11-17/named.json.gz
python3 kolaboro_offline_verify.py chain index.json named.json.gzProjectcertificaat: canonieke JSON, de hash van de feiten en de Ed25519-handtekening.
curl -o cert.json https://kolaboro.com/api/v1/projects/amani-melasti/certificate
python3 kolaboro_offline_verify.py cert cert.jsonElk ondertekend API-antwoord: sla de inhoud en de header x-kolaboro-signature op.
curl -s -D h.txt -o body.json https://kolaboro.com/api/v1/snapshots
node kolaboro-offline-verify.mjs sig body.json "$(grep -i '^x-kolaboro-signature:' h.txt | cut -d' ' -f2 | tr -d '\r')"Buildverklaring: het ondertekende bewijs van welke commit en welke data de site serveerde.
curl -o prov.json https://kolaboro.com/api/v1/provenance
python3 kolaboro_offline_verify.py provenance prov.jsonZelftest: ingebouwde testvectoren, waaronder een handtekening die moet falen.
python3 kolaboro_offline_verify.py selftestWat het controleert
- Elke kop is de SHA-256 van "kolaboro-snapshot-v1|dag|/data/named.json|sha256|bytes|vorige kop", beginnend bij "genesis"; één gewijzigde byte breekt elke latere kop.
- Een opgeslagen kopie klopt met de SHA-256 en grootte van zijn dag.
- Ed25519-handtekeningen over "kolaboro-sig-v1\n" + de SHA-256 in hex van de exacte bytes (RFC 8032; het Python-bestand heeft een eigen implementatie, Node gebruikt zijn ingebouwde crypto).
- Certificaten en verklaringen: sleutels gesorteerd, zonder spaties, dan dezelfde handtekeningregel; bij certificaten ook de hash van de feiten.
/data/snapshots/ · /verify/ · kolaboro-keys.json