ספריית חתימה אלקטרונית ו-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 ואימות לא מקוון כלולים בספרייה.