DONANIM & SÜRÜCÜ LABORATUVARI: AKİS • SAFENET • GEMALTO • PALADIN
E-İmza Rehberi SMARTCARD // TOKEN LAB

Docker Linux Container İçinde PKCS#11 ve pcscd ile Otomatik e-İmzalama Yaparken Yaşanan Oturum Düşmesi ve 'SCARD_E_SERVICE_STOPPED' Sorunu Nasıl Çözülür?

Mikroservis mimarimizde Ubuntu tabanlı bir Docker container içerisinde PDF ve fatura belgelerini USB donanım tokenı kullanarak otomatik imzalayan bir Java/Python arka plan servisi kurduk. Host makinedeki USB aygıtını container içerisine `/dev/bus/usb` üzerinden bağlayıp pcscd daemon çalıştırdığımızda, servis ilk birkaç imzayı başarıyla atıyor ancak belirli bir süre işlem yapılmadığında veya yük bindiğinde 'SCARD_E_SERVICE_STOPPED' veya 'CKR_DEVICE_REMOVED' hatası vererek çöküyor. Container ortamında USB token oturumunu kararlı ve kesintisiz tutmanın yolu nedir?
Durum: Çözüldü Kategori: Soru-Cevap

2 Cevap Nasıl Uygulanır?

Linux Docker konteynerlarında fiziksel USB akıllı kartların (PKCS#11) doğrudan yönetimi, Linux cgroups kısıtlamaları, USB güç tasarrufu (autosuspend) ve pcscd servisinin varsayılan çalışma mantığı nedeniyle sıkça oturum düşmesi problemlerine yol açar. Sorunu kökten çözmek için mimariyi şu 4 adımda yapılandırmalısınız:

  • 1. pcscd Otomatik Kapanma (Auto-exit) Modunu Kapatın: Modern Linux dağıtımlarında pcscd, systemd soket aktivasyonu ile çalışır ve boşta kaldığında (varsayılan 60 saniye) bellek tasarrufu amacıyla kendini kapatır. Konteyner içinde systemd yerine doğrudan daemon çalıştırıyorsanız, servis başlatma komutunuza --auto-exit bayrağını engellemek için pcscd --foreground --auto-exit=0 parametresini verin veya container entrypoint betiğinde pcscd -f -d olarak çalıştırın.
  • 2. Host Seviyesinde USB Autosuspend Özelliğini Devre Dışı Bırakın: Linux çekirdeği enerji tasarrufu için USB token'a giden gücü kesebilir. Host işletim sisteminde terminalden echo -1 | sudo tee /sys/bus/usb/devices/*/power/autosuspend komutuyla veya /etc/default/grub dosyasına usbcore.autosuspend=-1 parametresini ekleyip update-grub yaparak USB uyku modunu tamamen devre dışı bırakın.
  • 3. En İyi Uygulama: pcscd'yi Host'ta Çalıştırıp UNIX Soketini Paylaşmak: Container içine doğrudan --privileged veya /dev/bus/usb vermek yerine, pcscd servisini host işletim sisteminde çalıştırın. Ardından host üzerindeki IPC soketini (/run/pcscd/pcscd.comm) container içine volume mount olarak bağlayın (-v /run/pcscd/pcscd.comm:/run/pcscd/pcscd.comm). Container içine sadece PKCS#11 kütüphanesini (örneğin libakisp11.so) koyun. Böylece USB cihaz yönetimi host çekirdeğinde stabil kalır, container ise IPC üzerinden kayıpsız iletişim kurar.
  • 4. PKCS#11 Oturum Havuzu (Session Pooling): Uygulama kodunuzda her imzalama işleminde C_Initialize ve C_Finalize çağrısı yapmak yerine, tek bir oturum açıp (C_OpenSession) belirli aralıklarla (örneğin 30 saniyede bir) keep-alive amaçlı kart durum sorgusu (C_GetSlotInfo) çalıştıran bir session pool yapısı kurun.

Host tarafında soket paylaşımı mimarisine geçtiğinizde, container yeniden başlasa dahi fiziksel kart bağlantısı kopmayacak ve 'SCARD_E_SERVICE_STOPPED' hataları tamamen son bulacaktır.

Kabul Edilen Yanıt 15 faydalı
Tayfun G.
Yakın zamanda

Eğer container içine USB yönlendirmekle uğraşmak istemiyorsanız, üretim ortamları için en pratik ve güvenli yöntem donanım tokenını bir USB-over-IP (örneğin usbip veya sanal USB sunucu) cihazına takmaktır. Ancak fatura/arşiv gibi yüksek hacimli toplu imzalama senaryolarında fiziksel USB token kullanmak donanım kilitlenmelerine yol açabileceğinden, tüzel kişilikler için Gelir İdaresi Başkanlığı onaylı HSM (Hardware Security Module) veya Bulut e-İmza (Cloud Signature / Remote Signing) REST API servislerine geçmek çok daha sürdürülebilir bir çözümdür.

Topluluk Katkısı 15 faydalı
Murat B.
Yakın zamanda