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>Akıllı Kartan Sertifikanın Okunması</h2> <div class="level2"> <p> Akıllı karttan sertifika <code>SmartCard</code> sınıfının <code>getSignatureCertificates()</code> veya <code>getEncryptionCertificates()</code> fonksiyonları ile okunabilir. Eğer imzalama işlemi yapılacaksa <code>getSignatureCertificates()</code> fonksiyonu, şifreleme işlemi yapılacaksa <code>getEncryptionCertificates()</code> fonksiyonu kullanılmalıdır.Bu fonksiyonlar sertifikaların kodlanmış hallerini byte [] olarak dönerler. Eğer ESYA API-ASN modülünü (ma3api-asn-….jar / ma3api-asn.dll) kullanabiliyorsanız, karttan aldığınız byte değerlerini anlamlı hale getirmek için <code>ECertificate</code> sınıfını kullanabilirsiniz. </p> <p> Atılacak imzanın kanuni yükümlülüklerinin olması için imzalamada kullanılan sertifikanın nitelikli olması gerekmektedir. Bu kontrol <code>ECertificate</code> sınıfının <code>isQualifiedCertificate()</code> fonksiyonu ile yapılabilir. <code>ECertificate</code> sınıfının <code>getSubject().stringValue()</code> fonksiyonu ile sertifikalar birbirinden ayırt edilebilir. Kullanıcı bu bilgi ile seçim yapabilir. </p> <p> Ayrıca <code>ECertificate</code> sınıfının <code>getSubject().getCommonNameAttribute()</code> fonksiyonu, sertifika sahibinin ismini dönmektedir. Karttaki sertifikaların isim bilgisi, tüm sertifikalar için aynı olacağından, karttaki sertifikaları ayırt etmek amacıyla kullanılamaz. İmzayı kimin attığını göstermek için kullanılabilir. </p> <p> Aşağıdaki kod bloğu akıllı kart içinden imzalama sertifikalarını alır ve nitelikli olanların subject alanını ekrana yazar. </p> <p> <em><</em>sxh java;title:Java> List<em><</em>byte []> certs = smartCard.getSignatureCertificates(session); for (byte[] bs : certs) { </p> <pre class="code">ECertificate cert = new ECertificate(bs); if(cert.isQualifiedCertificate()) System.out.println(cert.getSubject().stringValue()); </pre><p> </p> <p> } <em><</em>/sxh> </p> <p> <em><</em>sxh csharp;title:C#> List<em><</em>byte[]> certBytes = sc.getSignatureCertificates(session); foreach (byte[] bs in certBytes) { ECertificate cert = new ECertificate(bs); <em>cert.isQualifiedCertificate() Console.WriteLine(cert.getSubject().getCommonNameAttribute()); } </em><<em>/sxh> Eğer ESYA API-ASN sınıflarına erişim yoksa, <code>ECertificate</code> yerine java'nın <code>x509Certificate</code> sınıfı kullanılabilir. <code>ECertificate</code> sınıfının <code>isQualifiedCertificate()</code> fonksiyonu yerine aşağıdaki örnek kodda gösterildiği gibi kontrol yapılabilir. Sertifikaları birbirinden ayırt etmek amacıyla <code>x509Certificate</code> sınıfının <code>getSubjectDN().toString()</code> metodu kullanılabilir. Aşağıdaki kod bloğu akıllı kart içinden imzalama sertifikalarını alır ve nitelikli olanların Subject alanını ekrana yazar. </em><<em>sxh java;title:Java> List</em><<em>byte []> certs = smartCard.getSignatureCertificates(session); CertificateFactory cf = CertificateFactory.getInstance("X.509"); String qcStatement = "1.3.6.1.5.5.7.1.3"; for (byte[] bs : certs) { X509Certificate cert = (X509Certificate)cf.generateCertificate(new ByteArrayInputStream(bs)); if( cert.getExtensionValue(qcStatement) != null) System.out.println(cert.getSubjectDN().toString()); } </em><<em>/sxh> ==== Akıllı Karttaki Nesne Adlarının Okunması ==== Akıllı kartta bulunan sertifika, açık anahtar ve özel anahtarın her biri nesne olarak adlandırılır. Akıllı karttaki nesnelerin adı ile de işlem yapılabilir. Nesne adları değişken olabileceğinden nesne adları ile işlem yapmak önerilmez. Yalnız bazı durumlarda nesne adları kullanıcıya daha anlamlı gelebilir. <code>SmartCard</code> sınıfının <code>getSignatureKeyLabels(…)</code> ve <code>getEncryptionKeyLabels(…)</code> fonksiyonları ile anahtarların adları okunabilir. Eğer anahtarın, sertifikasının adı anahtarla aynı ise bu ad ile sertifika da okunabilir. Sertifikanın okunması için <code>readCertificate(long aSessionID,String aLabel)</code> fonksiyonu kullanılabilir. </p> </div>