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 Eİmza Paketi Kütüphanesi</h1> <div class="level1"> <p> ESYA ASiC kütüphanesi ile ETSI TS 102 918 standardına uygun şekilde imza paketleri oluşturulabilmektedir. Bu sayede bir yada 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 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 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ından 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> Context c = new Context(); SignaturePackage sp = SignaturePackageFactory.readPackage(c, new File(fileName)); <em> first signature container SignatureContainer sc = signaturePackage.getContainers().get(0); </em> first signature in container Signature signature = sc.getSignatures().get(0); </p> <p> <em> upgrade signature.upgrade(SignatureType.ES_T); signaturePackage.write(new FileOutputStream(outFileName)); </em><<em>/sxh> İ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> </div>