مكتبة التوقيع الإلكتروني وواجهة API

PAdES ‏(PDF Advanced Electronic Signatures) صيغة توقيع إلكتروني يُضمَّن فيها التوقيع داخل ملف PDF؛ ويحددها المعيار ETSI EN 319 142. يبقى المستند الموقَّع ملف PDF، ويُتحقق منه عبر لوحة التواقيع في قارئات PDF مثل Adobe Reader، ويمكن أن يحمل حقل توقيع ظاهراً على الصفحة. تتدرج مستوياته من B-B إلى B-T (مع ختم زمني) ثم B-LT وB-LTA (أرشفة طويلة الأمد).

CAdES ‏(CMS Advanced Electronic Signatures) صيغة توقيع إلكتروني تقوم على بنية CMS/PKCS#7؛ ويحددها المعيار ETSI EN 319 122. يمكنها توقيع أي نوع من الملفات؛ وعادةً ما يرافق التوقيع المستند بصيغة .p7s أو داخل غلاف موقَّع. وهي في تركيا الصيغة الأكثر استخداماً في المراسلات الرسمية الموقعة إلكترونياً.

XAdES ‏(XML Advanced Electronic Signatures) صيغة توقيع إلكتروني طُوّرت لمستندات XML؛ ويحددها المعيار ETSI EN 319 132. يمكن تضمين التوقيع داخل ملف XML أو إبقاؤه منفصلاً. وتُستخدم في المستندات المعتمدة على XML مثل الفاتورة الإلكترونية بصيغة UBL-TR.

مكتبة التوقيع الإلكتروني مكوّن للمطورين (SDK) يضيف إنشاء التواقيع الإلكترونية والتحقق منها إلى برنامجك. تطبيق التوقيع الجاهز يعرض شاشة للمستخدم؛ أما المكتبة فهي لبنة بناء بلا شاشة — تطبيقك هو من يوقّع، ضمن سير عملك. تعمل مع البطاقة الذكية أو مفتاح USB أو HSM، وتنشئ صيغ CAdES وXAdES وPAdES وتتحقق منها.

حزمة e-Yazışma هي الحزمة القياسية المستخدمة في المراسلات الإلكترونية الرسمية مع المؤسسات العامة في تركيا: يُجمع المستند الموقَّع وملف البيانات الوصفية وأي مرفقات في حزمة واحدة. وتُرسل بين المؤسسات عادةً عبر KEP (البريد الإلكتروني المسجّل).

حزمة e-Yazışma الرسمية هي ملف البيانات الوصفية والمستند الموقَّع مجمّعَين معاً. تنجز المكتبة ذلك باستدعاء واحد: توقّع المستند بصيغة CAdES أو XAdES، وتنشئ البيانات الوصفية وفق المخطط، وتغلق الحزمة. الإصداران 1.3 و2.0 من e-Yazışma مدعومان، وشهادة الجذر الخاصة بـ KamuSM مدمجة. وإذا حددت مجلداً، توقّع المستندات التي فيه دفعة واحدة.

المكتبة تدخل في برنامجك: سير عملك هو الذي يطلق التوقيع والواجهة واجهتك. أما التطبيق الجاهز (İmzacı) فيعمل على سطح المكتب: يختار المستخدم الملف ويوقّعه. كلاهما يستخدم بنية التوقيع نفسها؛ والأنسب لك يتوقف على من يبدأ التوقيع — برنامجك أم المستخدم.

CAdES ‏(BES وEPES وT وC وX وXL وA)، وXAdES ‏(BES وT وC وX وXL وA)، وPAdES ‏(B-B وB-T وB-LT وB-LTA)، وASiC-S وASiC-E. بمكتبة واحدة تصل إلى مستوى الأرشفة طويلة الأمد.

لا. المكتبة معيارية؛ وتكفي حزمة eSignature.PAdES لملفات PDF. المعايير ومزوّدو TSA ومزوّدو الأجهزة التي لا تستخدمها لا تدخل مشروعك أصلاً.

لا يُنشأ التوقيع في المتصفح بل في جانب الخادم من تطبيق الويب: تُستدعى حزمة eSignature.PAdES ويُعاد ملف PDF الموقَّع إلى المستخدم. العامل الحاسم هو مكان المفتاح — مع HSM سحابي أو HSM شبكي أو توقيع عبر الجوال يستطيع الخادم الوصول إلى المفتاح، فيجري التدفق بالكامل عبر الويب. أما إذا كان المفتاح على البطاقة الذكية للمستخدم فلا يستطيع المتصفح الوصول إليها؛ وفي هذه الحالة يتم التوقيع على سطح المكتب باستخدام İmzacı.

نعم. مصدر التوقيع مُجرَّد: البطاقة الذكية ومفتاح USB ‏(CNG/PKCS#11) وأجهزة HSM الشبكية وخدمات HSM السحابية والتوقيع عبر الجوال تُستخدم كلها بالتدفق نفسه. كل مزوّد حزمة مستقلة.

نعم. التحقق من سلسلة الشهادات وفق RFC 5280، وCRL، وOCSP، وDelta CRL، والتحقق دون اتصال كلها داخل المكتبة؛ والمكوّن نفسه ينشئ التوقيع ويتحقق منه.

نعم. تطبيق سطح المكتب الذي يُستخدم دون كتابة شيفرة هو İmzacı: يوقّع ملفات PDF وXML بالبطاقة الذكية، وينشئ حزم e-Yazışma، ويوقّع مجلدات كاملة دفعة واحدة.

أن تضيف إلى المشروع حزمة المعيار الذي تحتاجه: eSignature.PAdES لتوقيع PDF، وحزمة XAdES لملفات XML. ولأن المكتبة مقسّمة إلى 39 حزمة NuGet، تثبّت ما تستخدمه فقط؛ ولا تدخل مشروعك تبعية واحدة ضخمة.

عبر Windows CNG وPKCS#11 تُدعم أجهزة مثل AKİS وSafeNet/eToken وGemalto/Thales وIDEMIA وFeitian وYubiKey وNitrokey. كل مزوّد حزمة منفصلة ومستقلة؛ والتعريفات التي لا تستخدمها لا تدخل المشروع.

نعم. تُدعم أجهزة HSM الشبكية Thales Luna وUtimaco وEntrust nShield، إضافة إلى AWS CloudHSM/KMS وAzure Key Vault HSM وGoogle Cloud KMS. وبهذا يُبنى تدفق توقيع آلي على الخادم دون مستخدم يحمل بطاقة.

لا؛ المكوّن نفسه ينشئ التوقيع ويتحقق منه. التحقق من سلسلة الشهادات وفق RFC 5280، وCRL، وOCSP، وDelta CRL، والتحقق دون اتصال كلها داخل المكتبة.