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>XML İmza Konfigürasyonu</h1> <div class="level1"> <p> XML imza kütüphanesinin imza yaratma ve doğrulama ayarlarına erişim için kullandığı konfigurasyon dosyasıdır. Bu konfigürasyon içinde kaynaklara erişim için proxy, zaman damgası, kaynak çözücüleri(Resolver arayüzü), varsayılan algoritmalar ve doğrulama ayarları yer alır. </p> <p> <em><</em>sxh xml> <em><</em>?xml version="1.0" encoding="UTF-8"?> <em><</em>xml-signature-config> <em><</em>/sxh> </p> <p> XML imza konfigürasyonu, <code>xml-signature-config</code> kök elemanı ile başlar. </p> </div> <h2>Yerelleştirme</h2> <div class="level2"> <p> Yerelleştirme seçenekleri, locale elementi ile ayarlanır. </p> <p> <em><</em>sxh xml> <em><</em>locale language="EN" country="EN"/> <em><</em>/sxh> </p> </div> <h2>Proxy Ayarları</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>http> </p> <pre class="code"> &lt;proxy-host&gt;&lt;/proxy-host&gt; &lt;proxy-port&gt;&lt;/proxy-port&gt; &lt;proxy-username&gt;&lt;/proxy-username&gt; &lt;proxy-password&gt;&lt;/proxy-password&gt; &lt;basic-authentication-username&gt;&lt;/basic-authentication-username&gt; &lt;basic-authentication-password&gt;&lt;/basic-authentication-password&gt; &lt;connection-timeout-in-milliseconds&gt;2000&lt;/connection-timeout-in-milliseconds&gt; </pre><p> </p> <p> <em><</em>/http> <em><</em>/sxh> </p> <p> Eğer proxy üzerinden bağlantı kurulacaksa ilgili ayarlar http elementi ile yapılır. </p> </div> <h2>Kaynak Çözücüler</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>resolvers> </p> <pre class="code"> &lt;resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.IdResolver"/&gt; &lt;resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.DOMResolver"/&gt; &lt;resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.HttpResolver"/&gt; &lt;resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.XPointerResolver"/&gt; &lt;resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.FileResolver"/&gt; </pre><p> </p> <p> <em><</em>/resolvers> <em><</em>/sxh> </p> <p> Bu alanda imza içideki URL'lerin çözümünde kullanılacak sınıflar yer almaktadır. Standart bir kullanım için buradaki çözücü tanımlamaları yeterlidir. Farklı protokoller eklenmek istenirse IResolver arayüzü gerçeklenip, konfigürasyonda resolvers elementine eklenebilir. Örneğin bir URI'ye karşılık gelen veriyi bir veritabanında tutmak isterseniz, kendi DatabaseResolver sınıfınızı yazabilirsiniz. </p> <p> <em><</em>sxh java> public interface IResolver { </p> <pre class="code"> boolean isResolvable(String aURI, Context aContext); Document resolve(String aURI, Context aContext) throws IOException; </pre><p> </p> <p> } <em><</em>/sxh> </p> </div> <h2>Zaman Damgası</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>timestamp-server> </p> <pre class="code"> &lt;host&gt;http://timestamp_server_address&lt;/host&gt; &lt;userid&gt;fill_id_here&lt;/userid&gt; &lt;password&gt;pass&lt;/password&gt; &lt;digest-alg&gt;SHA-1&lt;/digest-alg&gt; </pre><p> </p> <p> <em><</em>/timestamp-server> <em><</em>/sxh> </p> <p> Userid ve password alanları ESYA tabanlı zaman damgası içindir. Açık bir zaman damgası servisi için bu alanları boş bırakın. </p> </div> <h2>Varsayılan Algoritmalar</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>algorithms> </p> <pre class="code"> &lt;digest-method&gt;http://www.w3.org/2001/04/xmlenc#sha256&lt;/digest-method&gt; </pre><p> </p> <p> <em><</em>/algorithms> <em><</em>/sxh> </p> </div> <h2>Doğrulama Parametreleri</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>validation> </p> <pre class="code"> &lt;!-- default policy for certificate validation --&gt; &lt;certificate-validation-policy-file&gt;//path/to/certval-policy.xml&lt;/certificate-validation-policy-file&gt; &lt;!-- possible types: {QualifiedCertificate, MaliMuhurCertificate, TimeStampingCertificate} --&gt; &lt;certificate-validation-policy-file for="MaliMuhurCertificate"&gt;//path/to/certval-mm-policy.xml&lt;/certificate-validation-policy-file&gt; &lt;!-- grace period is the time that needs to pass to get exact revocation info--&gt; &lt;grace-period-in-seconds&gt;86400&lt;/grace-period-in-seconds&gt; &lt;!-- how old revocation data should be accepted? --&gt; &lt;last-revocation-period-in-seconds&gt;172800&lt;/last-revocation-period-in-seconds&gt; &lt;!-- compare resolved policy with the one at policy uri, if indicated --&gt; &lt;check-policy-uri&gt;false&lt;/check-policy-uri&gt; &lt;!-- loosening below 2 settings will cause warnings instead of validation failure --&gt; &lt;!-- referenced validation data must be used for cert validation is set true --&gt; &lt;force-strict-reference-use&gt;false&lt;/force-strict-reference-use&gt; &lt;!-- validation data must be published after creation ifs set true, requires grace period for signers --&gt; &lt;use-validation-data-published-after-creation&gt;false&lt;/use-validation-data-published-after-creation&gt; &lt;validators&gt; ... &lt;/validators&gt; </pre><p> </p> <p> <em><</em>/validation> <em><</em>/sxh> </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <th class="col0"> certificate-validation-policy-file </th><td class="col1"> Sertifika doğrulamada kullanılacak konfigürasyon. 'for' attribute'u kullanılmazsa default politika olur. Bu attribute içinde <code>QualifiedCertificate</code>, <code>MaliMuhurCertificate</code>, <code>TimeStampingCertificate</code> değerlerinden biri kullanılarak sertifika tipine göre doğrulama politikası vermek mümkündür. </td> </tr> <tr class="row1"> <th class="col0"> grace-period-in-seconds </th><td class="col1"> Saniye cinsinden grace period. Grace period doğrulama verisinin olgunlaşması için beklenmesi gereken süredir. </td> </tr> <tr class="row2"> <th class="col0"> last-revocation-period-in-seconds </th><td class="col1"> Doğrulama verisinin üretim zamanı ile, doğrulama zamanı arasında ne kadar süre olabileceği </td> </tr> <tr class="row3"> <th class="col0"> force-strict-reference-use </th><td class="col1"> Referanslarla işaret edilen iptal bilgisi doğrulamada kullanılmalı. Güvenlik açısından normal şartlarda bu değer true olmalıdır. </td> </tr> <tr class="row4"> <th class="col0"> use-validation-data-published-after-creation </th><td class="col1"> Doğrulama verisinin imza tarihinden sonra üretilmesini şart koş. Default değer true. Sağlıklı ve güvenilir bir imzada doğrulama verisi imza tarihinden sonra yayınlanmış olmalıdır. </td> </tr> </table> <span class='np_break'> </span> </div> </div> <h2>Doğrulayıcılar</h2> <div class="level2"> <p> XML İmza doğrulayıcı sınıflar <code>validation</code>/<code>validators</code> tagları arasında yer almaktadır. Normalde bu kısımları değiştirmeniz gerekmez. Ekstra (custom) doğrulayıcılar geliştirmek isterseniz bu kısma ekleme yapmak için örnek konfigürasyonları inceleyebilirsiniz. Dikkat etmeniz gereken tek nokta profil tanımlarında "inherit-validators-from" attribute'ı aracılığıyla profiller arası ortak doğrulayıcı kullanımı yapılabilmesidir. </p> </div>