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> ASiC signature packages as decribed in <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> can be created by using ESYA ASiC Signature API. By using this structure, one ore more signature, signed data and validation data can be bundled into a single zip file. </p> </div> <h2>Requirements</h2> <div class="level2"> <p> ASiC Signature API requires the licence file, certificate validation policy file and certificate store file. CAdES or XAdES API is also required according to the signature format used in the ASiC package.. </p> <p> For qualified signatures, use of a secure hardware is compulsory. Usually, smartcards are used for this purpose. To access smartcard, the driver for the smartcard reader and the smartcard must be set up in the target machine. A utility application to view the contents of smartcard can be obtained from card manufacturers. </p> </div> <h2>Concepts</h2> <div class="level2"> </div> <h3>Package Type</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"> Single signature and single data. </td> </tr> <tr class="row1"> <td class="col0"> <b>Extended (ASIC_E)</b> </td><td class="col1"> One or more signature and one or more data. Single signature for multiple data may also exist. </td> </tr> </table> <span class='np_break'> </span> </div> </div> <h2>Key Interfaces and Design</h2> <div class="level2"> </div> <h3>SignaturePackageFactory</h3> <div class="level3"> <p> It contains static methods used for signature creation. </p> </div> <h3>SignaturePackage</h3> <div class="level3"> <p> It represents the ZIP structure containing <code>SignatureContainer</code> and signed data. For the interfaces <code>SignatureContainer</code>, <code>Signature</code>, and <code>Signable</code>, see <a href="/esya-api/doku.php?id=en:esya:ortakimza:eimza-ortak-kutuphanesi" class="wikilink1" title="en:esya:ortakimza:eimza-ortak-kutuphanesi">Common Signature API</a>. </p> </div> <h2>API Usage</h2> <div class="level2"> </div> <h3>A Simple Package Creation</h3> <div class="level3"> <p> <em><</em>sxh java> Context c = new Context(); SignatureFormat format = SignatureFormat.CAdES; <em> Can also be SignatureFormat.XAdES SignaturePackage signaturePackage = SignaturePackageFactory .createPackage(c, PackageType.ASiC_S, format); </em> Add data to be signed Signable inPackage = signaturePackage.addData(new SignableFile(dataFile, "text/plain"), "sample.txt"); SignatureContainer container = signaturePackage.createContainer(); Signature signature = container.createSignature(CERTIFICATE); </p> <p> <em> Add data to be signed(false=data is not included in the signature) signature.addContent(inPackage, false); signature.sign(SIGNER); </em> write the package signaturePackage.write(new FileOutputStream(fileName)); <em><</em>/sxh> </p> </div> <h3>Multiple signatures</h3> <div class="level3"> <p> <em><</em>sxh java; title: Reading and Updating Package(SignatureContainer)> <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> ==== Verification ==== </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>Signature Upgrade</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> For more examples, see <a href="/esya-api/doku.php?id=en:esya:ortakimza:eimza-ortak-kutuphanesi" class="wikilink1" title="en:esya:ortakimza:eimza-ortak-kutuphanesi">Common Signature API</a>. The codes listed here are kept short for the sake of readability. You can also check <a href="/esya-api/doku.php?id=esya:ortakimza:imza-api-kullanim" class="wikilink1" title="esya:ortakimza:imza-api-kullanim">here</a>. </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="col0">Previous: <a href="/esya-api/doku.php?id=en:esya:xades:eimza-xades-kutuphanesi" class="wikilink1" title="en:esya:xades:eimza-xades-kutuphanesi">XAdES Signature API</a></td><td class="col1"><a href="/esya-api/doku.php?id=start_en" class="wikilink1" title="start_en">Home</a></td><td class="col2"> Next: <a href="/esya-api/doku.php?id=en:esya:cmszarf:cms-zarf" class="wikilink1" title="en:esya:cmszarf:cms-zarf">CMS Envelope</a></td> </tr> </table> <span class='np_break'> </span> </div> </div>