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

<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 <a href="http://www.etsi.org/deliver/etsi_ts/101700_101799/101733/02.02.01_60/ts_101733v020201p.pdf" class="urlextern" title="http://www.etsi.org/deliver/etsi_ts/101700_101799/101733/02.02.01_60/ts_101733v020201p.pdf"  rel="nofollow">TS ETSI 101 733</a> dökümanına bakınız.
</p>

</div>

<h3>BES</h3>
<div class="level3">

<p>
BES imza, en basit imza türüdür. BES imza sadece  o kişinin imzayı attığını garanti eder. İmza zamanı 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.
</p>

<p>
<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 href="/esya-api/doku.php?id=esya:cades:imza-zamani" class="wikilink1" title="esya:cades:imza-zamani">buradaki </a> örnek kod kullanılabilir.
</p>

<p>
Beyan edilen zamanın kullanımında oluşabilecek kötü senaryo aşağıdaki gibidir. İmza atıldığı sırada imzacı sertifikası iptal edilmiştir, fakat 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" title=" Şekil 16 Yanlış Beyan İle Kötü Kullanım Senaryosu" alt=" Şekil 16 Yanlış Beyan İle Kötü Kullanım Senaryosu" /></a>
</p>

</div>

<h3>EST</h3>
<div class="level3">

<p>
EST imza, BES imzadan türemiştir. İçerisinde imzalama zamanını gösteren zaman damgası bulundurmaktadır. İmza atı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. İmza zamanını almak için <a href="/esya-api/doku.php?id=esya:cades:imza-zamani" class="wikilink1" title="esya:cades:imza-zamani">buradaki </a> örnek kod kullanılabilir. 
</p>

</div>

<h3>ESXLong</h3>
<div class="level3">

<p>
ESXLong imza aynı zamanda bir EST  imzadır. ESXLong imza, EST imzadan farklı olarak imza içerisinde sertifika doğrulamada kullanılacak olan 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>

<h3>ESA</h3>
<div class="level3">

<p>
ESA imza 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.  Fakat 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ı da imza üzerinde değişiklik yapılmasını engellemek olabilir. ESA ile imzacının altındaki tüm seri imzalar korunur. Bu yüzden seri imzalar için ayrıca arşiv zaman damgası almaya gerek yoktur. 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 olabilir. Arşiv zaman damgası v2 özelliği bulunduran ES-A tipindeki imzada, yeni bir seri imza yahut doğrulama verisi de imzaya eklenemez. Arşiv zaman damgası v3 özelliği bulunduran ES-A tipindeki imzada ise, bu eklemeler yapılabilir.
</p>

<p>
Bir imza atılırken ESA tipinde atılamaz. Öncelikle başka  bir tipte atılmalı, daha  sonra ESA  tipine çevrilmelidir. 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
