Bu sayfanın seçili sürümü ile mevcut sürümü arasındaki farkları gösterir.
en:esya:cades:eimza-cades-kutuphanesi [2013/07/23 05:13] Dindar Öz created |
en:esya:cades:eimza-cades-kutuphanesi [2013/09/02 10:54] (mevcut) Dindar Öz |
||
---|---|---|---|
Satır 2: | Satır 2: | ||
- | Bu doküman ESYA API CMS Signature kütüphanesinin nasıl kullanılacağı hakkında bilgi vermektedir. CMS Signature kütüphanesi ile akıllı kartları yönetebilir, sertifika doğrulayabilir, elektronik imza atabilir ve elektronik imza doğrulayabilirsiniz. Kütüphaneyi kullanabilmeniz için adınıza üretilmiş bir lisansa veya test lisansına ihtiyacınız vardır. | + | This document ESYA provides an introductory summary on how to use ESYA CMS Signature API. With CMS Signature API you can manage your keys with smartcards, validate certificates, create and verify electronic signatures. |
+ | API requires a valid license. | ||
+ | You need a digital certificate and a secure container for the private key in order to create signature. Usually smartcards are used as the secure container for the private keys. For detailed information about signature creation please refer to the section [[en:esya:cades:imza-atma|Signature Creation ]]. | ||
- | İmza atma işlemi için kullanıcının sertifikaya ve özel anahtarını güvenli bir şekilde muhafaza edebileceği bir öğeye ihtiyacı vardır. Özel anahtarların muhafazası için genel olarak akıllı kart kullanıldığından, dokümanda bu öğe için "akıllı kart" kavramı kullanılacaktır. İmza atma hakkında ayrıntılı bilgi için [[esya:cades:imza-atma|İmza Atma İşlemleri]] bölümüne bakınız. | + | Signature verification consists of certificate validation , cryptographic verification of the signature and structural validation of the signed document. Certificate validation requires a validation policy file which |
+ | is an XML file coming with the API and can be configured as desired. Please refer to the section [[en:esya:cades:imza-dogrulama|Signature Verification]] for more information. | ||
+ | ===== Requirements ===== | ||
- | İmza doğrulama işlemleri sertifikanın doğrulanmasından ve imzanın yapısal olarak doğrulamasından oluşmaktadır. Sertifika doğrulama için sertifika deposuna ve sertifika doğrulamanın nasıl yapılacağını belirten politika dosyasına ihtiyaç vardır. Daha ayrıntılı bilgi için [[esya:cades:imza-dogrulama|İmza Doğrulama İşlemleri]] bölümüne bakınız. | + | E-Signature API requires the license file, certificate validation policy file and certificate store file. To create qualified signatures, hardware security devices are needed. Generally smartcards are used for this purpose. Using smartcards requires the drivers of the smartcard and smartcard reader.A smartcard card viewer utility program to view the contents of the smartcard can be obtained from a smartcard manufacturer. |
- | ===== Gerekler ===== | + | For a quick start see the section [[en:esya:quickstart|Quick Start]]. |
- | ESYA API CMS Signature kütüphanesinin kullanılabilmesi için lisans doyasına, sertifika doğrulama politika dosyasına, sertifika deposu dosyasına ihtiyacınız vardır. | + | ===== Signature Types ====== |
- | İmza doğrulama işlemi için ise yukarıdaki dosyalarla birlikte ESYA kütüphanesi yeterli olacaktır. Kanuni geçerliliği olan nitelikli imzaların atılabilmesi için ise güvenli bir donanım kullanılması zorunluğu vardır. Genel kullanım olarak akıllı kart kullanılmaktadır. | + | API supports the signature types documented in ETSI TS 101 733 listed below: |
+ | - CAdES-BES (Basic Elektronic Signature) | ||
+ | - CAdES-EPES (Explicit Policy Based Electronic Signature) | ||
+ | - CAdES-T (Electronic Signature with Time) | ||
+ | - CAdES-C (Electronic Signature with Complete Validation Data References) | ||
+ | - CAdES-X-Long (EXtended Long Electronic Signature) | ||
+ | - CAdES-X-Type 1 (EXtended Electronic Signature with Time Type 1) | ||
+ | - CAdES-X-Type 2 (EXtended Electronic Signature with Time Type 1) | ||
+ | - CAdES-X-Long-Type 1 or Type 2 (EXtended Long Electronic Signature with Time Type 1) | ||
+ | - CAdES-A (Archival Electronic Signature) | ||
- | Akıllı karta erişilebilmesi için akıllı kart okuyucusu sürücüsünün ve akıllı kartın sürücüsünün kurulması | + | ETSI TS 101 733 includes detailed information about the signature types listed above. Here they are explained briefly. The figures are from ETSI TS 101 733 document. |
- | gerekmektedir. Akıllı kartın üreticisinin sağladığı kart izleme programı ile bilgisayarın karta erişimi kontrol edilebilir. | + | |
- | Hızlı bir başlangıç için [[esya:quickstart|hızlı başlangıç bölümüne]] bakabilirsiniz. | + | [[en:esya:cades:imza-atma|Signature Creation]] |
- | ===== İmza Tipleri ====== | + | [[en:esya:cades:imza-tipleri| Creating Different Signature Types]] |
- | API, ETSI TS 101 733 dokümanında anlatılan aşağıdaki imza tiplerini desteklemektedir: | + | [[en:esya:cades:imza-ozellikleri|Optional Attributes]] |
- | - CAdES-BES (Basic Elektronic Signature-Basit Elektronik İmza) | + | |
- | - CAdES-EPES (Explicit Policy Based Electronic Signature- Belirlenmiş Politika Temelli Elektronik İmza) | + | |
- | - CAdES-T (Electronic Signature with Time- Zaman Damgası Eklenmiş Elektronik İmza) | + | |
- | - CAdES-C (Electronic Signature with Complete Validation Data References-Tüm Doğrulama Verilerinin Referanslarının Eklendiği İmza) | + | |
- | - CAdES-X-Long (EXtended Long Electronic Signature- Genişletilmiş Uzun Elektronik İmza) | + | |
- | - CAdES-X-Type 1 (EXtended Electronic Signature with Time Type 1- Genişletilmiş Elektronik İmza Tip 1 Zamanlı) | + | |
- | - CAdES-X-Type 2 (EXtended Electronic Signature with Time Type 1- Genişletilmiş Elektronik İmza Tip 2 Zamanlı) | + | |
- | - CAdES-X-Long-Type 1 or Type 2 (EXtended Long Electronic Signature with Time Type 1- Genişletilmiş Uzun Elektronik İmza Tip 1 veya Tip 2 Zamanlı) | + | |
- | - CAdES-A (Archival Electronic Signature- Arşiv Elektronik İmza) | + | |
- | Yukarıdaki imza tiplerinin detayı için ETSI TS 101 733 dokümanına bakılabilir. Ancak burada da imza tipleri için kısa açıklamalar verilmiştir. Açıklamalarda ETSI TS 101 733 dokümanında yer alan şekillerden faydalanılmıştır | + | [[en:esya:cades:sertifika-dogrulama|Certificate Validation]] |
+ | [[en:esya:cades:imza-dogrulama|Signature Verification]] | ||
- | [[esya:cades:imza-atma|İmza Atma]] | + | [[en:esya:cades:imza-donusum| Conversion Between Signature Types]] |
- | [[esya:cades:imza-tipleri| Farklı İmza Tiplerinin Oluşturulması]] | + | [[en:esya:cades:imza-zamani|Signing Time]] |
- | [[esya:cades:imza-ozellikleri|Zorunlu Olmayan Özellikler]] | + | [[en:esya:cades:imza-parametreler|Parameters]] |
- | + | ||
- | [[esya:cades:sertifika-dogrulama|Sertifika Dogrulama]] | + | |
- | + | ||
- | [[esya:cades:imza-dogrulama|İmza Dogrulama]] | + | |
- | + | ||
- | [[esya:cades:imza-donusum| İmza Tipleri Arasında Dönüşüm]] | + | |
- | + | ||
- | [[esya:cades:imza-zamani|İmza Zamanı]] | + | |
- | + | ||
- | [[esya:cades:imza-parametreler|Parametreler]] | + | |