Dijital Kimlik Lab ZERO-TRUST // PKI // KVKK MATRIX

Linux ve macOS'ta Kamu SM / E-İmza Akis Kart İzleme Aracı PKCS#11 Kütüphane Yükleme Hatası

Ubuntu 22.04 LTS ve macOS Sonoma kurulu bilgisayarlarımızda TÜBİTAK Kamu SM tarafından sağlanan akıllı kart (AkiS) ve ACS ACR38/39U kart okuyucu ile e-imza atmaya çalıştığımızda UYAP ve e-Devlet Java uygulamalarında 'Kart terminalde algılanamadı' veya 'libakisp11 kütüphanesi yüklenemedi' hatası alıyoruz. pcscd servisi ve PKCS#11 entegrasyonu tarafındaki eksik kütüphaneler ve izin sorunları nasıl yapılandırılır?
Durum: Çözüldü Kategori: Soru-Cevap

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ından sudo systemctl enable --now pcscd.service ile servisi başlatın. Kart okuyucuyu USB'ye taktığınızda pcsc_scan komutunu ç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.so dosyasının varlığından emin olun; eksikse sudo ln -s /usr/lib/akisp11/libakisp11.so /usr/lib/libakisp11.so komutuyla 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 pcscd komutunu uygulayabilirsiniz.
  • PKCS11 Provider Yapılandırması: Java tarafında java.security dosyasında veya özel oluşturulacak pkcs11.cfg dosyasında kütüphane yolunu doğrudan belirtin (name = AKIS, library = /usr/lib/libakisp11.so, slotListIndex = 0).
Kabul Edilen Yanıt 15 faydalı
Burak D.
Yakın zamanda

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.

Topluluk Katkısı 15 faydalı
Emre S.
Yakın zamanda

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.

Topluluk Katkısı 15 faydalı
Linux Sistem Yöneticisi Serkan M.
Açık Kaynak Sistem Mimarı
Yakın zamanda