الختم التشفيري (XAdES / ECDSA)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

الختم التشفيري هو توقيع XAdES على الفاتورة بخوارزمية ECDSA على منحنى secp256k1 بمفتاح شهادة الجهاز، يثبت مصدر الفاتورة وإنها ما تعدّلت.

الختم التشفيري حسب تعريف الهيئة: ختم إلكتروني بخوارزميات تشفير يضمن مصدر الفاتورة وسلامة محتواها وهوية مُصدرها. فنياً هو توقيع XAdES-BES مضمّن في المستند، بخوارزمية ECDSA مع SHA-256 على منحنى secp256k1، بالمفتاح الخاص لشهادة الجهاز (CSID).

مكانه: ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/sig:UBLDocumentSignatures/sac:SignatureInformation/ds:Signature، ومعه عنصر cac:Signature في رأس الفاتورة يشير له. وفيه مرجعين: هاش الفاتورة، وهاش xades:SignedProperties (وقت التوقيع وبيانات الشهادة).

توقيع الهيئة مو XMLDSig عادي، وثلاث نقاط تكسر أغلب التطبيقات: SignatureValue يوقّع البايتات الخام لهاش الفاتورة مو SignedInfo، وهاش SignedProperties والشهادة يكون base64 للنص الست عشري، وX509IssuerName بترتيب .NET المعكوس. والقواعد: BR-KSA-28 وBR-KSA-29 وBR-KSA-30 تتحقق من المعرّفات وطريقة التوقيع، وBR-KSA-60 تشترط الختم في المبسّطة. الضريبية تاخذ ختم الهيئة نفسها وقت الاعتماد.

ماثل بنى الختم على SDK الهيئة 3.4.8، واختباراتنا تطابقه مع عيّنات الـ SDK، ويوقّع كل فاتورة بشهادة جهازك.

مثال

<ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256"/>
...
<cac:Signature>
    <cbc:ID>urn:oasis:names:specification:ubl:signature:Invoice</cbc:ID>
    <cbc:SignatureMethod>urn:oasis:names:specification:ubl:dsig:enveloped:xades</cbc:SignatureMethod>
</cac:Signature>

أسئلة شائعة

أي منحنى تشفير تستخدم زاتكا؟

secp256k1 مع ECDSA وSHA-256. المفتاح يتولّد مع الـ CSR وقت تسجيل الجهاز.

ليش توقيعي يتحقق بمكتبة XMLDSig وزاتكا ترفضه؟

لأن الهيئة توقّع هاش الفاتورة نفسه مو SignedInfo، وتستخدم صيغة هاش مختلفة لـ SignedProperties والشهادة.

قواعد الهيئة المرتبطة

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API