Bu doküman ESYA API CMS Signature kütüphanesinin nasıl kullanılacağı hakkında bilgi vermektedir. CMS Signature kütüphanesi ile akıllı kartları yönetebilir, sertifika doğrulayabilir, elektronik imza atabilir ve elektronik imza doğrulayabilirsiniz. Kütüphaneyi kullanabilmeniz için adınıza üretilmiş bir lisansa veya test lisansına ihtiyacınız vardır.

İmza atma işlemi için kullanıcının sertifikaya ve özel anahtarını güvenli bir şekilde muhafaza edebileceği bir öğeye ihtiyacı vardır. Özel anahtarların muhafazası için genel olarak akıllı kart kullanıldığından, dokümanda bu öğe için “akıllı kart” kavramı kullanılacaktır. İmza atma hakkında ayrıntılı bilgi için İmza Atma İşlemleri bölümüne bakınız.

İmza doğrulama işlemleri sertifikanın doğrulanmasından ve imzanın yapısal olarak doğrulamasından oluşmaktadır. Sertifika doğrulama için sertifika deposuna ve sertifika doğrulamanın nasıl yapılacağını belirten politika dosyasına ihtiyaç vardır. Daha ayrıntılı bilgi için İmza Doğrulama İşlemleri bölümüne bakınız.

ESYA API CMS Signature kütüphanesinin kullanılabilmesi için lisans doyasına, sertifika doğrulama politika dosyasına ve 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 okuyucu 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