XProduct

Pečeť pasu

Ověřit pečeť pasu

Každý pas, který xProduct vydává ve standardním formátu (EN 18223), nese digitální pečeť. Dokazuje, že data pocházejí z xProduct a od té doby nebyla změněna — i u kopie, kterou si někdo uložil před měsíci. Ověření probíhá ve vašem vlastním prohlížeči s našimi veřejnými klíči.

Pas na tomto webu

Jeho číslo produktu nebo adresa jeho pasu.

Podepsaný soubor pasu

Soubor .jws, např. z /api/dpp/{number}/en18223/signed.

Co je pečeť

  • JSON Web Signature (RFC 7515) s ES256 (ECDSA, P-256, SHA-256), vytvořená klíčem, který nikdy neopustí náš trezor klíčů.
  • Každá standardní odpověď (/api/dpp/{id}/en18223 a /api/v1/…) ji nese v hlavičce X-DPP-Signature, bez dat (odděleně). /api/dpp/{id}/en18223/signed poskytne pas a pečeť v jednom souboru.
  • Veřejné klíče jsou na /.well-known/jwks.json; kid pečeti určuje klíč. Starší klíče zůstávají v seznamu, aby bylo možné ověřit i starší kopie.
  • Je to pečeť xProduct vytvořená pro hospodářský subjekt uvedený v pasu. Vlastní elektronická pečeť subjektu s certifikátem uznávaným v EU je pozdější krok, který čeká na pravidla EU.

Ověření vlastním softwarem

  1. Pečeť vezměte z hlavičky: header..signature (mezi dvěma tečkami nic).
  2. Tělo odpovědi, přesně tak, jak bylo přijato a zakódováno v base64url, vložte mezi tečky.
  3. Ověřte ji jako běžnou ES256 JWS klíčem ze sady klíčů, jehož kid se shoduje. Zvládne to jakákoli knihovna JOSE.