Verificare l’integrità di uno zip Knot Core

1. Recuperare lo SHA256 pubblicato

L’hash corrente è mostrato nella pagina Knot Core e nel manifesto:

curl -sS https://knot.tools/downloads/data/releases.json | jq -r '.latest.zip_sha256'

Oppure tramite le intestazioni HTTP al download:

curl -sI https://knot.tools/downloads/knot-core/latest | grep -i x-knot-sha256

2. Scaricare lo zip

curl -sSL -o knot-core.zip https://knot.tools/downloads/knot-core/latest

3. Confrontare in locale

macOS / Linux (BSD):

shasum -a 256 knot-core.zip

Linux (GNU):

sha256sum knot-core.zip

Il risultato deve corrispondere esattamente allo zip_sha256 pubblicato.

4. Firma Ed25519 (release ≥ 2.13.4)

Il manifesto include signature_hex e signature_payload. La firma copre il JSON canonico del payload (non il contenuto binario dello zip). Chiave pubblica fissata: rel-2026-04.

628d5479fee21f70088115ea3dba50264d404d5a82782d6d20c781d3d27e188e

Esempio PHP (estensione sodium):

$manifest = json_decode(file_get_contents('https://knot.tools/downloads/data/releases.json'), true);
$payload = $manifest['latest']['signature_payload'];
$sig = sodium_hex2bin($manifest['latest']['signature_hex']);
$pub = sodium_hex2bin('628d5479fee21f70088115ea3dba50264d404d5a82782d6d20c781d3d27e188e');
$sort = function (array &$a) use (&$sort): void {
    ksort($a);
    foreach ($a as &$v) {
        if (is_array($v)) {
            $sort($v);
        }
    }
};
$sort($payload);
$canonical = json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
var_export(sodium_crypto_sign_verify_detached($sig, $canonical, $pub));