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> <em><</em>proxy-host><em><</em>/proxy-host> <em><</em>proxy-port><em><</em>/proxy-port> <em><</em>proxy-username><em><</em>/proxy-username> <em><</em>proxy-password><em><</em>/proxy-password> <em><</em>basic-authentication-username><em><</em>/basic-authentication-username> <em><</em>basic-authentication-password><em><</em>/basic-authentication-password> <em><</em>connection-timeout-in-milliseconds>2000<em><</em>/connection-timeout-in-milliseconds> <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> <em><</em>resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.IdResolver"/> <em><</em>resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.DOMResolver"/> <em><</em>resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.HttpResolver"/> <em><</em>resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.XPointerResolver"/> <em><</em>resolver class="tr.gov.tubitak.uekae.esya.api.xmlsignature.resolver.FileResolver"/> <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 { boolean isResolvable(String aURI, Context aContext); Document resolve(String aURI, Context aContext) throws IOException; } <em><</em>/sxh> </p> </div> <h2>Zaman Damgası</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>timestamp-server> <em><</em>host><a href="http://timestamp_server_address//" class="urlextern" title="http://timestamp_server_address//" rel="nofollow">http://timestamp_server_address//</a><<em>/host> </em><<em>userid>fill_id_here</em><<em>/userid> </em><<em>password>pass</em><<em>/password> </em><<em>digest-alg>SHA-1</em><<em>/digest-alg> </em><<em>/timestamp-server> </em><<em>/sxh> Userid ve password alanları ESYA tabanlı zaman damgası içindir. Açık bir zaman damgası servisi için bu alanları boş bırakın. ===== Varsayılan Algoritmalar ===== </em><<em>sxh xml> </em><<em>algorithms> </em><<em>digest-method><a href="http://www.w3.org/2001/04/xmlenc#sha256//" class="urlextern" title="http://www.w3.org/2001/04/xmlenc#sha256//" rel="nofollow">http://www.w3.org/2001/04/xmlenc#sha256//</a><</em>/digest-method> <em><</em>/algorithms> <em><</em>/sxh> </p> </div> <h2>Doğrulama Parametreleri</h2> <div class="level2"> <p> <em><</em>sxh xml> <em><</em>validation> <em><</em>!– default policy for certificate validation –> <em><</em>certificate-validation-policy-file><em>path/to/certval-policy.xml</em><<em>/certificate-validation-policy-file> </em><<em>!– grace period is the time that needs to pass to get exact revocation info–> </em><<em>grace-period-in-seconds>86400</em><<em>/grace-period-in-seconds> </em><<em>!– how old revocation data should be accepted? –> </em><<em>last-revocation-period-in-seconds>172800</em><<em>/last-revocation-period-in-seconds> </em><<em>!– compare resolved policy with the one at policy uri, if indicated –> </em><<em>check-policy-uri>false</em><<em>/check-policy-uri> </em><<em>!– loosening below 2 settings will cause warnings instead of validation failure –> </em><<em>!– referenced validation data must be used for cert validation is set true –> </em><<em>force-strict-reference-use>false</em><<em>/force-strict-reference-use> </em><<em>!– validation data must be published after creation ifs set true, requires grace period for signers –> </em><<em>use-validation-data-published-after-creation>false</em><<em>/use-validation-data-published-after-creation> </em><<em>validators> … </em><<em>/validators> </em><<em>/validation> </em><<em>/sxh> certificate-validation-policy-file: Sertifika doğrulamada kullanılacak konfigürasyon grace-period-in-seconds: Saniye cinsinden grace period. Grace period doğrulama verisnin olgunlaşması için ebklenmesi gereken süredir. last-revocation-period-in-seconds Doğrulama verisinin üretim zamanı ile, doğrulama zamanı arasında ne kadar süre olabileceği force-strict-reference-use: Referanslarla iĢaret edilen iptal bilgisi doğrulamada kullanılmalı. Güvenlik açısında normal şartlarda bu değer true olmalıdır. use-validation-data-published-after-creation:Doğrulama verisinin imza tarihinden sonra üretilmesini şart koş. Default değer true. Sağlıklı ve güevnilir bir imzada doğrulama verisi imza tarihinden sonra yayınlanmış olmalıdır. ===== Doğrulayıcılar ===== 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>