Bu sayfanın seçili sürümü ile mevcut sürümü arasındaki farkları gösterir.
en:esya:cmszarf:cozuculer [2013/09/11 10:39] Dindar Öz |
en:esya:cmszarf:cozuculer [2013/09/11 12:39] (mevcut) Dindar Öz |
||
---|---|---|---|
Satır 1: | Satır 1: | ||
===== Decryption ===== | ===== Decryption ===== | ||
- | The decryptor classes must be derived from the interface ''IDecryptorStore'' which has two methods ''getEncryptionCertificates()'' and ''decrypt(...)''. | + | The decryptor classes must be derived from the interface ''IDecryptorStore'' which has two methods ''getEncryptionCertificates()'' and ''decrypt(...)''. ''getEncryptionCertificates()'' gives the list of certificates of recipients whereas ''decrypt(...)'' performs the decryption operation. You can implement your own decryptor classes conforming to this interface. Currently there are decryptor classes using smartcard, memory and Microsoft store in ESYA CMS Envelope API. |
- | Kullanılacak çözücülerin ''IDecryptorStore'' arayüzünden türemiş olmaları gerekmektedir. ''IDecryptorStore'' arayüzünün iki metodu bulunmaktadır. ''getEncryptionCertificates()'' metodu çözücünün çözebilecegi sertifikaları verir. ''decrypt(...)'' metoduna, hangi sertifika ile şifre çözme yapılması isteniyorsa o sertifika ve çözülmek istenen veri parametre olarak verilir. Metot çözülmüs veriyi geri döner. Bu arayüze uyacak şekilde kendi çözücünüzü de yazabilirsiniz. | + | |
- | CMS Envelope kütüphanesinde akıllı kart, bellek ve Microsoft sertifika deposu üzerinde çözme işlemlerini yapan çözücüler hali hazırda bulunmaktadır. | + | ==== Smartcard Decryptor ==== |
- | ==== Akıllı Kart Çözücü ==== | + | To decrypt an EnvelopedData by using a private key in a smartcard the class ''SCDecryptor'' must be used. The class takes SmartCard object and session number as parameters. To perform decryption the samrtcard must be logged in. |
- | Akıllı kart ile çözme işlemleri için ''SCDecryptor'' sınıfı kullanılmalıdır. Bu sınıf akıllı kart işlemlerini yapacağı SmartCard nesnesini ve oturum numarasını parametre olarak alır. Verinin akıllı kart ile çözülebilmesi için akıllı karta giris (login) yapılması gerekmektedir. | + | For more information about smartcards, see [[en:esya:smartcard:akıllı-kart|SmartCard]] |
+ | The example below demonstrates how to use smarcard decryptor class. | ||
- | Akıllı kart islemleri hakkında daha genis bilgi almak için [[esya:smartcard:akıllı-kart|ESYA API SmartCard Kullanım Kılavuzuna]] bakınız. | ||
- | Asağıdaki örnekte bir akıllı kart çözücü oluşturulmaktadır. | ||
<sxh java;title:Java> | <sxh java;title:Java> | ||
ByteArrayOutputStream decryptedOutputStream = new ByteArrayOutputStream(); | ByteArrayOutputStream decryptedOutputStream = new ByteArrayOutputStream(); | ||
Satır 32: | Satır 30: | ||
IDecryptorStore decryptor = new SCDecryptor(sc, session); | IDecryptorStore decryptor = new SCDecryptor(sc, session); | ||
</sxh> | </sxh> | ||
- | ==== Bellekte Çözücü ==== | + | ==== Memory Decryptor ==== |
- | Eğer sertifika ve özel anahtara ulaşılabiliniyorsa, şifrelenmis dosyalar bellekte de çözülebilir. Bu işlem için ''MemoryDecryptor'' sınıfı kullanılmalıdır. Nesne yaratılırken sertifika ve özel anahtar çiftleri parametre olarak geçilir. | + | If the certificate and the private key are in memory then decryption can be performed in memory by using ''MemoryDecryptor''. The certificate and private key pair must be given as parameter to the object at its creation. |
<sxh java;title:Java> | <sxh java;title:Java> | ||
ECertificate cert = getCertificate(); | ECertificate cert = getCertificate(); | ||
Satır 47: | Satır 45: | ||
IPrivateKey>(cert,key)); | IPrivateKey>(cert,key)); | ||
</sxh> | </sxh> | ||
- | ==== Microsoft Sertifika Deposundan Çözücü ==== | ||
- | Microsoft sertifika deposundaki anahtar kullanılarak şifreli veri çözülmeye çalısılır. Herhangi bir parametreye ihtiyaç duymaz. Yalnız kullanıcının sertifika deposuna erisim hakkı olması gerekmektedir. | + | ==== Microsoft Certificate Store Decryptor ==== |
+ | |||
+ | This class tries to decrypt the document by using a certificate and private key in Microsoft Certificate Store. The user must have access right to the store to use this decryptor. |