ESYA Eİmza Ortak kütüphanesi ile farklı format ve tiplerde imzaların ortak programlama arayüzleri ile kullanılabilmesi sağlanmıştır. Elektronik imza hakkında daha fazla bilgiyi Bölüm 2 Elektronik İmza başlığında bulabilirsiniz.

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

İmzayı oluşturan kodlama tipidir. ASN1 kodlamalı binary(CAdES), xml kodlamalı(XAdES) olmak üzere iki ana yapı bulunmaktadır. Desteklenen İmza formatları CAdES, XAdES.

Eİmza standartları ile berlirlenmiş, bir imzanın içinde yer alan zaman damgası, doğrulama referansları gibi verilerin hangilerinin yer aldığını belirten yapılardır.

İmza verisinin imza içerisinde yer alıp almaması durumuna göre ayrık ve bütünleşik denilmektedir. Bunun yanında XML imza formatına özel enveloped imza vardır. Enveloped imza standartlaştırılamadığı (custom) için ortak kütüphane tarafından desteklenmemektedir. Enveloped imza için XML İmza bölümüne bakabilirsiniz.

Bir kişinin ıslak imzasının, programlama arayüzü karşılığı Signature, bir yada daha fazla imzayı içinde barındıran yapı SignatureContainer İmza formatına göre SignatureContainer yaratma amacı ile kullanılan arayüz SignatureFactory'dir.

İmza yaratıldığında ES-BES tipindedir. Daha kompleks bir imza tipine Signature#upgrade metodu ile çevrilebilir.

// imza konteyneri yarat
SignatureContainer container = 	SignatureFactory.createContainer(SignatureFormat.CAdES, context);

// konteyner içinde imza nesnesi oluştur
Signature signature = container.createSignature(certificate);

// imzalanacak içerik ekle
signature.addContent(new SignableFile(file), false);

// imzala
signature.sign(cardSigner);

// imzayı yaz
container.write(new FileOuputStream(fileName));

// konteyner içinde imza nesnesi oluştur
Signature signature = container.createSignature(certificate);

// imzalanacak içerik ekle
signature.addContent(new SignableFile(file), false);

// imzala
signature.sign(cardSigner);

// imzayı zaman damgalı imza tipine geliştir
signature.upgrade(SignatureType.ES_T);

// imzayı dosyaya yaz
container.write(new FileOuputStream(fileName));

// imza konteynerinidosyadan oku
SignatureContainer container = SignatureFactory.readContainer(fileInputStream);

// ilk imzayı al
Signature signature = container.getSignatures().get(0);

// imzayı zaman damgalı imza tipine geliştir
signature.upgrade(SignatureType.ES_T);

// imzayı dosyaya yaz
container.write(new FileOuputStream(fileName));

// imza konteynerinidosyadan oku
SignatureContainer container = SignatureFactory.readContainer(fileInputStream);

// ilk imzayı al
Signature signature = container.getSignatures()[0];

// imzayı zaman damgalı imza tipine geliştir
signature.upgrade(SignatureType.ES_T);

// imzayı dosyaya yaz
container.write(new FileOuputStream(fileName));

Doğrulama bilgisini de içinde bulunduran imza tipi olan ES_XL tipinde imza oluşturmak için zaman damgalı imza atma örneklerindeki

// imza oluştur
...
// ve geliştir
signature.upgrade(SignatureType.ES_T);

satırını

// geliştir
signature.upgrade(SignatureType.ES_XL);

olarak değiştimek yeterlidir.

İmza doğrulamada SignatureContainer içindeki verifyAll() metodu kullanılır.

// imzayı oku
SignatureContainer container = SignatureFactory.readContainer(inputstream);
inputstream.close();

// imza doğrula
ContainerValidationResult cvr = container.verifyAll();

// imza yapısı içerisindeki bütün imzalar geçerli mi?
assertEquals(ContainerValidationResultType.ALL_VALID, cvr.getResultType());

// imzayı oku
SignatureContainer container = SignatureFactory.readContainer(inputstream);
inputstream.Close();

// imza doğrula
ContainerValidationResult cvr = container.verifyAll();

// imza yapısı içerisindeki bütün imzalar geçerli mi?
Assert.AreEqual(ContainerValidationResultType.ALL_VALID, cvr.getResultType());

İmza Kütüphanesi Kullanımı

Bu bölümde imza atma, gelişirme, doğrulama ve benzer işlemler kod ile birlikte örneklenmektedir.

İmza Kütüphanesi Konfigürasyonu

Bir konfigürasyon dosyası aracılığı ile imza atma ve doğrulama ayarları yapılmakta ve çalışma zamanında değiştirilebilmektedir.