Le cachet cryptographique (signature numérique)
Signature ECDSA au format XAdES portant sur l'empreinte du document et les propriétés de signature, réalisée avec la clé d'un appareil enregistré et un certificat délivré par la ZATCA.
Le cachet prouve deux choses : le document provient d'un appareil que son propriétaire a enregistré auprès de la ZATCA, et il n'a pas été modifié depuis. L'empreinte est calculée en SHA-256, la signature en ECDSA avec une clé de 256 bits, et la signature est une signature XAdES enveloppée de niveau B-B.
La signature contient deux références : l'empreinte du document après les transformations, et l'empreinte du bloc SignedProperties, qui porte l'heure de signature, le condensé du certificat, son émetteur et son numéro de série. SignedInfo est ensuite signé, puis la signature et le certificat sont joints.
Un document simplifié est cacheté par l'appareil du vendeur avant d'être remis. Un document standard est cacheté par la plateforme de la ZATCA lors de la validation préalable ; si le vendeur le cachette aussi, la plateforme ajoute un second cachet. Le code QR est exclu de la signature.
Les textes de la ZATCA ne sont pas entièrement alignés : le tableau de la norme de sécurité mentionne SigningCertificateV2, une politique de signature et la chaîne complète de certificats, et son profil de certificat donné à titre d'illustration indique P-256, alors que les exemples et outils officiels utilisent secp256k1 (les commandes OpenSSL des lignes directrices techniques).
Dans JooDax
DisponibleLes programmes cachettent avec une clé secp256k1 (k256) et écrivent le bloc des propriétés signées exactement sous la forme qu'accepte le validateur de la ZATCA, les condensés du certificat et des propriétés étant le base64 de la chaîne hexadécimale. Ils diffèrent du tableau de la norme de sécurité sur les points suivants : SigningCertificate de version 1, ni politique de signature ni propriétés d'objet de données, seul le certificat de signature est joint, et le Type de la seconde référence (xmldsig#SignatureProperties au lieu de 01903#SignedProperties). L'étape 5 des lignes directrices techniques décrit l'empreinte des propriétés comme le base64 des octets après suppression des espaces, alors que les programmes calculent l'empreinte d'un bloc à l'indentation figée et encodent le texte hexadécimal. Le validateur de la ZATCA a accepté cette forme lors de la phase de preuve de concept.
crates/jdx-einvoice-sa/src/xml.rs
Étapes
- Calculer l'empreinte du document (voir la page sur l'empreinte de la facture).
- Signer l'empreinte avec la clé privée de l'appareil, en ECDSA.
- Calculer le condensé du certificat et renseigner les propriétés signées : heure de signature, condensé, émetteur et numéro de série.
- Calculer l'empreinte des propriétés signées.
- Remplir UBLExtensions avec la signature, le certificat et les deux références, puis ajouter cac:Signature et le bloc QR.
Questions et réponses
Le cachet signe-t-il le fichier entier ?
Il couvre tout le document, à l'exception du bloc QR et du bloc du cachet lui-même.
Pages liées
- KSA-15 Cachet cryptographique
- KSA-13 Empreinte de la facture précédente (PIH)
- KSA-14 Code QR
- BR-KSA-28 · L'ID des informations de signature du cachet doit être urn:oasis:names:specification:ubl:signature:1.
- BR-KSA-29 · L'ID de signature référencé et l'ID de signature doivent être urn:oasis:names:specification:ubl:signature:Invoice.
- BR-KSA-30 · La méthode de signature doit être urn:oasis:names:specification:ubl:dsig:enveloped:xades.
- BR-KSA-60 · Le cachet cryptographique est obligatoire sur les documents simplifiés et leurs notes.
Notions liées
- L'empreinte de la facture : comment elle est calculéeEmpreinte SHA-256 du document, calculée après retrait des blocs du cachet et du QR et après canonicalisation, écrite en base64 ; le cachet et la chaîne reposent sur elle.
- Intégrer un appareil et obtenir son CSIDComment un appareil de facturation obtient son certificat de cachet auprès de la ZATCA : clé, demande de certificat, OTP, contrôles de conformité, puis certificat de production.
- La canonicalisation XML (C14N 1.1) avant le calcul de l'empreinteMise du texte XML sous une forme standard unique avant le calcul de l'empreinte, afin qu'un même document donne la même empreinte sur tous les systèmes.
La facturation électronique en Arabie saoudite (FATOORA)
Sources
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
Vérifié le: 4 novembre 2026. Ce qui concerne JooDax est tiré du code même des programmes.