XProduct

Pečať pasu

Overiť pečať pasu

Každý pas, ktorý xProduct vydáva v štandardnom formáte (EN 18223), nesie digitálnu pečať. Dokazuje, že údaje pochádzajú z xProduct a odvtedy neboli zmenené — aj pri kópii, ktorú si niekto uložil pred mesiacmi. Overenie prebieha vo vašom vlastnom prehliadači s našimi verejnými kľúčmi.

Pas na tejto stránke

Jeho číslo produktu alebo adresa jeho pasu.

Podpísaný súbor pasu

Súbor .jws, napr. z /api/dpp/{number}/en18223/signed.

Čo je pečať

  • JSON Web Signature (RFC 7515) s ES256 (ECDSA, P-256, SHA-256), vytvorená kľúčom, ktorý nikdy neopustí náš trezor kľúčov.
  • Každá štandardná odpoveď (/api/dpp/{id}/en18223 a /api/v1/…) ju nesie v hlavičke X-DPP-Signature, bez údajov (oddelene). /api/dpp/{id}/en18223/signed poskytne pas a pečať v jednom súbore.
  • Verejné kľúče sú na /.well-known/jwks.json; kid pečate určuje kľúč. Staršie kľúče zostávajú v zozname, aby sa dali overiť aj staršie kópie.
  • Je to pečať xProduct vytvorená pre hospodársky subjekt uvedený v pase. Vlastná elektronická pečať subjektu s certifikátom uznávaným v EÚ je neskorší krok, ktorý čaká na pravidlá EÚ.

Overenie vlastným softvérom

  1. Pečať vezmite z hlavičky: header..signature (medzi dvoma bodkami nič).
  2. Telo odpovede, presne tak, ako bolo prijaté a zakódované v base64url, vložte medzi bodky.
  3. Overte ju ako bežnú ES256 JWS kľúčom zo sady kľúčov, ktorého kid sa zhoduje. Zvládne to akákoľvek knižnica JOSE.