Бібліотека та API електронного підпису
Розробка електронного підпису з нуля займає місяці. З eSignature підпис PDF, XML і даних зводиться до кількох рядків: ви додаєте лише потрібний стандарт підпису, пристрій підпису чи постачальника позначок часу — кожен як окремий пакет.
Що таке бібліотека електронного підпису?
Бібліотека електронного підпису — це готовий пакет коду, який дає вашому власному програмному забезпеченню змогу створювати й перевіряти електронні підписи. Вона бере на себе стандарти підпису (CAdES, XAdES, PAdES, ASiC), перевірку ланцюжка сертифікатів, позначку часу та обмін даними з пристроєм підпису. eSignature робить це на .NET модульними пакетами: якщо ви підписуєте лише PDF, вистачить одного пакета.
Як використовувати?
Додайте пакет
Ви додаєте до проєкту пакет потрібного стандарту, наприклад eSignature.PAdES для підпису PDF.
Оберіть джерело підпису
Смарт-картка, USB-токен, мережевий HSM, хмарний HSM або мобільний підпис — кожен постачальник є окремим незалежним пакетом.
Підпишіть
Підпис формується з документа, сертифіката та рівня підпису; підтримується аж до рівня довгострокового архіву (LTA).
Перевірте
Та сама бібліотека перевіряє підпис: перевірка ланцюжка за RFC 5280, CRL, OCSP, Delta CRL і офлайн-перевірка.
Що є в бібліотеці?
Модульна структура — 39 пакетів
Ви встановлюєте лише те, що використовуєте; без зайвих залежностей і роздування.
Усі профілі ETSI
CAdES (від BES до A), XAdES (BES/T/C/X/XL/A), PAdES (від B-B до B-LTA) та ASiC-S/ASiC-E.
Смарт-картка та USB-токен
Через Windows CNG і PKCS#11; такі пристрої, як AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey і Nitrokey.
HSM і хмарний HSM
Мережеві HSM Thales Luna, Utimaco та Entrust nShield; AWS CloudHSM/KMS, Azure Key Vault HSM і Google Cloud KMS.
Мобільний підпис
Мобільний підпис Turkcell, Vodafone і Türk Telekom; кожен оператор — окремий пакет. Запускається за номером телефону, користувач підтверджує.
Понад 11 постачальників позначок часу
KamuSM, GlobalSign, DigiCert, Sectigo, Entrust, FreeTSA та інші; кожен TSA — окремий пакет.
Повна перевірка сертифікатів
Перевірка ланцюжка за RFC 5280, CRL, OCSP, Delta CRL, офлайн-перевірка — контроль ланцюжка довіри на рівні банків і держсектору.
Відповідність законодавству
Повна відповідність турецькому Закону про електронний підпис № 5070; у Європі — профілі ETSI/eIDAS у промисловій експлуатації.
Хто її використовує?
Розробники ПЗ і продуктові команди
Команди, які хочуть додати підпис у власний застосунок і вирішити це за дні, а не місяці.
Інтегратори для держсектору та підприємств
Проєкти, де потрібні підпис і перевірка в електронному листуванні, системах документообігу (EBYS) та потоках документів.
Фінанси та страхування
Процеси з великим обсягом підписання, керуванням ключами в HSM і повним ланцюжком перевірки.
Рішення для електронних документів і рахунків
Підписання XML-документів у форматі XAdES і доведення їх до архівного рівня.
Поширені запитання
Що таке підпис PAdES?
PAdES (PDF Advanced Electronic Signatures) — формат електронного підпису, за якого підпис вбудовується в сам PDF-файл; його визначає стандарт ETSI EN 319 142. Підписаний документ залишається PDF, перевіряється на панелі підписів у програмах для читання PDF, як-от Adobe Reader, і може містити видиме поле підпису на сторінці. Рівні зростають від B-B до B-T (з позначкою часу), B-LT і B-LTA (довгостроковий архів).
Що таке підпис CAdES?
CAdES (CMS Advanced Electronic Signatures) — формат електронного підпису на основі структури CMS/PKCS#7; його визначає стандарт ETSI EN 319 122. Ним можна підписати файл будь-якого типу; підпис зазвичай передається разом із документом як .p7s або в підписаному конверті. У Туреччині це найпоширеніший формат в офіційному листуванні з електронним підписом.
Що таке підпис XAdES?
XAdES (XML Advanced Electronic Signatures) — формат електронного підпису, розроблений для XML-документів; його визначає стандарт ETSI EN 319 132. Підпис може бути вбудований у XML або зберігатися окремо. Використовується для XML-документів, наприклад електронних рахунків у форматі UBL-TR.
Що таке бібліотека електронного підпису?
Бібліотека електронного підпису — це компонент для розробників (SDK), який вбудовує створення й перевірку електронного підпису у ваше власне ПЗ. Готовий застосунок для підпису показує користувачеві екран; бібліотека — це будівельний блок без екрана: підписує ваш застосунок, у вашому процесі. Вона працює зі смарт-карткою, токеном або HSM і створює та перевіряє формати CAdES, XAdES і PAdES.
Що таке пакет e-Yazışma?
Пакет e-Yazışma — стандартний пакет для офіційного електронного листування з державними установами Туреччини: підписаний документ, файл метаданих і вкладення, якщо вони є, об’єднуються в один пакет. Між установами його зазвичай передають через KEP (зареєстровану електронну пошту).
Як створити пакет e-Yazışma?
Офіційний пакет e-Yazışma — це файл метаданих і підписаний документ, упаковані разом. Бібліотека робить це одним викликом: підписує документ у форматі CAdES або XAdES, формує метадані за схемою і закриває пакет. Підтримуються версії e-Yazışma 1.3 і 2.0, кореневий сертифікат 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 — чи треба встановлювати все?
Ні. Бібліотека модульна; для PDF достатньо пакета eSignature.PAdES. Стандарти, TSA та постачальники обладнання, які ви не використовуєте, до проєкту не потрапляють.
Як підписати PDF у вебзастосунку?
Підпис створюється не в браузері, а на серверному боці вашого вебзастосунку: викликається пакет eSignature.PAdES, і підписаний PDF повертається користувачеві. Вирішальне значення має те, де зберігається ключ: з хмарним HSM, мережевим HSM або мобільним підписом сервер має доступ до ключа, тож увесь процес іде через веб. Якщо ключ на смарт-картці користувача, браузер не може звернутися до картки; у такому разі підписання виконується на робочому місці за допомогою İmzacı.
Чи працюватиме, якщо ключ зберігається не на смарт-картці, а в HSM або в хмарі?
Так. Джерело підпису абстраговано: смарт-картка і USB-токен (CNG/PKCS#11), мережеві HSM, хмарні HSM-сервіси та мобільний підпис використовуються в одному й тому самому процесі. Кожен постачальник — незалежний пакет.
Чи перевіряє вона підписи?
Так. Перевірка ланцюжка сертифікатів за RFC 5280, CRL, OCSP, Delta CRL і офлайн-перевірка входять до бібліотеки; підпис створює і перевіряє той самий компонент.
Чи є щось для користувачів, які хочуть підписувати на робочому місці?
Так. Настільний застосунок, яким користуються без програмування, — İmzacı: він підписує PDF і XML смарт-карткою, створює пакети e-Yazışma та виконує пакетне підписання за теками.
Як найшвидше додати електронний підпис у проєкт на .NET або Java?
Додати до проєкту пакет потрібного стандарту: eSignature.PAdES для підпису PDF, пакет XAdES для XML. Оскільки бібліотеку поділено на 39 пакетів NuGet, ви встановлюєте лише те, що використовуєте; одна велика залежність до проєкту не потрапляє.
Які смарт-картки й токени підтримуються?
Через Windows CNG і PKCS#11 підтримуються такі пристрої, як AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey і Nitrokey. Кожен постачальник — окремий незалежний пакет; драйвери, які ви не використовуєте, до проєкту не потрапляють.
Чи можна підписувати на сервері за допомогою HSM?
Так. Підтримуються мережеві HSM Thales Luna, Utimaco і Entrust nShield, а також AWS CloudHSM/KMS, Azure Key Vault HSM і Google Cloud KMS. Так будується автоматичне підписання на сервері без користувача з карткою.
Чи потрібна окрема бібліотека для перевірки підпису?
Ні; підпис створює і перевіряє той самий компонент. Перевірка ланцюжка сертифікатів за RFC 5280, CRL, OCSP, Delta CRL і офлайн-перевірка входять до бібліотеки.
Скільки коштує ліцензія eSignature?
Ліцензія SDK визначається обсягом проєкту: ціну формують стандарти підпису, постачальники токенів/HSM і кількість розробників/інсталяцій.
Від чого залежить ціна?
- Стандарти підпису, що використовуватимуться (CAdES, XAdES, PAdES, ASiC)
- Смарт-картка / токен або мережевий чи хмарний HSM
- Кількість розробників і модель розповсюдження
- Кількість постачальників позначок часу
- Обсяг підтримки та оновлень версій
Надсилаємо пропозицію письмово, по позиціях, протягом 24 годин.
Пов’язані сторінки
Обговорімо інтеграцію
Який стандарт, який пристрій підпису і який обсяг? Визначмо разом модель ліцензії та план інтеграції.
Ліцензія SDK / Дізнатися більшеPart of the eSignature family.