کتابخانه و 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) است که ایجاد و راستی‌آزمایی امضای الکترونیکی را درون نرم‌افزار شما قرار می‌دهد. یک برنامه امضای آماده به کاربر صفحه نمایش می‌دهد؛ کتابخانه یک بلوک سازنده بدون صفحه است — برنامه شما امضا می‌کند، درون گردش کار شما. با کارت هوشمند، توکن یا 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. با یک کتابخانه تا سطح بایگانی بلندمدت پیش می‌روید.

نه. کتابخانه ماژولار است؛ برای PDF بسته eSignature.PAdES کافی است. استانداردها، 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 و راستی‌آزمایی آفلاین درون کتابخانه هستند.