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>XAdES Çoklu İmza Atma</h1>
<div class="level1">

<p>
Gerçek hayatta olduğu gibi, elektronik dökümanlarda da bir dökümanda birden fazla imzanın yer alması mümkündür. Bu bölümde yer alan örnekleri <code>tr.gov.tubitak.uekae.esya.api.xades.example.multiple</code> paketinin altında inceleyebilirsiniz. 
</p>

<p>
<code>esya.api.xmlsignature.SignedDocument.java</code> sınıfı çoklu imzaları kolayca yönetmek için yazılmıştır. Bu sınıfı incelemenizde yarar var. Basitçe bu sınıfı kullandığımızda XML formatında bir imza oluşur. Bu format üzerinde görüldüğü gibi aynı döküman üzerinde birden fazla veri ve imza yer alabilir. 
</p>

<p>
<em><</em>sxh xml>
<em><</em>?xml version="1.0" encoding="UTF-8" ?> 
<em><</em>ma3:envelope xmlns:ma3="http:<em>uekae.tubitak.gov.tr/xml/signature#" 
              xmlns:ds="http:</em><a href="http://www.w3.org/2000/09/xmldsig#"&gt" class="urlextern" title="http://www.w3.org/2000/09/xmldsig#"&gt"  rel="nofollow">www.w3.org/2000/09/xmldsig#"&gt</a>; 
</p>
<pre class="code">  &lt;ma3:data&gt; 
      &lt;ma3:data-item&gt;...&lt;/ma3:data-item&gt;
      &lt;ma3:data-item&gt;...&lt;/ma3:data-item&gt; 
      ... 
      &lt;ma3:data&gt; 
  &lt;ma3:signatures&gt; 
      &lt;ds:signature&gt;...&lt;/ds:signature&gt; 
      &lt;ds:signature&gt;...&lt;/ds:signature&gt; 
      ... 
  &lt;/ma3:signatures&gt; 

</pre><p> </p>

<p>
<em><</em>/ma3:envelope>
<em><</em>/sxh>
</p>

</div>

<h2>Paralel İmza</h2>
<div class="level2">

<p>
Aynı döküman içindeki birbirinden bağımsız imzalardır. Aşağıdaki örnekte <code>SignedDocument</code> classını kullanarak önce imzalanacak veri dökümana eklenmekte, daha sonra bu veriyi imzalayan birbirinden bağımsız iki imza yaratılmaktadır. <code>ParallelEnveloped</code> sınıfını inceleyebilirsiniz.
</p>

<p>
<em><</em>sxh java>
Context context = createContext();
</p>

<p>
SignedDocument signatures = new SignedDocument(context);
</p>

<p>
Document doc = Resolver.resolve("./sample.txt", context);
String fragment = signatures.addDocument(doc);
</p>

<p>
XMLSignature signature1 = signatures.createSignature();
</p>

<p>
<em> add document as inner reference
signature1.addDocument("#"+fragment, "text/plain", false);

signature1.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);

</em> false-true gets non-qualified certificates while true-false gets qualified ones
X509Certificate cert = JSmartCardManager.getInstance().getSignatureCertificate(true, false);
</p>

<p>
<em> add certificate to show who signed the document
signature1.addKeyInfo(new ECertificate(cert.getEncoded()));

</em> now sign it by using smart card
signature1.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));
</p>

<p>
XMLSignature signature2 = signatures.createSignature();
</p>

<p>
<em> add document as inner reference
signature2.addDocument("#"+fragment, "text/plain", false);

signature2.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);

</em> add certificate to show who signed the document
signature2.addKeyInfo(new ECertificate(cert.getEncoded()));
</p>

<p>
<em> now sign it by using smart card
signature2.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));

</em> write combined document
signatures.write(new FileOutputStream(BASE_DIR + SIGNATURE_FILENAME));
<em><</em>/sxh>
</p>

<p>
Dışarıdaki veriyi imzalayan iki imzayı örnekleyelim. Örnek kodları <code>ParallelDetached</code> sınıfı içindedir.
</p>

<p>
<em><</em>sxh java>
Context context = createContext();
</p>

<p>
SignedDocument signatures = new SignedDocument(context);
</p>

<p>
XMLSignature signature1 = signatures.createSignature();
</p>

<p>
<em> add document as reference, but do not embed it
</em> into the signature (embed=false)
signature1.addDocument("./sample.txt", "text/plain", false);
</p>

<p>
signature1.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);
</p>

<p>
<em> false-true gets non-qualified certificates while true-false gets qualified ones
X509Certificate cert = JSmartCardManager.getInstance().getSignatureCertificate(true, false);

</em> add certificate to show who signed the document
signature1.addKeyInfo(new ECertificate(cert.getEncoded()));
</p>

<p>
<em> now sign it by using smart card
signature1.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));

XMLSignature signature2 = signatures.createSignature();

</em> add document as reference, but do not embed it
<em> into the signature (embed=false)
signature2.addDocument("./sample.txt", "text/plain", false);

signature2.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);

</em> add certificate to show who signed the document
signature2.addKeyInfo(new ECertificate(cert.getEncoded()));
</p>

<p>
<em> now sign it by using smart card
signature2.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));

</em> write combined document
signatures.write(new FileOutputStream(BASE_DIR + SIGNATURE_FILENAME));
<em><</em>/sxh>
</p>

<p>
Aradaki tek farkın imzalanacak veriyi, SignedDocument yerine sadece referans olarak XMLsigneture'a eklenmesi olduğunu fark ettiniz mi?
</p>

</div>

<h2>Seri İmza</h2>
<div class="level2">

<p>
Veriyi imzalayan imzanın imzalanmasıdır. Buna "counter signature" denir. Aşağıdaki örnekte önceden yaratılmış imzanın okunup, seri imzalanması gösterilmektedir. Örnek kodlar <code>CounterDetached</code> sınıfındadır.
</p>

<p>
<em><</em>sxh java>
Context context = createContext();
</p>

<p>
<em> read previously created signature, you need to run Detached.java first
Document doc = Resolver.resolve(Detached.SIGNATURE_FILENAME, context);
XMLSignature signature = XMLSignature.parse(doc, context);

</em> create counter signature
XMLSignature counterSignature = signature.createCounterSignature();
</p>

<p>
counterSignature.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);
</p>

<p>
<em> false-true gets non-qualified certificates while true-false gets qualified ones
X509Certificate cert = JSmartCardManager.getInstance().getSignatureCertificate(true, false);

</em> add certificate to show who signed the document
counterSignature.addKeyInfo(new ECertificate(cert.getEncoded()));
</p>

<p>
<em> now sign it by using smart card
counterSignature.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));

</em> signature contains itself and counter signature
signature.write(new FileOutputStream(BASE_DIR + SIGNATURE_FILENAME));
<em><</em>/sxh>
</p>

<p>
Şimdi daha karışık bir senaryoda iki paralel imzanın olduğu bir dökümana bir de seri imza ekleyelim. Kodları <code>CounterParallel</code> sınıfından inceleyebilirsiniz.
</p>

<p>
<em><</em>sxh java>
Context context = createContext();
</p>

<p>
<em> read previously created signature
Document signatureFile = Resolver.resolve(ParallelDetached.SIGNATURE_FILENAME, context);
SignedDocument signedDocument = new SignedDocument(signatureFile, context);

</em> get first signature
XMLSignature signature = signedDocument.getSignature(0);
</p>

<p>
<em> create counter signature to the first one
XMLSignature counterSignature = signature.createCounterSignature();

counterSignature.getSignedInfo().setSignatureMethod(SignatureMethod.RSA_SHA256);

</em> false-true gets non-qualified certificates while true-false gets qualified ones
X509Certificate cert = JSmartCardManager.getInstance().getSignatureCertificate(true, false);
</p>

<p>
<em> add certificate to show who signed the document
counterSignature.addKeyInfo(new ECertificate(cert.getEncoded()));

</em> now sign it by using smart card
counterSignature.sign(JSmartCardManager.getInstance().getSigner(PIN, cert));
</p>

<p>
<em> signed doc contains both previous signature and now a counter signature
</em> in first signature
signedDocument.write(new FileOutputStream(BASE_DIR + SIGNATURE_FILENAME));
<em><</em>/sxh>
</p>

<p>
Bir önceki örnekten pek de farklı değil. Paralel imzaların SignedDocument içinde tutulması dışında.
</p>

</div>
ESYAE-imza Kütüphaneleri

User Tools

Site Tools

Page Tools
