Utvecklare · Protokoll & integration

Ett JSON-underlag. Data som kan verifieras oberoende.

ExtraProof underlag är portabla JSON-filer. Det dokumenterade formatet humanproof/1 kombinerar Ed25519-signaturer, en SHA-256-händelsekedja och en valfri filbindning. Verifieraren i webbläsaren kontrollerar dessa data lokalt.

Exakta byte, entydiga regler.

Signaturen avser de lagrade payload-byten. Varje händelse innehåller sekvensnummer, föregående hash och egen hash. Verifierare kontrollerar de ursprungliga byten i stället för en nyserialiserad JSON-representation.

Validera formatversion och algoritm uttryckligen.
Avvisa dubbla JSON-nycklar och osäkra talrepresentationer.
Kontrollera resursgränser, ordningsföljd och slutlig hash.

Hantera tre resultat separat.

integrityValid beskriver den kryptografiska kontrollen. signerTrusted visar jämförelsen med ett separat känt nyckelfingeravtryck. fileStatus beskriver filbindningen och den begärda jämförelsen. En giltig självsignatur fastställer inte en organisationsidentitet.

localObservation anger kontrollens omfattning.

humanproof/1 accepterar signerade lokala observationer. sealedObservation tillför registreringskontext utan att hävda en tekniskt låst miljö. Lokala tidsuppgifter kommer från registreraren. Återkallelser, externa tidsintyg och verksamhetens regler ligger utanför webbläsarkontrollen.

Anslut till er process.

Använd ett underlag som ett separat underlag till dokumentet och håll samman verifieringsresultat och regelversion i det anropande systemet. För API-, SDK- och organisationsintegrationer går vi igenom formatöverföring, feltillstånd, tillitsankare och driftansvar utifrån ert användningsfall.

PDF som behållare för ett underlag.

Det exporterade PDF-underlaget innehåller humanproof-certificate.json. Webbläsaren accepterar den avsedda, entydigt indexerade bilagan, kontrollerar dess SHA-256 och tillämpar sedan underlagets formatregler. Resultatet får inte beskrivas som en verifiering av synligt PDF-innehåll eller PDF-/CMS-signaturen. Lokala verifieringsrapporter som text eller JSON är osignerade resultat från en kontroll.

Protokoll v1

Exakta byte.
Separata resultat.

Webbverifieraren accepterar endast profilen localObservation. Det versionshanterade protokollet anger vilka data verifieringen accepterar.

schemaVersion: humanproof/1
algorithm: Ed25519
assurance: localObservation
payload.assurance.achieved: null | 1..5
assuranceClaimValid: null | true | false

integrityValid: true | false
signerTrusted: true | false
fileStatus: matched | mismatched
            notChecked | notBound

Ladda ner protokollet
Ladda ner en syntetisk testrecord
Ladda ner den tillhörande testfilen

Hämta format och kontrollverktyg README

Se pilotprogrammet