Bu sayfanın seçili sürümü ile mevcut sürümü arasındaki farkları gösterir.
en:esya:ortakimza:imza-api-konfig [2013/08/29 05:49] Dindar Öz oluşturuldu |
en:esya:ortakimza:imza-api-konfig [2013/08/29 06:14] (mevcut) Dindar Öz |
||
---|---|---|---|
Satır 1: | Satır 1: | ||
- | ====== İmza Kütüphanesi Konfigürasyonu ====== | + | ====== API Configuration ====== |
+ | A sample configuration file is coming with ESYA Signature API. By editing this file, signature creation and verification settings can be specified and modified at run-time. | ||
- | Örnek bir imza kütüphanesi konfigürasyonu ESYA İmza Kütüphanesi ile dağıtılmaktadır. Bu konfigürasyon dosyası aracılığı ile imza atma ve doğrulama ayarları yapılmakta ve bu ayarlar çalışma zamanında değiştirilebilmektedir. | + | ===== Language Settings ===== |
- | ===== Dil Ayarları ===== | + | Specifies the language of the API messages. |
- | + | ||
- | API mesajlarının dil ve formatını seçmeye yarar. | + | |
<sxh xml> | <sxh xml> | ||
Satır 12: | Satır 11: | ||
</sxh> | </sxh> | ||
- | ===== Http ve Proxy Ayarları ===== | + | ===== HTTP and Proxy Settings ===== |
- | Eğer kütüphane bir proxy sunucu arkasında çalışacaksa http ayarları bu kısımdan yapılabilir. | + | If the API runs behind a proxy server, then the http settings take place in this section |
<sxh xml> | <sxh xml> | ||
Satır 27: | Satır 26: | ||
</http> | </http> | ||
</sxh> | </sxh> | ||
- | ===== Zaman damgası Sunucusu ===== | + | ===== Timestamp Server ===== |
- | Basit imza(ES-BES)dan daha gelişmiş bir imza tipi kullanılacaksa imzaya çeşitli zaman damgaları eklenmesi gerekmektedir. Zaman damgası ile ilgili ayarlar bu kısımdan yapılır. ESYA Zaman Damgası sunucusu dışında bir zaman damgası kullanılacağı zaman, userid-password alanları boş bırakılabilir. | + | If the signature type is more advanced than the basic electronic signature (ES-BES), then it includes one or more timestamps. Thetimestamp related configuration (i.e timestamp server address etc.) can be performed here. |
+ | You can leave fields ''userid-passwords'' empty if you are using a timestamp server other than ESYA Timestamp Server. | ||
<sxh xml> | <sxh xml> | ||
Satır 41: | Satır 41: | ||
</sxh> | </sxh> | ||
- | ===== Algoritmalar ===== | + | ===== Algorithms ===== |
- | İmzaya eklenecek veriler için hangi özet algoritması kullanılacağı digest-alg, imzada hangi algoritma kullanılacağı ise signature-alg parametresi ile belirlenir. | + | The digest algorithm to be used when creating hash of the content to be signed is determined by ''digest-alg''. |
+ | ''signature-alg'' parameter defines the signature algorithm. | ||
<sxh xml> | <sxh xml> | ||
Satır 52: | Satır 53: | ||
</sxh> | </sxh> | ||
- | ===== Sertifika Doğrulama ===== | + | ===== Certificate Validation ===== |
- | Sertifika doğrulama parametreleri ''<certificate-validation>'' tag'ı içerisinde tanımlanır. | + | Certificate validation parameters are defined within the tag ''<certificate-validation>'' |
- | İlgili parametreler şunlardır: | + | Those parameters are: |
- | ^ certificate-validation-policy-file | sertfika doğrulama konfigürasyon dosyası. '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 | certificate validation policy file. used as default if the attribute 'for' is not used. This attribute can be assigned as ''QualifiedCertificate'', ''MaliMuhurCertificate'', ''TimeStampingCertificate'' to define a policy file according to the certificate type. | |
- | ^ grace-period-in-seconds | SİL(Sertifika İptal Listesi)'in geçerli kabul edilmesi için imza atılma anından en az ne kadar sonra yayınlanmış olması gerektiği | | + | ^ grace-period-in-seconds | The minimum required time the CRL(Certificate Revocation List) must be created after the certificate validation time | |
- | ^ last-revocation-period-in-seconds | imza anından en fazla ne kadar süre sonra yayınlanmış SİL'in geçerli kabul edileceği | | + | ^ last-revocation-period-in-seconds | the maximum time before which the crls published after the certificate validation time are considered as valid. | |
- | ^ use-validation-data-published-after-creation | İptal bilgisinin imza anından sonra yayınlanmış olmasının gerekip gerekmediği | | + | ^ use-validation-data-published-after-creation | The revocation info is required to be published after the signature creation time. | |
- | ^ validate-certificate-before-signing | İmzacı sertifikasının imza atılırken doğrulanıp doğrulanmayacağı. Örneğin kullanıcı sertifikası sisteme girişte doğrulandı ise,her imza atmada sertifikanın tekrar tekrar doğrulanması istenmiyor olabilir. | | + | ^ validate-certificate-before-signing | Validate the signer certificate before signing. For example, you can set this false in order not to repeat validation of the user certificates unnecessarily if you validate once at the system startup. | |
Satır 83: | Satır 84: | ||
</certificate-validation> | </certificate-validation> | ||
</sxh> | </sxh> | ||
- | ===== Parametreler ===== | + | ===== Parameters ===== |
+ | Other validation parameters are define within the tag '<params>'. Those are: | ||
Diğer doğrulama parametreleri ''<params>'' tag'ı içinde belirtilir. Bunlar: | Diğer doğrulama parametreleri ''<params>'' tag'ı içinde belirtilir. Bunlar: | ||
- | **force-strict-reference-use**: Yalnızca imza içindeki doğrulama verileri kullanılsın. | + | **force-strict-reference-use**: Use only the validation data included in the signature. |
- | **check-policy-uri**: Politika temelli imzada imza içindeki politika bilgisinin belirtilen adreste yer alan polikanın özetini taşıdığından emin ol. | + | **check-policy-uri**: Check the policy info in the signature is the digest of the policy info at the specified url. |
- | **validate-timestamp-while-signing**: İmza atılırken alınan zaman damgasını doğrula. | + | **validate-timestamp-while-signing**: Validate the timestamp while creating signature. |
- | **write-referencedvalidationdata-to-file-on-upgrade**: İmza içindeki sertifika doğrulama bilgisini ayrıca dosyalara yaz. (Debug parametresi.) | + | **write-referencedvalidationdata-to-file-on-upgrade**: Write the certificate validation references to a file (For debug purposes) |
<sxh xml> | <sxh xml> |