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>Android Platformunda Eİmza</h2> <div class="level2"> <p> Android sisteminde temel imza formatında (BES) imza oluşturulabilmektedir. Mevcut sürümde yalnızca AKİS marka kart ve CCID(Chip/Smart Card Interface Devices) standardına uyumlu kart okuyucular ile imza oluşturulabilmektedir. </p> <p> Android sisteminde imza oluşturulurken kart ile iletişim apdu komutları üzerinden sağlanmaktadır.İmzalama işlemleri için <code>APDUSmartCard</code> sınıfı uygun parametrelerle oluşturulmakta ve <code>getSigner()</code> metodunda alınan <code>BaseSigner</code> nesnesi imzalamada kullanılmaktadır. İmzalama işlemlerinde kullanılacak olan <code>APDUSmartCard</code> sınıfı oluşturulurken, uygun <code>TerminalHandler</code> sınıfı oluşturulmalı ve kullanılmalıdır. Kartla yapılan işlemlerde, android sistemi ilk kullanımda, karta erişmek için kullanıcıdan usb erişim onayı istemektedir. Bu onay ekranının görülebilmesi ve düzgün çalışması amacıyla <code>SCDTerminalHandler</code> sınıfına usb erişim hakları için oluşturulmuş bir android sınıfı olan <code>PendingIntent</code> nesnesi verilmelidir. Android sistemindeki benzer akışlardan dolayı kart işlemleri doğrudan ana gui sınıfında yapılmamalı, AsyncTask sınıfından türetilen bir sınıf içerisinde işlemler yapılmalıdır. Bununla ilgili kullanım örnek kodlardan görülebilir. </p> <p> Takılı olan kart okuyucudaki sertifikaları listeleyen ve seçilen dosyayı imzalayan örnek bir android uygulaması(eclipse projesi olarak) paket içerisinde bulunmaktadır. İmzalama için gerekli jar dosyaları bu örnek eclipse projesine bakılarak görülebilir. </p> <p> Android imzada test lisansı ile çalışırken sadece test sertifikaları ile işlem yapılabilecek ve işlemlerde 5 sn’lik bir gecikme yaşanacaktır. </p> <p> Yukarıda bahsedilen akışla ilgili örnek bir fonksiyon aşağıdadır. Kod içerisinde gerekli kısımlarda yorumlar bulunmaktadır. <em><</em>sxh java> public void signWithFirstCertificate() </p> <pre class="code"> { try { //Burada gömülü lisans dosyası yüklenmektedir. Resources res = getResources(); InputStream lisansStream = res.openRawResource(R.raw.lisans_test); LicenseUtil.setLicenseXml(lisansStream); lisansStream.close(); Activity callerActivity = this; //SCDTerminalHandler oluşturulurken bunu çağıran Activity parametre olarak verilmelidir. //Kullanıcıdan usb erişim onayı alınabilmesi için oluşturulmuş olan PendingIntent nesnesi terminal handler sınıfına verilmelidir. PendingIntent permissionIntent = PendingIntent.getBroadcast(callerActivity, 0, new Intent("tr.gov.tubitak.bilgem.esya.android.signexample.USB_PERMISSION"), 0); SCDTerminalHandler terminalHandler = new SCDTerminalHandler(callerActivity,permissionIntent); //APDUSmartCard sınıfı uygun TerminalHandler sınıfı ile çağrılmalıdır. APDUSmartCard apduSmartCard = new APDUSmartCard(terminalHandler); //Akis kart iletişimi için SecureMessaging devre dışı bırakılmalıdır. apduSmartCard.setDisableSecureMessaging(true); //Bağlı kart okuyucular okunuyor. CardTerminal[] terminalList = apduSmartCard.getTerminalList(); if(terminalList == null || terminalList.length == 0) { throw new Exception("Bağlı kart okuyucu sayısı 0"); } CardTerminal cardTerminal = terminalList[0]; apduSmartCard.openSession(cardTerminal); //İlk kart okuyucudan sertifika listesi alınıyor. List&lt;byte[]&gt; signCertValueList = apduSmartCard.getSignatureCertificates(); if(signCertValueList == null || signCertValueList.size() == 0) { throw new Exception("Kart içerisinde sertifika sayısı 0"); } //İlk sertifika ile işlem yapılacak. ECertificate signingCert = new ECertificate(signCertValueList.get(0)); String cardPin = "511661"; apduSmartCard.login(cardPin); //İmzalamada kullanılacak BaseSigner APDUSmartCard2 sınıfından alınıyor. BaseSigner signer = apduSmartCard.getSigner(signingCert.asX509Certificate(), Algorithms.SIGNATURE_RSA_SHA1); BaseSignedData bsd = new BaseSignedData(); //Dosya imzalanmak istenirse //İmzalanacak olan dosya yolu //String sourceFilePath = "/tmp/TextForSign.txt"; //ISignable content = new SignableFile(new File(sourceFilePath)); //Veri imzalanacak. ISignable content = new SignableByteArray("ImzalanacakVeri".getBytes()); bsd.addContent(content); //Since SigningTime attribute is optional,add it to optional attributes list List&lt;IAttribute&gt; optionalAttributes = new ArrayList&lt;IAttribute&gt;(); optionalAttributes.add(new SigningTimeAttr(Calendar.getInstance())); HashMap&lt;String, Object&gt; params = new HashMap&lt;String, Object&gt;(); //Android ile imza atılırken sertifika kontrolü devre dışı bırakılmalıdır. //Mevcut sürümde sertifika doğrulama desteği bulunmamaktadır. params.put(EParameters.P_VALIDATE_CERTIFICATE_BEFORE_SIGNING,false); bsd.addSigner(ESignatureType.TYPE_BES, signingCert, signer, optionalAttributes, params); byte [] signedData = bsd.getEncoded(); System.out.println("******** İmzalı Veri *********"); System.out.println(Base64.encode(signedData)); System.out.println("******************************"); // Eğer imzalı hali dosyaya yazılmak istenirse //String destFilePath = sourceFilePath+ ".imz"; //İmzalı hali dosyaya yazılıyor. //AsnIO.dosyayaz(signedData, destFilePath); apduSmartCard.logout(); apduSmartCard.closeSession(); } catch (Exception e) { e.printStackTrace(); } } </pre><p> </p> <p> <em><</em>/sxh> </p> </div>