Bu sayfanın seçili sürümü ile mevcut sürümü arasındaki farkları gösterir.
en:esya:xades:konfigurasyon [2013/09/11 07:22] Dindar Öz oluşturuldu |
en:esya:xades:konfigurasyon [2013/09/11 08:02] (mevcut) Dindar Öz |
||
---|---|---|---|
Satır 1: | Satır 1: | ||
- | ====== XML İmza Konfigürasyonu ====== | + | ====== XML Signature Configuration ====== |
- | 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. | + | XML Signature API has a configuration file storing the settings for signature creation and verification. |
+ | The configuration file contains proxy settings, timestamp server settings, resolver interfaces, default algorithms, and validation settings. | ||
<sxh xml> | <sxh xml> | ||
Satır 8: | Satır 9: | ||
</sxh> | </sxh> | ||
- | XML imza konfigürasyonu, ''xml-signature-config'' kök elemanı ile başlar. | + | XML signature configuration starts with the root element''xml-signature-config''. |
- | ===== Yerelleştirme ===== | ||
- | Yerelleştirme seçenekleri, locale elementi ile ayarlanır. | + | ===== Localization ===== |
+ | |||
+ | Localization properties are defined within ''locale''. | ||
<sxh xml> | <sxh xml> | ||
Satır 18: | Satır 20: | ||
</sxh> | </sxh> | ||
- | ===== Proxy Ayarları ===== | + | ===== Proxy Settings ===== |
<sxh xml> | <sxh xml> | ||
Satır 32: | Satır 34: | ||
</sxh> | </sxh> | ||
- | Eğer proxy üzerinden bağlantı kurulacaksa ilgili ayarlar http elementi ile yapılır. | + | If proxy is used then the related configuration is performed within ''http''. |
- | ===== Kaynak Çözücüler ===== | + | |
+ | |||
+ | ===== Resolvers ===== | ||
<sxh xml> | <sxh xml> | ||
Satır 45: | Satır 49: | ||
</sxh> | </sxh> | ||
- | 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. | + | In the element, the classes used to resolve the urls included in the signature. For a standart usage the resolvers lister here is sufficient. For custom protocoles, the interface IResolver must be implemented and added to ''resolver'' in the configuration file. For exapmle, if you want to store a data corresponding to a uri ina database, you can implement a DatabaseResolver class. |
<sxh java> | <sxh java> | ||
Satır 54: | Satır 58: | ||
</sxh> | </sxh> | ||
- | ===== Zaman Damgası ===== | + | ===== Timestamp ===== |
<sxh xml> | <sxh xml> | ||
Satır 64: | Satır 68: | ||
</sxh> | </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. | + | Userid and password are for the timestamp taken from ESYA Timestamp server. For other timestamp services, leave these fields empty. |
- | ===== Varsayılan Algoritmalar ===== | + | |
+ | ===== Default Algorithms ===== | ||
<sxh xml> | <sxh xml> | ||
Satır 73: | Satır 78: | ||
</sxh> | </sxh> | ||
- | ===== Doğrulama Parametreleri ===== | + | ===== Validation Parameters ===== |
<sxh xml> | <sxh xml> | ||
Satır 98: | Satır 103: | ||
</sxh> | </sxh> | ||
- | ^ certificate-validation-policy-file | Sertifika doğrulamada kullanılacak konfigürasyon. 'for' attribute'u kullanılmazsa default politika olur. Bu attribute içinde ''QualifiedCertificate'', ''MaliMuhurCertificate'', ''TimeStampingCertificate'' değerlerinden biri kullanılarak sertifika tipine göre doğrulama politikası vermek mümkündür. | | + | ^ certificate-validation-policy-file | The policy file for certificate validation. If the attribute 'for' is not used then it is the default policy. By assigining the attribute 'for' to different values like ''QualifiedCertificate'', ''MaliMuhurCertificate'', and ''TimeStampingCertificate'', you can define different policys for each type of certificate respectively. | |
- | ^ grace-period-in-seconds | Saniye cinsinden grace period. Grace period doğrulama verisinin olgunlaşması için beklenmesi gereken süredir. | | + | ^ grace-period-in-seconds | The grace period in terms of seconds. Grace period is the time for the signature verification to be performed securely. | |
- | ^ last-revocation-period-in-seconds | Doğrulama verisinin üretim zamanı ile, doğrulama zamanı arasında ne kadar süre olabileceği | | + | ^ last-revocation-period-in-seconds | The largest time difference betweent the creation of validation data and the validation. | |
- | ^ force-strict-reference-use | Referanslarla işaret edilen iptal bilgisi doğrulamada kullanılmalı. Güvenlik açısından normal şartlarda bu değer true olmalıdır. | | + | ^ force-strict-reference-use | Indicates that the revocation data referenced in the signed document must be used in the certificate validation. For security purposes, this parameter should be ''true''. | |
- | ^ use-validation-data-published-after-creation | 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. | | + | ^ use-validation-data-published-after-creation | Indicates that the validation data must be created after the signing time .Default value is ''true''. For a secure validation the validation data must be created after the signing time. | |
- | ===== Doğrulayıcılar ===== | + | ===== Validators ===== |
- | XML İmza doğrulayıcı sınıflar ''validation''/''validators'' 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. | + | XML Signature validator classes are located within ''validation''/''validators''. Normally, you do not have to modify the content of this element if you are not developing custom validators. See the sample configurations for custom validators. The one important thing is that the attribute "inherit-validators-from" is used to define common validators for different profiles. |