This document ESYA provides an introductory summary on how to use ESYA CMS Signature API. With CMS Signature API you can manage your keys with smartcards, validate certificates, create and verify electronic signatures. API requires a valid license.

You need a digital certificate and a secure container for the private key in order to create signature. Usually smartcards are used as the secure container for the private keys. For detailed information about signature creation please refer to the section Signature Creation Operations.

Signature verification consists of certificate validation , cryptographic verification of the signature and structural validation of the signed document. Certificate validation requires a validation policy file which is an XML file coming with the API and can be configured as desired. Please refer to the section İmza Doğrulama İşlemleri for more information.

ESYA API CMS Signature kütüphanesinin kullanılabilmesi için lisans doyasına, sertifika doğrulama politika dosyasına, sertifika deposu dosyasına ihtiyacınız vardır.

İmza doğrulama işlemi için ise yukarıdaki dosyalarla birlikte ESYA kütüphanesi yeterli olacaktır. Kanuni geçerliliği olan nitelikli imzaların atılabilmesi için ise güvenli bir donanım kullanılması zorunluğu vardır. Genel kullanım olarak akıllı kart kullanılmaktadır.

Akıllı karta erişilebilmesi için akıllı kart okuyucusu sürücüsünün ve akıllı kartın sürücüsünün kurulması gerekmektedir. Akıllı kartın üreticisinin sağladığı kart izleme programı ile bilgisayarın karta erişimi kontrol edilebilir.

Hızlı bir başlangıç için hızlı başlangıç bölümüne bakabilirsiniz.

API, ETSI TS 101 733 dokümanında anlatılan aşağıdaki imza tiplerini desteklemektedir:

1. CAdES-BES (Basic Elektronic Signature-Basit Elektronik İmza)
2. CAdES-EPES (Explicit Policy Based Electronic Signature- Belirlenmiş Politika Temelli Elektronik İmza)
3. CAdES-T (Electronic Signature with Time- Zaman Damgası Eklenmiş Elektronik İmza)
4. CAdES-C (Electronic Signature with Complete Validation Data References-Tüm Doğrulama Verilerinin Referanslarının Eklendiği İmza)
5. CAdES-X-Long (EXtended Long Electronic Signature- Genişletilmiş Uzun Elektronik İmza)
6. CAdES-X-Type 1 (EXtended Electronic Signature with Time Type 1- Genişletilmiş Elektronik İmza Tip 1 Zamanlı)
7. CAdES-X-Type 2 (EXtended Electronic Signature with Time Type 1- Genişletilmiş Elektronik İmza Tip 2 Zamanlı)
8. CAdES-X-Long-Type 1 or Type 2 (EXtended Long Electronic Signature with Time Type 1- Genişletilmiş Uzun Elektronik İmza Tip 1 veya Tip 2 Zamanlı)
9. CAdES-A (Archival Electronic Signature- Arşiv Elektronik İmza)

Yukarıdaki imza tiplerinin detayı için ETSI TS 101 733 dokümanına bakılabilir. Ancak burada da imza tipleri için kısa açıklamalar verilmiştir. Açıklamalarda ETSI TS 101 733 dokümanında yer alan şekillerden faydalanılmıştır

İmza Atma

Farklı İmza Tiplerinin Oluşturulması

Zorunlu Olmayan Özellikler

Sertifika Dogrulama

İmza Dogrulama

İmza Tipleri Arasında Dönüşüm

İmza Zamanı

Parametreler