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.

<h2>Parameters</h2> <div class="level2"> <p> API needs some parameters for signature creation and verification operations which differ according to the signature type. The following table lists basic parameters and their usage. For the complete list, see <code>EParameters</code>. </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="col0"> <b>P_EXTERNAL_CONTENT</b> </td><td class="col1 leftalign"> The content that is signed. It must be an object of <code>ISignable</code> </td> </tr> <tr class="row1"> <td class="col0"> <b>P_CONTENT_TYPE</b> </td><td class="col1"> The content type. By default, it is "1, 2, 840, 113549, 1, 7, 1" which means "data".</td> </tr> <tr class="row2"> <td class="col0"> <b>P_CERT_VALIDATION_POLICY</b> </td><td class="col1"> Certificate Validation Policy to be used in validation of signing certificate. If the parameter <code>P_CERT_VALIDATION_POLICIES</code> is used or the parameter <code>P_VALIDATE_CERTIFICATE_BEFORE_SIGNING</code> has the value <code>false</code> then this parameter is not necessary. </td> </tr> <tr class="row3"> <td class="col0"> <b>P_CERT_VALIDATION_POLICIES</b> </td><td class="col1"> Certificate Validation Policies for different types of certificates. By using this parameter, several types of certificates (i.e. qualified certificates, timestamp certificate etc.) can be validated together. </td> </tr> <tr class="row4"> <td class="col0"> <b>P_SIGNING_TIME</b> </td><td class="col1"> Signing time. It is used only if the signature does not have timestamp. For example, a BES signature was received at a certain time. This time can be stored at somewhere and used in this parameter upon future validations. This parameter has no legal meaning. </td> </tr> <tr class="row5"> <td class="col0"> <b>P_TRUST_SIGNINGTIMEATTR</b> </td><td class="col1"> It is used for verification which indicates if the stated time information in the signing time attribute is trusted. It is <code>boolean</code> and has the default value <code>true</code>. If the signing time information stated by the user is not trusted then this parameter must be <code>false</code>. </td> </tr> <tr class="row6"> <td class="col0"> <b>P_TSS_INFO</b> </td><td class="col1"> İmza atarken zaman damgası (Time Stamp) kullanılacaksa, <code>TSSettings</code> tipinde bir nesne atanmalıdır. EST ve üzeri imza tiplerinde zaman damgası kullanılması mecburidir. </td> </tr> <tr class="row7"> <td class="col0"> <b>P_POLICY_ID</b> </td><td class="col1"> Birbirinden bağımsız iki taraf, imzaların nasıl doğrulanacağı konusunda kendi aralarında çeşitli politikalar belirleyebilirler.Fakat imzanın hangi politika ile doğrulanacağı bilgisini imzalanmış dosyaya eklemeleri gerekmektedir. Bunun için varsayılan davranış olarak SignaturePolicyIdentifierAttr imzaya eklenmelidir. <code>P_POLICY_ID</code> parametresi ise kullanılacak politikaya işaret eder. </td> </tr> <tr class="row8"> <td class="col0"> <b>P_POLICY_VALUE</b> </td><td class="col1"> <code>P_POLICY_ID </code> parametresinde anlatıldığı gibi bir politika belirleneceği zaman kullanılır. Kullanılacak politikaya işaret eder. </td> </tr> <tr class="row9"> <td class="col0"> <b>P_POLICY_DIGEST_ALGORITHM</b> </td><td class="col1"> <code>P_POLICY_ID</code> parametresinde anlatıldığı gibi bir politika belirleneceği zaman kullanılır. SignaturePolicyIdentifierAttr imzalanan bir özellik olduğundan, imzalanması sırasında kullanılacak özet bilgisini işaret eder. Varsayılan değer SHA-256'dir. </td> </tr> <tr class="row10"> <td class="col0"> <b>P_INITIAL_CERTIFICATES</b> </td><td class="col1"> İmzalanın doğrulanmasıiçin gerekli olabilecek sertifikaları işaret eder. </td> </tr> <tr class="row11"> <td class="col0"> <b>P_INITIAL_CRLS</b> </td><td class="col1"> İmzalanın doğrulanması için gerekli olabilecek SİL’leri işaret eder. </td> </tr> <tr class="row12"> <td class="col0"> <b>P_INITIAL_OCSP_RESPONSES</b> </td><td class="col1"> İmzalanın doğrulanması için gerekli olabilecek ÇisDuP cevaplarına işaret eder. </td> </tr> <tr class="row13"> <td class="col0"> <b>P_VALIDATE_CERTIFICATE_BEFORE_SIGNING</b> </td><td class="col1"> Varsayılan durumda imza atarken ve imza doğrulaması yaparken sertifika doğrulaması yapılmaktadır. BES ve EST türü imza atarken sertifika doğrulaması, bu parametreye false verilerek es geçilebilir. Yalnız bu kullanım önerilmemektedir. </td> </tr> <tr class="row14"> <td class="col0"> <b>P_REFERENCE_DIGEST_ALG</b> </td><td class="col1"> SigningCertificateV1/V2, CompleteCertificateReferences, CompleteRevocationReferences özellikleri için kullanılacak özet algoritmasını belirler. </td> </tr> <tr class="row15"> <td class="col0"><b> P_GRACE_PERIOD</b> </td><td class="col1"> Sertifika doğrulama verisinin kesinleşmesi için geçecek kesinleşme süresini saniye olarak belirtir. Varsayılan değeri 86400 saniyedir. (24 saat) </td> </tr> <tr class="row16"> <td class="col0"><b> P_REVOCINFO_PERIOD</b> </td><td class="col1"> Sertifika doğrulama verisinin hangi süre aralığında toplanacağını saniye olarak belirtir. Örneğin bu süre 2 günü işaret ediyorsa; imzanın atıldığı tarihten 2 gün sonrasına kadarki sürede geçerli olan doğrulama verisi sertifika doğrulamada kullanılır. Bu süre en az <code>P_GRACE_PERIOD</code> süresi kadar olmalıdır.Eğer <code>P_REVOCINFO_PERIOD</code> parametresine herhangi bir süre verilmezse, bu süre mümkün olduğunca geniş tutulmaya çalışılacaktır. Bu sürenin geniş tutulması sertifika iptal durumlarının yakalanmasında bir dezavantaj getirmez. Bu aralığın kısa tutulması ise askı durumlarının yakalanma ihtimalini arttırır. </td> </tr> <tr class="row17"> <td class="col0"> <b>P_FORCE_STRICT_REFERENCE_USE</b> </td><td class="col1"> İmzada sertifika doğrulama verisi veya referansı varsa, sadece bu referansları ve bu referanslara ait verilerin doğrulama için kullanılacağını belirtir. Ayrıca bu kontrol, doğrulama verileri ve sertifika referanslarının sırasını da kontrol eder. </td> </tr> <tr class="row18"> <td class="col0"> <b>P_VALIDATE_TIMESTAMP_WHILE_SIGNING</b> </td><td class="col1"> Zaman damgası içeren imzalarda, imzalama esnasında alınan zaman damgasının kontrol edilmesini sağlar. </td> </tr> </table> <span class='np_break'> </span> </div> </div>