Linux ve macOS'ta Kamu SM / E-İmza Akis Kart İzleme Aracı PKCS#11 Kütüphane Yükleme Hatası
3 Cevap Nasıl Uygulanır?
Linux (Debian/Ubuntu) ve macOS sistemlerde Kamu SM veya yerel ESHS (Elektronik Sertifika Hizmet Sağlayıcısı) akıllı kartlarının tanınmamasının temel nedeni, sistem mimarisine (x86_64 vs arm64/Apple Silicon) uygun PKCS#11 sürücüsünün (libakisp11.so veya libakisp11.dylib) doğru dizinde bulunmaması ve smart card arka plan servisi olan pcscd demonunun arka planda soket çakışması yaşamasıdır.
Sorunu çözmek için sırasıyla şu adımları uygulayın:
- Gerekli Bağımlılıkların Kurulması (Linux): Terminalde aşağıdaki paketleri yükleyin:
sudo apt update && sudo apt install pcscd pcsc-tools libccid libpcsclite1 openjdk-11-jre. Ardındansudo systemctl enable --now pcscd.serviceile servisi başlatın. Kart okuyucuyu USB'ye taktığınızdapcsc_scankomutunu çalıştırarak ATR (Answer To Reset) kodunun üretilip üretilmediğini doğrulayın. Kart okunuyorsa donanım katmanı başarıyla çalışıyordur. - AkiS Sürücüsünün Manuel Kütüphane Entegrasyonu: TÜBİTAK Kamu SM sitesinden indirilen deb paketleri bazen güncel OpenSSL 3.0 ile derlenmediği için kütüphane çakışması yaşanabilir.
/usr/lib/libakisp11.sodosyasının varlığından emin olun; eksiksesudo ln -s /usr/lib/akisp11/libakisp11.so /usr/lib/libakisp11.sokomutuyla sembolik link oluşturun. - macOS (Apple Silicon M1/M2/M3) Özel Durumu: macOS Sonoma üzerinde Java genellikle ARM64 çalışırken eski AkiS kütüphaneleri x86_64 mimarisindedir. Mimarilerin eşleşmemesi durumunda JVM kütüphaneyi yükleyemez. Bu durumda UYAP Editör'ü veya imzalama yazılımını Rosetta 2 üzerinden x86_64 modunda çalıştırmanız gerekir. Ayrıca macOS'ta Dahili Akıllı Kart hizmetini tazelemek için
sudo killall pcscdkomutunu uygulayabilirsiniz. - PKCS11 Provider Yapılandırması: Java tarafında
java.securitydosyasında veya özel oluşturulacakpkcs11.cfgdosyasında kütüphane yolunu doğrudan belirtin (name = AKIS, library = /usr/lib/libakisp11.so, slotListIndex = 0).
Eğer kurumsal imzalama veya UYAP işlemleri için acil imza atmanız gerekiyorsa, terminal karmaşası yerine Kamu SM ve özel sağlayıcıların güncel 'ArkSigner' veya 'E-İmza Uygulaması (Client Web İmza)' paketini kurun. Bu yazılım yerel bir WebSocket servisi (genellikle 127.0.0.1:8443) açarak tarayıcı ve PKCS#11 arasındaki köprüyü kendisi kurar ve doğrudan tarayıcı uzantısıyla haberleşerek eski Java applet kütüphane hatalarını bypass eder.
Linux ve macOS ortamlarında kart okuyucunun görünmemesinin temel nedeni pcscd arka plan servisinin çalışmamasıdır. Terminalden sudo systemctl restart pcscd (Linux) veya sudo killall -HUP com.apple.ifdreader (macOS) komutunu çalıştırıp pcsc_scan aracıyla kartın ATR (Answer to Reset) kodunun üretildiği doğrulanmalıdır.