ESYAE-imza Kütüphaneleri

Bu sayfa salt okunur. Kaynağı görebilirsiniz ama değiştiremezsiniz. Bunun yanlış olduğunu düşünüyorsanız yöneticiye danışın.

<h1>ASiC Signature API</h1>
<div class="level1">

<p>
ESYA ASiC kütüphanesi ile <a href="http://www.etsi.org/deliver/etsi_ts/102900_102999/102918/01.01.01_60/ts_102918v010101p.pdf" class="urlextern" title="http://www.etsi.org/deliver/etsi_ts/102900_102999/102918/01.01.01_60/ts_102918v010101p.pdf"  rel="nofollow"> ETSI TS 102 918</a> standardına uygun şekilde imza paketleri oluşturulabilmektedir. Bu sayede bir ya da daha fazla imza, imzalanan veri(ler), ve doğrulama verileri bir zip dosyası içinde taşınabilmektedir.
</p>

</div>

<h2>Gerekler</h2>
<div class="level2">

<p>
ESYA API ASiC 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. Bunu yanında CAdES ya da XAdES imza atma kütüphanesi atılacak imza türüne göre ihtiyaçlar arasındadır.
</p>

<p>
İ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 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 üreticilerinin sağladığı bir kart izleme programı ile bilgisayarın karta erişimi ve kart içeriği kontrol edilebilir.
</p>

</div>

<h2>Kavramlar</h2>
<div class="level2">

</div>

<h3>Paket Tipi</h3>
<div class="level3">
<pre class="code java"><span class="kw1">public</span> <span class="kw1">enum</span> PackageType
<span class="br0">{</span>
    ASiC_S,
    ASiC_E 
<span class="br0">}</span>

</pre><p> </p>




<span class='np_break'> </span>
<div class="table"><table class="inline">
	<tr class="row0">
		<td class="col0"> <b>Basit (ASIC_S)</b> </td><td class="col1"> Paket içinde bir imza ve veri bulunur. </td>
	</tr>
	<tr class="row1">
		<td class="col0"> <b>Extended (ASIC_E)</b> </td><td class="col1"> Paket içinde bir yada birden fazla veri ve bir yada birden fazla imza bulunur. Bir imza birden fazla veriyi imzalamış olabilir. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h2>Anahtar API Arayüzleri ve Tasarım</h2>
<div class="level2">

</div>

<h3>SignaturePackageFactory</h3>
<div class="level3">

<p>
İmza paketlerini oluşturmakta kullanılan static metodları barındıran sınıf.
</p>

</div>

<h3>SignaturePackage</h3>
<div class="level3">

<p>
İçinde <code>SignatureContainer</code> ve imzalı veri(yi/leri) barındıran ZIP yapısını temsil eden sınıf.
İlgili <code>SignatureContainer</code>, <code>Signature</code>, <code>Signable</code> arayüzleri için <a href="/esya-api/doku.php?id=esya:ortakimza:eimza-ortak-kutuphanesi" class="wikilink1" title="esya:ortakimza:eimza-ortak-kutuphanesi">Ortak Eimza Kütüphanesi</a> dökümantasyonuna bakılabilir.
</p>

</div>

<h2>Kütüphane Kullanımı</h2>
<div class="level2">

</div>

<h3>Basit Paket oluşturma</h3>
<div class="level3">

<p>
<em><</em>sxh java>
Context c = new Context();
SignatureFormat format = SignatureFormat.CAdES; <em> SignatureFormat.XAdES de olabilir

SignaturePackage signaturePackage = SignaturePackageFactory
    .createPackage(c, PackageType.ASiC_S, format);

</em> imzalanacak dosyayı pakete ekle
Signable inPackage = signaturePackage.addData(new SignableFile(dataFile, "text/plain"), "sample.txt");
SignatureContainer container = signaturePackage.createContainer();
Signature signature = container.createSignature(CERTIFICATE);
</p>

<p>
<em> paketteki imzalanacak veriyi imzaya ver(false=veriyi imzanın içine ayrıca ekleme) 
signature.addContent(inPackage, false);
signature.sign(SIGNER);

</em> paketi dosyaya yaz
signaturePackage.write(new FileOutputStream(fileName));
<em><</em>/sxh>
</p>

</div>

<h3>Çoklu Paket Oluşturma</h3>
<div class="level3">

<p>
<em><</em>sxh java; title: Paketi okuyup imza(SignatureContainer) ekleme>
<em> read package from file
SignaturePackage sp = SignaturePackageFactory.readPackage(new Context(), inputFile);

</em> create new container in package
SignatureContainer sc = sp.createContainer();
<em> create new signature in container
Signature s = sc.createSignature(CERTIFICATE);

</em> get signable from package
s.addContent(sp.getDatas().get(0), false);
s.sign(SIGNER);
</p>

<p>
<em> write
sp.write(new FileOutputStream(outFileName));
</em><<em>/sxh>
==== Paket Doğrulama ====

</em><<em>sxh java>
</em> read package from file
SignaturePackage sp = SignaturePackageFactory.readPackage(new Context(), inputFile);
</p>

<p>
<em> verify
PackageValidationResult pvr = sp.verifyAll();

</em> check result
assert pvr.getResultType() == PackageValidationResultType.ALL_VALID;
<em><</em>/sxh>
</p>

</div>

<h3>İmza Geliştirme</h3>
<div class="level3">

<p>
<em><</em>sxh java>
<em> read package from file 
Context c = new Context();
SignaturePackage sp = SignaturePackageFactory.readPackage(c, new File(fileName));

</em> get first signature container
SignatureContainer sc = signaturePackage.getContainers().get(0);
</p>

<p>
<em> get first signature in container
Signature signature = sc.getSignatures().get(0);

</em> upgrade
signature.upgrade(SignatureType.ES_T);
</p>

<p>
signaturePackage.write(new FileOutputStream(outFileName));
<em><</em>/sxh>
</p>

<p>
İmza ile ilgili daha fazla örnek için <a href="/esya-api/doku.php?id=esya:ortakimza:eimza-ortak-kutuphanesi" class="wikilink1" title="esya:ortakimza:eimza-ortak-kutuphanesi">Ortak İmza Kütüphanesi</a> dökümanına bakılmalıdır. Bunun yanında bu dökümanda kodlar okunaklılık açısından kısa tutulmaya çalışılmıştır. <a href="/esya-api/doku.php?id=esya:ortakimza:imza-api-kullanim" class="wikilink1" title="esya:ortakimza:imza-api-kullanim">Burada</a>ki İmza Profillerine Uygun İmza Atma bölümüne de göz atılmalıdır.
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<tr class="row0">
		<td class="col0">Önceki: <a href="/esya-api/doku.php?id=esya:xades:eimza-xades-kutuphanesi" class="wikilink1" title="esya:xades:eimza-xades-kutuphanesi">XAdES Eİmza</a></td><td class="col1"><a href="/esya-api/doku.php?id=start" class="wikilink1" title="start">Ana sayfa</a></td><td class="col2"> Sonraki: <a href="/esya-api/doku.php?id=esya:cmszarf:cms-zarf" class="wikilink1" title="esya:cmszarf:cms-zarf">CMS Zarf</a></td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>
ESYAE-imza Kütüphaneleri

User Tools

Site Tools

Page Tools
