İmzala İmza Aracı

Nitelikli dijital imzanızı (NES) USB token veya akıllı kart üzerinden tarayıcıdan kullanabilmeniz için ihtiyaç duyduğunuz küçük masaüstü yardımcı uygulamasıdır. Arka planda sessizce çalışır, token’ınız takılıyken İmzala.org sizi otomatik olarak yönlendirir.

Desteklenen platformlar: Windows 10/11, macOS 11+ (Intel + Apple Silicon), Linux (64-bit)

Desteklenen tokenlar: AKİS (ArkSigner, E-Tuğra, Türktrust, Kamu SM), SafeNet eToken, ESHS PKCS#11 modülleri.

---

Hızlı Kurulum (3 adım)

1. imzala.org/indir/imzala-imza-araci adresine gidin → işletim sistemini otomatik tespit eder, doğru installer’ı önerir
2. İndirilen dosyayı çalıştırın → kurulum sihirbazını izleyin
3. Token’ınızı bilgisayara takın, İmzala.org’da imza ekranına gidin → “Nitelikli E-İmza” seçin → PIN dialog’u açılır

İlk imza atana kadar ortalama 5 dakika sürer.

---

Windows Kurulumu

İndirme

https://imzala.org/indir/imzala-imza-araci/windows → ImzalaImzaAraci_<sürüm>_x64-setup.exe iner (yaklaşık 3 MB).

Kurulum

1. İndirilen .exe dosyasına çift tıklayın
2. Kurulum sihirbazı açılır → İleri ile devam edin
3. Yükleme dizinini seçin (varsayılan tavsiye edilir)
4. Kur → birkaç saniye içinde tamamlanır
5. Helper otomatik başlar, sağ alt sistem tepsisinde (system tray) imzala logosu görünür

Güvenlik notu

İmzala İmza Aracı’nın Windows yürütülebilir dosyası SSL.com EV Code Signing sertifikası ile imzalı ve RFC 3161 zaman damgalıdır. Bu sayede:

• Windows SmartScreen uyarı vermez — “Bilinmeyen yayıncı” yazısı çıkmaz
• Yayıncı olarak “Codeck Yazılım Anonim Şirketi” görüntülenir
• Kurumsal IT politikalarınız altında güvenle çalışır

Sistem gereksinimleri

• Windows 10 (64-bit) veya Windows 11
• 100 MB boş disk alanı
• ESHS sürücünüz (AKİS, SafeNet, vb.) kurulu olmalı

Test edin

1. Tarayıcıyı açın → wss://helper.imzala.org:8765/ testini deneyin (otomatik İmzala.org’dan yapılır)
2. Sistem tepsisindeki imzala logosuna sağ tıklayın → menüden durum görüntüleyin

---

macOS Kurulumu

İndirme

https://imzala.org/indir/imzala-imza-araci/macos → İmzala İmza Aracı_<sürüm>_x64.dmg iner (yaklaşık 5 MB).

Kurulum

1. İndirilen .dmg dosyasına çift tıklayın → disk imajı mount olur
2. Açılan pencerede uygulamayı Applications klasörüne sürükleyin
3. Spotlight veya Launchpad’den İmzala İmza Aracı’nı başlatın
4. Menübar’ın sağ üstünde imzala logosu görünür → sağ tıkla → çıkış için menü

Apple Onaylı

İmzala İmza Aracı macOS sürümü:

• Apple Developer ID ile imzalı
• Apple tarafından notarize edilmiş (resmi onay)
• Stapled (ticket gömülü, çevrimdışı doğrulanabilir)

Bu sayede:

• Gatekeeper uyarı vermez — direkt açılır
• “Bilinmeyen geliştirici” engellemesi yok
• macOS güvenlik politikaları altında güvenle çalışır

Sistem gereksinimleri

• macOS 11 Big Sur veya üzeri
• Intel veya Apple Silicon (M1/M2/M3/M4) — Apple Silicon’da Rosetta 2 üzerinden çalışır
• ESHS PKCS#11 .dylib modülünüz /Library/... altında

Apple Silicon notu

İmzala İmza Aracı x86_64 olarak derlenmiştir. Sebep: Türkiye’deki ESHS PKCS#11 modülleri (AKİS, SafeNet, vb.) sadece x86_64 olarak dağıtılır. Apple Silicon makinenizde Rosetta 2 otomatik devreye girer, ek kurulum gerektirmez.

---

Linux Kurulumu

3 paket formatı sunuyoruz. Dağıtımınıza uygun olanı seçin:

AppImage (her dağıtım)

https://imzala.org/indir/imzala-imza-araci/linux-appimage → İmzala İmza Aracı_<sürüm>_amd64.AppImage (yaklaşık 80 MB)

chmod +x "İmzala İmza Aracı_*.AppImage"
./"İmzala İmza Aracı_*.AppImage"

AppImage çalıştırılabilir tek dosya — kurulum gerektirmez, herhangi bir Linux dağıtımında çalışır.

Debian / Ubuntu (.deb)

https://imzala.org/indir/imzala-imza-araci/linux-deb

sudo apt install ./"İmzala İmza Aracı_*_amd64.deb"

Veya çift tıklayarak yazılım merkezinden kurun. Kaldırma:

sudo apt remove imzala-imza-araci

Fedora / RHEL / openSUSE (.rpm)

https://imzala.org/indir/imzala-imza-araci/linux-rpm

sudo dnf install ./"İmzala İmza Aracı-*.x86_64.rpm"

Sistem gereksinimleri

• 64-bit modern Linux dağıtımı (kernel 5.x+)
• libwebkit2gtk-4.1 (genelde otomatik bağımlılık olarak gelir)
• ESHS .so kütüphanesi (AKİS Linux paketi, vb.) sistemde kurulu

Başlatma

Uygulamayı menüden başlatın veya:

imzala-imza-araci

Sistem tepsisinde (üst panel) imzala logosu görünür.

---

Token ve Akıllı Kart Yapılandırması

İmzala İmza Aracı, sisteminizde kurulu PKCS#11 modüllerini otomatik tarar. Aşağıdaki ESHS’lerin token’ları desteklenir:

ESHS	Modül
Kamu SM (Kamusal NES)	AKİS
TÜRKKEP	ArkSigner / AKİS
Türktrust	AKİS
E-Tuğra	AKİS / SafeNet
ESHS / Cyberus	Custom PKCS#11
E-Güven	AKİS

ESHS’nizin kendi sürücüsünü/yazılımını önce kurun, sonra İmzala İmza Aracı’nı çalıştırın.

---

Otomatik Güncellemeler

İmzala İmza Aracı, TLS sertifikasını otomatik yeniler (her 12 saatte bir kontrol). Bu sayede helper.imzala.org sertifikası yenilendiğinde herhangi bir kullanıcı işlemi gerektirmeden helper güncellenir.

Uygulama sürümü güncellendiğinde manuel olarak yeniden indirmeniz gerekir (imzala.org/indir/imzala-imza-araci). Bu, yalnızca büyük özellik güncellemelerinde gereklidir.

---

Sıkça Sorulan Sorular

Helper’ı kurmadan imza atabilir miyim?

Hayır. Tarayıcılar güvenlik nedeniyle USB token’lara doğrudan erişemez. Helper, tarayıcı ile USB token arasında köprü görevi görür ve PIN’iniz hiçbir zaman tarayıcıya veya İmzala sunucularına gönderilmez.

PIN’im güvende mi?

Evet. PIN, yalnızca yerel olarak helper uygulamasında girilir ve doğrudan USB token’ınıza iletilir. Tarayıcı, İmzala sunucuları ya da başka bir 3. taraf PIN’inizi hiçbir zaman görmez.

Tarayıcım güncellendi, çalışmıyor

Helper’ı yeniden başlatın (sistem tepsisi → sağ tık → Çıkış → uygulamayı tekrar açın). Sorun devam ederse destek ile iletişime geçin.

“Helper bağlanamadı” yazıyor

1. Helper’ın çalıştığını doğrulayın (sistem tepsisinde logo görünür mü?)
2. Tarayıcı sekmesini yenileyin
3. Firewall / antivirüs localhost:8765’i engelliyor olabilir → kuralı kontrol edin
4. Hala çalışmıyorsa helper’ı yeniden başlatın

Token görünmüyor

1. Token’ı bilgisayara tak (USB)
2. ESHS sürücüsünü kontrol et — sürücü kurulu mu, çalışıyor mu?
3. Windows: Aygıt Yöneticisi’nde akıllı kart cihazı görünüyor mu?
4. macOS: Terminal’de system_profiler SPUSBDataType | grep -i token
5. Linux: pcsc_scan ile kart okuyucu durumunu kontrol et

Helper kapanmıyor

Sistem tepsisindeki logo → sağ tık → Çıkış. Tepsi simgesi görünmüyorsa:

• Windows: Görev Yöneticisi → imzala-imza-araci.exe → Görevi sonlandır
• macOS: pkill -f imzala-qes-helper
• Linux: pkill imzala-imza-araci

İmzaladığım PDF’i nasıl doğrularım?

imzala.org/dogrula sayfasından imzalı PDF’i yükleyin → DSS doğrulama motoru tüm zincir bilgisini gösterir (yeşil tik dahil).

Adobe Reader Türk ESHS root sertifikalarını standart olarak tanımaz (AATL listesinde olmadıkları için). Bu Adobe sınırlamasıdır, İmzala’yla ilgisi yoktur. Doğrulama için İmzala’nın kendi /dogrula sayfasını kullanın.

---

Destek

Sorun yaşıyorsanız:

• 📧 [email protected]
• 💬 Web sitesindeki canlı destek
• 📋 Sıkça Sorulan Sorular
• 📖 Diğer dokümanlar

İmzala İmza Aracı açık kaynak değildir ancak çalışma prensibi şeffaftır:

• Tüm imzalama işlemi yerel olarak USB token’ınızda yapılır
• Helper sadece tarayıcı ile token arasında köprü görevi görür
• PIN’iniz tarayıcıya veya sunucuya hiçbir zaman gönderilmez
• Token özel anahtarınız hiçbir zaman USB cihazdan çıkmaz