Hvad en provenance-fil garanterer

Du har hentet et chart fra internettet. Hvordan ved du, at ingen har ændret det undervejs? Helm besvarer dette med en proveniensfil.

En proveniensfil ligger ved siden af et chartarkiv med samme navn plus suffikset .prov. Den er chartets signerede ægthedsbevis.

En proveniensfil beviser to ting: integritet, altså at bytes ikke er blevet ændret, og oprindelse, altså at en bestemt nøgle har signeret den.

.prov-filen gemmer en SHA-256-digest af chartarkivet. Hvis blot én byte ændres, vil den genberegnede hash ikke stemme overens, og kontrollen mislykkes.

Filen er indpakket i en PGP-signatur, der er lavet med udgiverens private nøgle. Kun den tilsvarende offentlige nøgle kan validere den.

Den signerede blok kopierer også chartets metadata, f.eks. navn og version. Det knytter signaturen præcist til dette chart og ikke til et chart med et nyt navn.

En .prov-fil er en menneskeligt læsbar, klartekstsigneret PGP-meddelelse. Du kan åbne den og se metadata og hasher indpakket mellem signaturmarkører.

Proveniens beviser, hvem der signerede, og at bytes er intakte. Den vurderer ikke, om chartet er sikkert eller fejlfrit, men kun om det er ægte.

En signatur har kun betydning, hvis du stoler på underskriveren. Du skal allerede have udgiverens offentlige nøgle i din nøglering for at kunne kontrollere den.

Helms klassiske proveniensfunktion bruger standarden OpenPGP. Det betyder, at almindelige GPG-værktøjer opretter og undersøger nøglerne bag disse signaturer.

Et chart-repositorys indeks kan angive en provenienshash sammen med chartet, så klienter automatisk kan hente og kontrollere .prov-filen.

En .prov-fil knytter et chart sammen med en signeret hashværdi og beviser, at byteværdierne er intakte, og at en betroet nøgle har signeret dem. Det dokumenterer ægthed, ikke sikkerhed. 🔏