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>İmza Doğrulama İşlemleri</h2>
<div class="level2">

<p>
İmza doğrulama işlemi birçok kontrolcünün bir araya gelmesiyle yapılmaktadır. Bu kontrolcüler imzanın yapısal kontrollerinden ve sertifika kontrollerinden ulaşmaktadır. Sertifika kontrolleri sertifikanın yapısal kontrollerinden, sertifikanın güvenilir bir kökten verilmiş olmasından ve sertifika iptal kontrolünden oluşmaktadır. Sertifika iptal kontrolü dışında kalan kontroller matematiksel işlemlerden oluşmaktadır, ekstra bir bilgiye ihtiyaç duymamaktadır. Sertifika iptal kontrolü için ise sertifikayı verenin yayınlandığı uygun zamanlı SİL veya ÇİSDUP bilgisine ihtiyaç duyulmaktadır. Sertifika doğrulama işlemi için sertifika doğrulama işleminin konfigurasyonunu barındıran xml formatında politika dosyasına ihtiyaç vardır. Bu xml dosyasıdışında birçok parametre kullanılabilir. Bu parametrelere Parametreler bölümünden veya EParameters sınıfından bakabilirsiniz.
</p>

<p>
 Bir imzalanmış verinin doğrulama işleminden SignedDataValidation sınıfı sorumludur. SignedDataValidation sınıfının  verify(…)   methodu  kullanılarak   imza  doğrulama  işlemi gerçeklenir. verify(…) fonksiyonu imzalanmış verinin byte [] halini ve imzalanmış verinin hangi parametrelere göre  doğrulanacağı bilgisini alır.	SignedDataValidation sınıfındaki verify(…) fonksiyonu ile imzalanmış döküman bir bütün  halinde doğrulanır. İçindeki imzalardan biri doğrulanamamışsa verify(…),  başarısız değer  döner. İmza doğrulama yapan  örnek  kod bloğu;
</p>

<p>
<em><</em>sxh java;title:Java>
byte[] signedData = AsnIO.dosyadanOKU(SIGNATURE_FILE);
ValidationPolicy policy=  PolicyReader.readValidationPolicy(new FileInputStream(POLICY_FILE));
</p>

<p>
Hashtable<em><</em>String, Object> params = new Hashtable<em><</em>String, Object>();
params.put(EParameters.P_CERT_VALIDATION_POLICY, policy);
</p>

<p>
SignedDataValidation sdv = new SignedDataValidation();
</p>

<p>
SignedDataValidationResult sdvr = sdv.verify(signedData, params);
</p>

<p>
if(sdvr.getSDStatus() != SignedData_Status.ALL_VALID)
</p>
<pre class="code">System.out.println("İmzaların hepsi doğrulamadı");		

</pre><p> </p>

<p>
System.out.println(sdvr.toString());
<em><</em>/sxh>
<em><</em>sxh csharp;title:C#>
byte[] signedData = AsnIO.dosyadanOKU(SIGNATURE_FILE);
ValidationPolicy policy = PolicyReader.readValidationPolicy(new FileStream(POLICY_FILE,
FileMode.Open,
FileAccess.Read));
</p>

<p>
Dictionary<em><</em>String, Object> params_ = new Dictionary<em><</em>String, Object>();
params_[EParameters.P_CERT_VALIDATION_POLICY] = policy;
</p>

<p>
SignedDataValidation sdv = new SignedDataValidation();
</p>

<p>
SignedDataValidationResult sdvr = sdv.verify(signedData, params_);
</p>

<p>
if (sdvr.getSDStatus() != SignedData_Status.ALL_VALID)
Console.WriteLine("İmzaların hepsi doğrulamadı");
</p>

<p>
Console.WriteLine(sdvr.ToString());
<em><</em>/sxh>
</p>

<p>
Eğer    imzalanan  içerik   imza	içersinde 	ise	içerik, 	BaseSignedData sınıfının getContent() fonksiyonu ile alınabilir.
</p>

</div>

<h3>İmza Doğrulama Sonucu</h3>
<div class="level3">

<p>
SignedDataValidation sınıfının verify(…)fonksiyonu	doğrulama sonucu olarak SignatureValidationResult tipinde bir nesne  döner. getSDStatus()  fonksiyonu eğer  bütün imzalar doğrulanmış ise ALL_VALID, eğer  imzalardan en az bir tanesi doğrulanamamışsa NOT_ALL_VALID döner.SignedDataValidation nesnesinin toString() methodu bütün imzaların kontrol sonucu açıklamalarını  döner.  Eğer   özellikle  bir  imzanın  sonucu elde edilmek isteniyorsa  imza  ağacında  gezerek  elde  edilebilir.   Bu   ağaç   yapısı,  BaseSignedData yapısındaki imzaların veri yapısı ile aynıdır. Örneğin birinci  paralel imzanın, birinci  seri imzasına ve bu imzanın doğrulama sonucuna aşağıdaki örnek kod ile ulaşılabilir.
</p>

<p>
<em><</em>sxh java;title:Java>
BaseSignedData bs = getBaseSignedData();
SignedDataValidationResult sdvr = getValidationResult();
SignerfirstCounterSigner = bs.getSignerList().get(0).getCounterSigners().get(0);
SignatureValidationResultfirstCounterSignerVR = sdvr.
</p>
<pre class="code">                                                 getSDValidationResults().get(0).
                                                 getCounterSigValidationResults().
                                                 get(0);

</pre><p> </p>

<p>
<em><</em>/sxh>
<em><</em>sxh csharp;title:C#>
BaseSignedData bs = getBaseSignedData();
SignedDataValidationResult sdvr = getValidationResult();
Signer firstCounterSigner = bs.getSignerList()[0].getCounterSigners()[0];
SignatureValidationResult firstCounterSignerVR = sdvr.getSDValidationResults()[0].
</p>
<pre class="code">                                                   getCounterSigValidationResults()[0];

</pre><p> </p>

<p>
<em><</em>/sxh>
</p>

<p>
Herbir imzanın doğrulama sonucu SignatureValidationResult nesnelerinde tutulur. Bir imzacının doğrulama sonucundan seri imzacılarının  doğrulama sonuçlarına da  erişilebilir. SignatureValidationResult nesnelerinin toString()  fonksiyonu imzacının ve  seri imzacıların doğrulama kontrolcülerinin  sonuçlarını  döner. Eğer   sadece   o  imzaya ait  kontrolcülerin açıklamaları elde edilmek isteniyorsa getValidationDetails() fonksiyonunu kullanınız. İmza tipi geliştikçe kontrol edilmesi gereken yapı ve  sertifika artmaktadır. Zaman  damgaları imza yapısına bir imza olarak eklendiklerinden ayrıca bir imza olarak kontrol edilmektedirler.
SignatureValidationResult	nesnesinden	bir 	imzanın 	doğrulama	sonucu getSignatureStatus() fonksiyonu ile Signature_Status yapısında alınabilir. Eğer  imza sonucu INCOMPLETE ise sertifika doğrulama verisine ulaşılamamıştır.
</p>

</div>

<h3>Ön Doğrulama</h3>
<div class="level3">

<p>
Bir  imzanın  doğrulanması için  imza  atıldıktan  sonra   sertifika  iptal  bilgilerinin güncellenebilmesi için belirli  bir süre   geçmesi  gerekmektedir.  Bu  süreye   "kesinleşme süresi"(grace period) denilmektedir. API'de bu  süre  P_GRACE_PERIOD parametresi  ile ayarlanabilir; varsayılan değeri 86400 saniye yani 24 saattir.
</p>

<p>
Bir  imza doğrulanmaya çalışıldığında  kesinleşme süresi geçmese bile  imza ve sertifika doğrulanabilmektedir. Öndoğrulama	denilen bu doğrulama	bir kesinlik içermemektedir. Kesin bir  doğrulama yapılabilmesi için  kesinleşme süresinin  geçmesi gerekmektedir. Bir imzanın doğrulanmasının ön doğrulama olduğunu aşağıdaki örnek  kod ile öğrenebilirsiniz. Ön doğrulama için olgulaşmamış anlamına gelen "PREMATURE" kelimesi, kesinleşmiş imza için olgunlaşmış anlamına gelen "MATURE" kelimesi kullanılmaktadır.
SignatureValidationResultnesnesinin getValidationState()fonksiyonu ile ön doğrulama yapılıp yapılmadığı bilgisi alınabilir.
</p>

<p>
<em><</em>sxh java;title:Java>
SignedDataValidationResultsdvr = getValidationResult();
</p>

<p>
if(sdvr.getSDValidationResults().
</p>
<pre class="code">      get(0).getValidationState() == 	ValidationState.PREMATURE)
System.out.println("Ön doğrulama yapıldı.");

</pre><p> </p>

<p>
<em><</em>/sxh>
<em><</em>sxh csharp;title:C#>
SignedDataValidationResult sdvr = getValidationResult();
if (sdvr.getSDValidationResults()[0].getValidationState() == ValidationState.PREMATURE)
Console.WriteLine("Ön doğrulama yapıldı");
<em><</em>/sxh>
</p>

<p>
Ön doğrulama ile kesin doğrulama arasında doğabilecek fark; ön doğrulama sırasında geçerli olan bir sertifikanın, kesin doğrulamada iptal edilmiş olmasıdır. Kullanıcı akıllı kartını çaldırdığında bu senaryo ile karşılaşılabilir.
ÇiSDuP için kesinleşme süresi kısa olabilmektedir. Yalnız iptal bilgileri  için SİLkullanılıyorsa bu süre uzayabilmekte.
"E-İmza Profilleri" dökümanı ÇiSDuP kullanıldığında  kesinleşme süresinin çok  kısa olduğundan  yok   sayılabileceğini 	öngörüyor.ÇiSDuPkullanarak sertifika doğrulama yapıldığında, kesinleşme süresi kadar beklenmediğinden büyük avantaj sağlanmaktadır.
</p>

</div>
ESYAE-imza Kütüphaneleri

User Tools

Site Tools

Page Tools
