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?
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-exitbayrağını engellemek içinpcscd --foreground --auto-exit=0parametresini verin veya container entrypoint betiğindepcscd -f -dolarak ç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/autosuspendkomutuyla veya/etc/default/grubdosyasınausbcore.autosuspend=-1parametresini ekleyipupdate-grubyaparak 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
--privilegedveya/dev/bus/usbvermek yerine,pcscdservisini 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ğinlibakisp11.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_InitializeveC_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.
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.