D-Signer E-İmza Uygulaması

Kendi ürünümüz: nitelikli elektronik sertifikayla PDF, XML ve CAdES imzası atan, kartı doğrudan okuyan ve web uygulamalarına yerel bir REST API ile hizmet veren ücretsiz masaüstü e-imza uygulaması. TÜBİTAK'ın MA3 API kütüphanesinden bağımsız çalışıyor.

Proje

Geliştirdiğimiz İSG-İBYS yazılımlarında işyeri hekimleri e-reçete yazıyor, kurumlar Çalışma Bakanlığı'na eğitim verisi gönderiyor. İkisi de nitelikli elektronik imza istiyor. Kullanıcı kartını okuyucuya takıyor, PIN'ini giriyor ve imza, web tabanlı yazılımın içinden atılıyor. Bu köprüyü kuran masaüstü uygulaması D-Signer.

D-Signer bilgisayara bağlı kart okuyucuları tarıyor, takılı kartı tanıyor ve sertifika sahibini listeliyor. PIN girildikten sonra oturum açık kalıyor; PDF, XML ve CAdES imzası ister menüden ister bir web uygulamasından istenebiliyor. Bir şey ters gittiğinde ne olduğunu işlem kayıtları adım adım anlatıyor.

D-Signer · Kart okuma
D-Signer ana ekranı: bağlı akıllı kartlar tablosunda sertifika sahibi, AKİS kart tipi, ACS ACR40T terminali, kart ATR değeri ve SHA384withECDSA algoritması; altta PC/SC ile kartın okunmasını adım adım gösteren işlem kayıtları

MA3 API'ye bağlı değil

Türkiye'de e-imza atan yazılımların yaygın olarak dayandığı kütüphane TÜBİTAK'ın MA3 API'si. TÜBİTAK bu kütüphaneyi yıllarca ücretsiz sundu, ardından lisanslı hâle getirdi; lisans ücretinin neye göre belirlendiğine dair açıklanmış sabit bir kriter yok. Bu durum e-imzayı ürününe koyan her yazılım firmasını, önceden hesaplayamadığı ve sonunda kendi müşterisine yansıtmak zorunda kaldığı bir maliyete bağlıyor.

D-Signer'ı bu bağımlılık olmadan yazdık. Kart okuyucuyla konuşmaktan sertifikayı kartın dosya sisteminden okumaya ve imzayı oluşturmaya kadar her adım kendi kodumuz; MA3 API'nin hiçbir parçası kullanılmıyor. Kartla konuşmak için yalnızca kart üreticisinin standart PKCS#11 sürücüsüne başvuruluyor. Bu yüzden D-Signer'ı kullananlar için lisans ücreti yok: uygulama ücretsiz.

  1. Okuyucu ve kart

    PC/SC ile bağlı okuyucular bulunur; kartın ATR değerinden kart tipi tanınır.

  2. Sertifika

    Kartın dosya sisteminde PKCS-15 alanı seçilir, nitelikli sertifika doğrudan karttan okunur.

  3. İmza

    PIN girilince kartın PKCS#11 sürücüsüyle oturum açılır; özel anahtar kartın dışına hiç çıkmaz.

Kartı tak, PIN'i gir, imzala

Arayüz koyu temalı ve tek pencere: üstte işlemler, ortada bağlı kartlar, altta işlem kayıtları. Her kart satırında sertifika sahibi, kart tipi, okuyucu, kart ATR değeri ve imza algoritması görünüyor. Yeni nesil kartlardaki ECDSA anahtarları SHA384withECDSA ile kullanılıyor.

D-Signer · PIN girişi
PIN girişi penceresi: terminal ACS ACR40T ICC Reader 0, kart sahibinin adı ve PIN kodu alanı, Giriş yap ve İptal düğmeleri
PIN penceresi hangi okuyucudaki hangi karta giriş yapıldığını açıkça gösteriyor.
D-Signer · Oturum açık
Giriş başarılı penceresi: Hoş geldiniz ve kart sahibinin adı; arkada okuyucu, kart etiketi, aktif slot ve oluşturulan PKCS#11 yapılandırmasını gösteren işlem kayıtları; altta oturum açık durum çubuğu
Giriş sonrası alt çubukta oturumun kime ait olduğu yazıyor; kayıtlarda slot ve sürücü bilgisi görünüyor.
D-Signer · PDF imzala
PDF imzala komutuyla açılan İmzalanacak PDF dosyasını seçin penceresi; arkada oturumu açık kart ve işlem kayıtları
PDF imzalama: dosya seçilir, imza oturumu açık karttan atılır. XML ve CAdES imzası da aynı menüden.

Altı adımlı tanı raporu

E-imza sorunlarının çoğu imzanın kendisinden değil ortamdan çıkar: süresi dolmuş sertifika, kurum ağında kapalı bir adres, Türkçe karakterli bir klasör, eksik bir sürücü. D-Signer'daki Tanı düğmesi bunları tek seferde sınıyor; Log Gönder düğmesi de kayıtları destek ekibine iletiyor.

  • Sertifika tarih geçerliliği

    Sertifikanın geçerlilik başlangıcı ve bitişi okunur; süresi dolmuş kartla imza denemesine gerek kalmaz.

  • CRL listesi erişimi

    Sertifikadaki iptal listesi adresine gerçekten ulaşılabiliyor mu, HTTP cevabıyla birlikte gösterilir.

  • OCSP sunucusu erişimi

    Sertifika durum sorgusu yapılan sunucuya erişim aynı şekilde sınanır; kurum ağındaki engeller hemen ortaya çıkar.

  • Klasör yolunda Türkçe karakter

    Çalışma klasörünün yolunda Türkçe karakter olup olmadığına bakılır; bazı kart sürücüleri bu yollarda çalışmaz.

  • Klasörün yazılabilirliği

    Geçici bir dosya yazılıp silinir; yetki sorunları imza sırasında değil, tanıda yakalanır.

  • Kart sürücüsü desteği

    Takılı kartın ATR değerine göre uygun sürücünün bilgisayarda bulunup bulunmadığı denetlenir.

Destek telefonu açılmadan önce

Tanı raporu her testi yeşil ya da kırmızı bir satır olarak gösteriyor; altında ayrıntısı yazıyor: sertifikanın geçerlilik tarihleri, CRL ve OCSP adresleri ile aldıkları HTTP cevabı, çalışma klasörünün yolu. Kullanıcı sorunu çoğu zaman bu ekrandan kendisi görüyor.

Görmediğinde ise destek ekibi uzaktan bağlanmadan aynı bilgiye sahip oluyor. İşlem kayıtları kart okumanın her adımını, oluşturulan sürücü yapılandırmasını ve oturum durumunu zaman damgasıyla tutuyor.

D-Signer · Tanı raporu
Ortam ve sertifika tanı raporu: 6 başarılı rozeti altında sertifika tarih geçerlilik kontrolü, CRL listesi erişimi, OCSP sunucusu erişimi, çalışma klasörü Türkçe karakter testi, yazılabilirlik testi ve ATR sürücü desteği satırları

Web uygulamaları için yerel REST API

D-Signer açıldığında bilgisayarda yerel bir REST API başlatıyor; durum çubuğunda hangi portta çalıştığı yazıyor. Tarayıcıda çalışan bir web uygulaması imzalanacak veriyi bu API'ye gönderiyor, imzalı sonucu geri alıyor. Kart, PIN ve sürücü işleri tamamen D-Signer'da kalıyor; web uygulamasının bunlarla uğraşması gerekmiyor.

Kart takıldığında D-Signer kart üreticisini, okuyucunun adını ve kartın bulunduğu slotu kendisi buluyor ve PKCS#11 yapılandırmasını buna göre üretiyor. Kullanıcı hiçbir dosyayı elle düzenlemiyor.

D-Signer · PKCS#11 yapılandırması
# Kart takılınca otomatik
# üretilen PKCS#11 ayarı
name = CACSACR40TICCRea_…
library = C:/Windows/System32/akisp11.dll
slot = 1
attributes = compatibility

Kurulum

D-Signer Windows ve macOS'ta çalışıyor. Windows'ta arşiv C:\imza klasörüne açılıp uygulama başlatılıyor; ilk açılışta gereken dosyalar kendiliğinden indiriliyor. macOS'ta güncelleyici gerekli dosyaları indiriyor, ardından uygulama başlatılıyor. Uygulama Java 17 üzerinde çalışıyor.

Kurulum adımları ve indirme bağlantıları, ekran görüntüleriyle birlikte dsigner.com.tr'de.

Rakamlarla

MA3 API bağımlılığı
Yok
Kullanıcıya lisans ücreti
Yok
İmza biçimi
3
Tanı testi
6

İmza biçimleri: PDF, XML ve CAdES. Kartla konuşmak için yalnızca kart üreticisinin standart PKCS#11 sürücüsü kullanılıyor.

Ana özellikler

İmza

  • PDF imzalama
  • XML imzalama
  • CAdES imzalama
  • İmza doğrulama

Kart

  • PC/SC ile doğrudan kart okuma
  • ATR değerinden kart tipi tanıma
  • Nitelikli sertifikayı karttan okuma
  • Otomatik PKCS#11 yapılandırması

Entegrasyon

  • Yerel REST API
  • Web uygulamalarından imza isteği
  • E-reçete ve eğitim verisi gönderimi
  • Açık kalan imza oturumu

Tanı ve destek

  • Altı adımlı ortam ve sertifika tanısı
  • CRL ve OCSP erişim testi
  • Zaman damgalı işlem kayıtları
  • Tek tıkla log gönderme

Platform

  • Windows ve macOS
  • Java 17
  • MA3 API gerektirmez
  • Kullanıcıya ücretsiz

D-Signer, e-imzayı bir lisans pazarlığı olmaktan çıkarıp yazılımın sıradan bir özelliği hâline getiriyor.

dsigner.com.tr'yi ziyaret edin

Yazılımınıza e-imza ekleyelim

Deadline'ınızı söyleyin, planı birlikte çıkaralım.

Uzman ekibimiz sizinle iletişime geçmek için hazır. Araya bürokrasi girmez; doğrudan işi yapacak ekiple konuşursunuz.