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>Farklı İmza Tiplerinin Oluşturulması</h1>
<div class="level1">

<p>
API  tarafından  desteklenen  imza  tiplerinden   çok   kullanılanları  hakkında  kısa açıklamaları burada bulabilirsiniz. Hangi imzanın size uygun  olduğuna karar  vermek için "E- imza Profilleri" dökümanını inceleyebilirsiniz. İmza tipleri hakkında daha  geniş bilgi için ise "ETSI TS 101 733" dökümanına bakınız.
</p>

</div>

<h2>BES</h2>
<div class="level2">

<p>
BES imza, en basit imza türüdür. BES, imza sadece  o kişinin imzayı attığını garanti eder. İmza zamanıda belli olmadığından ancak  sertifika geçerli iken imza doğrulanabilir. Sertifika iptal edildiğinde veya  sertifika süresi dolduğunda imza doğrulanamaz. BES  imza içersine zaman bilgisi eklenebilir, eklenen zamanın herhangi bir hukuki yükümlülüğü, kesinliği yoktur. Beyan edilen zaman şeklinde kullanılabilir.
<em><</em>sxh java;title:Java>
BaseSignedData bs = new BaseSignedData();		
bs.addContent(new SignableByteArray("test".getBytes())); 
</p>

<p>
<em>Since SigningTime attribute is optional,add it to optional attributes list
List</em><<em>IAttribute> optionalAttributes = new ArrayList</em><<em>IAttribute>();
optionalAttributes.add(new SigningTimeAttr(Calendar.getInstance()));
			
HashMap</em><<em>String, Object> params = new HashMap</em><<em>String, Object>();
params.put(EParameters.P_CERT_VALIDATION_POLICY, VALIDATION_POLICY);
				
bs.addSigner(ESignatureType.TYPE_BES, cert, signer, optionalAttributes, params);
</em><<em>/sxh>

</em><<em>sxh csharp;title:C#>
BaseSignedData bs = new BaseSignedData();
bs.addContent(new SignableByteArray(Encoding.ASCII.GetBytes("test")));

</em>Since SigningTime attribute is optional,add it to optional attributes list
List<em><</em>IAttribute> optionalAttributes = new List<em><</em>IAttribute>();
optionalAttributes.Add(new SigningTimeAttr(DateTime.UtcNow));
</p>

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

<p>
bs.addSigner(ESignatureType.TYPE_BES, cert, signer, optionalAttributes, params_);
<em><</em>/sxh>
</p>

<p>
İmzanın beyan edilen zamanını almak için aşağıdaki örnek kod kullanılabilir.
</p>

<p>
<em><</em>sxh java;title:Java>
byte[] input = AsnIO.dosyadanOKU(BESwithSIGNING_TIME);
BaseSignedData bs = new BaseSignedData(input);
List<em><</em>EAttribute> attrs = 
</p>
<pre class="code">                bs.getSignerList().get(0).getSignedAttribute(SigningTimeAttr.OID);

</pre><p> </p>

<p>
Calendar time = SigningTimeAttr.toTime(attrs.get(0));
System.out.println(time.getTime().toString());
<em><</em>/sxh>
<em><</em>sxh csharp;title:C#>
byte[] input = AsnIO.dosyadanOKU(BESwithSIGNING_TIME);
BaseSignedData bs = new BaseSignedData(input);
List<em><</em>EAttribute> attrs = bs.getSignerList()[0].
</p>
<pre class="code">                          getSignedAttribute(AttributeOIDs.id_signingTime);

</pre><p> </p>

<p>
DateTime? time = SigningTimeAttr.toTime(attrs[0]);
Console.WriteLine(time.Value.ToString());
<em><</em>/sxh>
</p>

<p>
Beyan edilen zamanın kullanımında oluşabilecek kötü senaryo Şekil 17’daki gibidir. İmza atıldığı sırada imzacı sertifikası iptal edilmiştir; yalnız kullanıcı imza zamanı olarak daha önceki bir zamanı beyan etmiştir. Beyan edilen zamana güvenildiği durumda geçersiz olan bu imza doğrulanacaktır.
</p>

<p>
<a href="/esya-api/lib/exe/detail.php?id=esya%3Acades%3Aimza-tipleri&media=esya:cades:cades.png" class="media" title="esya:cades:cades.png"><img src="/esya-api/lib/exe/fetch.php?media=esya:cades:cades.png" class="mediacenter" alt="" /></a>
Şekil 17 Yanlış Beyan İle Kötü Kullanım Senaryosu
</p>

</div>

<h2>EST</h2>
<div class="level2">

<p>
ESTimza, BESimzadan türemiştir. İçerisinde imzalama zamanını gösterir zaman damgası bulundurmaktadır. İmzaatılırken zaman damgası ayarlarının verilmesi gerekmektedir. Aşağıdaki örnek kodda bir EST imzanın nasıl atılacağını bulabilirsiniz.
</p>

<p>
<em><</em>sxh java;title:Java>
BaseSignedData bs = new BaseSignedData();		
bs.addContent(new SignableByteArray("test".getBytes()));
</p>

<p>
HashMap<em><</em>String, Object> params = new HashMap<em><</em>String, Object>();		
<em>ilerli for getting signaturetimestamp
TSSettings tsSettings = new TSSettings("http:</em>zd.ug.net", 21,
"12345678".toCharArray(),DigestAlg.SHA1);
params.put(EParameters.P_TSS_INFO, tsSettings);	
params.put(EParameters.P_CERT_VALIDATION_POLICY, TestConstants.getPolicy());
</p>

<p>
<em>add signer
bs.addSigner(ESignatureType.TYPE_EST, cert, signer, null, params);
</em><<em>/sxh>

</em><<em>sxh csharp;title:C#>
BaseSignedData bs = new BaseSignedData();
bs.addContent(new SignableByteArray(Encoding.ASCII.GetBytes("test")));
Dictionary</em><<em>String, Object> params_ = new Dictionary</em><<em>String, Object>();
</em>ilerli for getting signaturetimestamp
TSSettings tsSettings = new TSSettings("http:<em>zd.ug.net", 21, "12345678",,DigestAlg.SHA1);
params_[EParameters.P_TSS_INFO] = tsSettings;
params_[EParameters.P_CERT_VALIDATION_POLICY] = TestConstants.getPolicy();

</em>add signer
bs.addSigner(ESignatureType.TYPE_EST, cert, signer, null, params_);
<em><</em>/sxh>
</p>

<p>
İmza zamanı belli olduğundan, BES  tipi imzadan farklı olarak sertifika doğrulamada kesin sonuçlara ulaşılabilir. Aşağıdaki örnek kod ile imza zamanını alabilirsiniz.
</p>

<p>
<em><</em>sxh java;title:Java>
BaseSignedData bs = new BaseSignedData(input);
EST estSign = (EST)bs.getSignerList().get(0);
Calendar time = estSign.getTime();
System.out.println(time.getTime().toString());
<em><</em>/sxh>
<em><</em>sxh csharp;title:C#>
BaseSignedData bs = new BaseSignedData(input);
EST estSign = (EST)bs.getSignerList()[0];
Console.WriteLine(time.Value.ToString());
DateTime? time = estSign.getTime();
<em><</em>/sxh>
</p>

</div>

<h2>ESXLong</h2>
<div class="level2">

<p>
ESXLong imza aynı zamanda bir EST  imzadır. ESXLong, ESTimzadan farklı olarak imza içerisinde sertifika doğrulamada kullanılacak doğrulama verisini içerir. . Bundan dolayı ESXLong imza atılırken veya bir imza ESXLong’a çevrilirken sertifika doğrulama işlemi yapılmak zorundadır. Sertifika  ömrü   dolduktan  sonra   doğrulamada kullanılacak veriye ulaşmada sorunlar çıkabilir.  ESXLong imza doğrulama verisini içinde barındırdığından bu tür sorunların çıkmasını engeller.EST imza atılırken kullanılan örnek kodun aynısı sadece eklenecek imza türü değiştirilerek kullanılabilir.
</p>

</div>

<h2>ESA</h2>
<div class="level2">

<p>
ESA  tipi kriptografik algoritmaların zamanla güvenilirliğini  kaybetmesine karşı geliştirilmiş bir imza türüdür. Şu anda  güvenerek kullandığımız  algoritmalar, 5-10  yıl sonra güvenilemez olabilir. Bu  algoritmalar güvenilmez duruma geçmeden önce, imzaların ESA tipine  çevrilmesi  gerekmektedir.  Yalnız  imza  atıldıktan  hemen sonra   imzanın  ESA'ya çevrilmesi fazladan bir güvenlik sağlamaz. Algoritmaların bir  kısmı güvenilmez duruma geçerken, daha  güvenilir yeni algoritmalar kullanılmaya  başlanacaktır. ESA  tipine çevrim sırasında bu yeni algoritmalar kullanılmalıdır.
</p>

<p>
ESA'yı kullanmanın bir diğer amacı imza üzerinde değişiklik yapılmasını engellemek olabilir. Eğer   seri imza kullanılıyorsa;  ESA'ya çevrilen imzanın  altındaki  imzaların  veri yapısında bir değişiklik yapılamaz. Bu  değişiklikler  imza türünün değiştirilmesi,  imzanın silinmesi, yeni imza eklenmesi olabilir.
</p>

<p>
Bir imza atılırken ESA tipinde atılamaz. Öncelikle başka  bir tipte atılmalı, daha  sonra ESA  tipine çevrilmelidir. Nasıl yapılacağına <a href="/esya-api/doku.php?id=esya:cades:imza-donusum" class="wikilink1" title="esya:cades:imza-donusum">İmza Tipleri Arasında Dönüşüm</a> bölümünden bakabilirsiniz.
</p>

<p>
ESA  tipine dönüşüm sırasında arşiv tipi zaman  damgası kullanılmaktadır.  Bundan dolayı parametreler yardımıyla zaman damgası ayarları verilmelidir.
</p>

<p>
<em><</em>sxh java;title:Java>
byte [] signatureFile = AsnIO.dosyadanOKU(TestConstants.getDirectory() +  "testdata/ESXLong-1.p7s");
BaseSignedData bs = new BaseSignedData(signatureFile);
</p>

<p>
Map<em><</em>String,Object>parameters = new HashMap<em><</em>String, Object>();
</p>

<p>
<em>Archive time stamp is added to signature, so time stamp settings are needed.
parameters.put(EParameters.P_TSS_INFO, TestConstants.getTSSettings());
parameters.put(EParameters.P_CERT_VALIDATION_POLICY, TestConstants.getPolicy());
		
bs.getSignerList().get(0).convert(ESignatureType.TYPE_ESA, parameters);
		
AsnIO.dosyayaz(bs.getEncoded(), TestConstants.getDirectory()+"testdata/ESA-2.p7s");
</em><<em>/sxh>
</em><<em>sxh csharp;title:C#>
byte[] content = AsnIO.dosyadanOKU(TestConstants.getDirectory() + "testdata<br/>
ESXLong-1.p7s");
BaseSignedData bs = new BaseSignedData(content);

Dictionary</em><<em>String, Object> parameters = new Dictionary</em><<em>String, Object>();

</em>Archive time stamp is added to signature, so time stamp settings are needed.
parameters[EParameters.P_TSS_INFO] = TestConstants.getTSSettings();
parameters[EParameters.P_CERT_VALIDATION_POLICY] = TestConstants.getPolicy();
</p>

<p>
bs.getSignerList()[0].convert(ESignatureType.TYPE_ESA, parameters);
</p>

<p>
AsnIO.dosyayaz(bs.getEncoded(), TestConstants.getDirectory() + "testdata\\ESA-2.p7s");
<em><</em>/sxh>
</p>

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

User Tools

Site Tools

Page Tools
