Bu sayfanın seçili sürümü ile mevcut sürümü arasındaki farkları gösterir.
en:esya:ortakimza:imza-api-kavramlar-arayuzler [2013/07/17 07:02] Dindar Öz created |
en:esya:ortakimza:imza-api-kavramlar-arayuzler [2013/08/29 05:48] (mevcut) Dindar Öz |
||
---|---|---|---|
Satır 1: | Satır 1: | ||
- | ====== E-İmza Ortak Kütüphanesi Kavramlar ve Arayüzler ====== | + | ====== E-Signature Common API Concepts and Interfaces ====== |
- | ===== Kavramlar ===== | + | ===== Concepts ===== |
- | ==== İmza Formatı ==== | + | ==== Signature Format ==== |
- | İmzayı oluşturan kodlama tipidir. ASN1 kodlamalı binary(CAdES), xml kodlamalı(XAdES) olmak üzere iki ana yapı bulunmaktadır. Desteklenen İmza formatları CAdES, XAdES. | + | Signatures can be in two formats, CAdES and XAdES.CAdES is ASN.1 encoded binary format and the XAdES is XML encoded text format. |
- | ==== İmza Tipi ==== | + | ==== Signature Type ==== |
- | Eİmza standartları ile berlirlenmiş, bir imzanın içinde yer alan zaman damgası, doğrulama referansları gibi verilerin hangilerinin yer aldığını belirten yapılardır. | + | Signature type determines which components of the signature are included in the signed document. Timestamp, reference information to validation data, or the validation data itself are some of those components. |
- | === İmza kütüphanesinin desteklediği imza tipleri === | + | === Supported Signature Types === |
- | ^İmza Tipi ^ Özelliği ^ | + | ^Signature ^ Type ^ |
- | | ES_BES | Basit(Basic) Elektronik İmza | | + | | ES_BES | Basic Electronic Signature | |
- | | ES_T | Zaman damgalı imza | | + | | ES_T | Electronic Signature with Timestamp | |
- | | ES_C | Doğrulama verisine referans var | | + | | ES_C | Includes reference to validation data | |
- | | ES_X_Type1 | Doğrulama verisi referansları ve imza değeri zaman damgalı | | + | | ES_X_Type1 | Includes both validation references and timestamp | |
- | | ES_X_Type2 | Doğrulama verisi referansları zaman damgalı | | + | | ES_X_Type2 | Includes validation references and validation references are timestamped | |
- | | ES_XL | Doğrulama verisi imza içinde | | + | | ES_XL | Includes validation data | |
- | | ES_XL_Type1 | Doğrulama verisi imza içinde ve doğrulama verisi referansları ve imza değeri zaman damgalı | | + | | ES_XL_Type1 | Includes validation data and timestamp | |
- | | ES_XL_Type2 | Doğrulama verisi imza içinde Doğrulama verisi referansları zaman damgalı | | + | | ES_XL_Type2 | Includes validation data and validatio data is timestamped | |
- | | ES_A | Arşiv fomatı(uzun ömürlü koruma) | | + | | ES_A | Archive format (very long-term protection) | |
- | ==== Ayrık/bütünleşik İmza ==== | + | ==== Detached/Attached Signature ==== |
- | İmza verisinin imza içerisinde yer alıp almaması durumuna göre ayrık ve bütünleşik denilmektedir. Bunun yanında XML imza formatına özel enveloped imza vardır. Enveloped imza standartlaştırılamadığı (custom) için ortak kütüphane tarafından desteklenmemektedir. Enveloped imza için XML İmza bölümüne bakabilirsiniz. | + | Signatures are called as detached or attached according to the inclusion of signature values in the signed document. Besides, in XML signature format, there is also enveloped signature which is not supported by common api since it can not be represented by the common interface. For enveloped signature, see the section XML Signature. |
- | ===== Anahtar API Arayüzleri ve Tasarım ===== | + | ===== Key API Interfaces and Design ===== |
- | + | ||
- | + | ||
- | Bir kişinin ıslak imzasının, programlama arayüzü karşılığı Signature, bir yada daha fazla imzayı içinde barındıran yapı SignatureContainer İmza formatına göre SignatureContainer yaratma amacı ile kullanılan arayüz SignatureFactory'dir. | + | |
+ | A single signature is represnted by the interface ''Signature'' whereas one or more signatures can be contained by the interface ''SignatureContainer''. ''SignatureFactory'' is used to create proper ''SignatureContainer'' instance according to the given signature format. | ||
{{:esya:ortakimza:api_siniflari.png?nolink&899x624}} | {{:esya:ortakimza:api_siniflari.png?nolink&899x624}} | ||
+ | Signature is created as ES-BES and can be converted to more complex types by using the method ''Signature#upgrade''. | ||
- | İmza yaratıldığında ES-BES tipindedir. Daha kompleks bir imza tipine ''Signature#upgrade'' metodu ile çevrilebilir. | ||