XProduct

Passsiegel

Passsiegel prüfen

Jeder Pass, den xProduct im Standardformat (EN 18223) ausgibt, trägt ein digitales Siegel. Es belegt, dass die Daten von xProduct stammen und seitdem nicht verändert wurden – auch bei einer Kopie, die jemand vor Monaten gespeichert hat. Die Prüfung läuft in Ihrem eigenen Browser, mit unseren öffentlichen Schlüsseln.

Ein Pass auf dieser Website

Seine Produktnummer oder seine Passadresse.

Eine signierte Passdatei

Eine .jws-Datei, z. B. von /api/dpp/{number}/en18223/signed.

Was das Siegel ist

  • Eine JSON Web Signature (RFC 7515) mit ES256 (ECDSA, P-256, SHA-256), erstellt mit einem Schlüssel, der unseren Schlüsseltresor nie verlässt.
  • Jede Standardantwort (/api/dpp/{id}/en18223 und /api/v1/…) trägt es im Header X-DPP-Signature, ohne die Daten (detached). /api/dpp/{id}/en18223/signed liefert Pass und Siegel als eine Datei.
  • Die öffentlichen Schlüssel liegen unter /.well-known/jwks.json; die kid des Siegels benennt den Schlüssel. Ältere Schlüssel bleiben aufgeführt, damit ältere Kopien weiterhin geprüft werden können.
  • Es ist das Siegel von xProduct, erstellt für den im Pass genannten Wirtschaftsakteur. Das eigene elektronische Siegel des Akteurs mit einem in der EU anerkannten Zertifikat ist ein späterer Schritt, der auf EU-Regeln wartet.

Prüfung mit Ihrer eigenen Software

  1. Nehmen Sie das Siegel aus dem Header: header..signature (nichts zwischen den beiden Punkten).
  2. Setzen Sie den Body der Antwort, genau wie empfangen und base64url-codiert, zwischen die Punkte.
  3. Prüfen Sie es als normale ES256-JWS mit dem Schlüssel aus dem Schlüsselsatz, dessen kid übereinstimmt. Jede JOSE-Bibliothek kann das.