DONANIM & SÜRÜCÜ LABORATUVARI: AKİS • SAFENET • GEMALTO • PALADIN
E-İmza Rehberi SMARTCARD // TOKEN LAB
Kurulum Rehberi • 2026-09-21 • 5 dk okuma • Doğrulanmış Rehber • 1 Yorum

Mac (macOS Sequoia & Sonoma) E-İmza ve Java Kurulum Kılavuzu

Apple Silicon (M1, M2, M3, M4) işlemcili Mac bilgisayarlarda macOS Sequoia veya Sonoma güncellemeleri sonrasında elektronik imza kurulumu, Windows ortamına kıyasla özel güvenlik yetkilendirmeleri ve yerel ARM64 Java kütüphaneleri gerektirir.

1. macOS İçin Yerel Java (JDK) Kurulumu

E-imza imzalama araçları ve UYAP/EBYS portalları Java tabanlı çalışır. Apple Silicon işlemcili cihazlarda x86 tabanlı eski Java sürümleri emülasyon nedeniyle kartı algılamayabilir. Bu nedenle doğrudan ARM64 uyumlu OpenJDK veya Oracle Java 8 / 11 sürümünün kurulması şarttır.

  1. Terminal uygulamasını açın ve cihaz mimarinizi doğrulamak için uname -m komutunu çalıştırın (arm64 yanıtı gelmelidir).
  2. Resmi Java portalından macOS x64 değil, mutlaka macOS ARM64 DMG Installer paketini indirin.
  3. İndirilen paketi kurduktan sonra Terminal'de java -version yazarak kurulumu doğrulayın.

2. AKİS macOS Paketinin Kurulumu ve Güvenlik İzni

macOS Sequoia, Apple onaylı geliştirici sertifikası barındırmayan uygulamaları doğrudan engeller. AKİS kurulumunda 'Geliştirici doğrulanamadığı için açılamıyor' uyarısı alırsanız şu adımları izleyin:

  • Apple menüsünden Sistem Ayarları > Gizlilik ve Güvenlik bölümüne gidin.
  • Aşağı kaydırarak Güvenlik başlığı altında AKİS için görünen 'Yine de Aç' (Open Anyway) butonuna tıklayın.
  • Yönetici parolanızı girerek kuruluma izin verin.
Terminal PCSC Servisi Kontrolü: Mac üzerinde kart okuyucunun sistem tarafından görülüp görülmediğini test etmek için Terminal ekranına pcsctest yazıp Enter'a basabilirsiniz. Cihazınızı taktığınızda Terminal ekranında 'Reader 01: ACS CCID' şeklinde bir satır görmelisiniz.

3. Tarayıcı İzinleri ve Token Erişimi

Safari tarayıcısının sıkı kumanda (sandbox) kısıtlamaları nedeniyle e-Devlet veya bankacılık portallarında Google Chrome veya Firefox kullanılması tavsiye edilir. Sistem Ayarları > Gizlilik ve Güvenlik > Giriş Öğeleri sekmesinde AKİS arka plan servisinin çalışmasına izin verildiğinden emin olun.

E-imzanızı Mac üzerinde kurduktan sonra cihazınızın kartı görmemesi durumunda AKİS Kart Bulunamadı Çözüm Rehberimizden donanım testi adımlarını inceleyebilirsiniz. Eski macOS sürümlerindeki kurulum farklılıkları için Klasik Mac E-İmza Rehberimize göz atabilirsiniz.

Elektronik İmza Sürücü Mimarisi, Java Güvenliği ve Donanım Sorun Giderme

Elektronik imza (e-imza), 5070 Sayılı Elektronik İmza Kanunu uyarınca ıslak imza ile birebir aynı hukuki bağlayıcılığa sahip Nitelikli Elektronik Sertifikadır (NES). Bilgisayarın token cihazını tanıması; USB CCID donanım katmanı, AKİS/SafeNet akıllı kart sürücüsü, PC/SC smart card servisi ve Java PKCS#11 kriptografik kütüphanesinin eksiksiz senkronizasyonuna bağlıdır.

Özellikle Windows 11 güncellemeleri ve macOS (Apple Silicon M1/M2/M3/M4) ortamlarında mimari farklılıklar nedeniyle kart okunamama, PIN bloke veya sertifika bulunamadı hataları sıkça yaşanmaktadır. Doğru sürücü paketinin yüklenmesi ve kriptografik kütüphane yollarının işletim sistemine tanıtılması sorunu kalıcı olarak çözer.

Uygulama ve Sorun Giderme Kontrol Listesi

  • Smart Card (SCardSvr) Servis Durumu: Windows Hizmetler (services.msc) panelinde Akıllı Kart servisinin 'Otomatik' başlangıç türünde ve çalışır durumda olduğu doğrulanmalıdır.
  • PKCS#11 Kütüphane Yolu: 64-bit Java uygulamalarında akisp11.dll veya macOS'ta libakisp11.dylib kütüphane dosyası doğru sistem dizininde bulunmalıdır.
  • USB Güç Tasarrufu Modunun Kapatılması: Aygıt Yöneticisi altındaki USB Kök Kümelerinde 'Güç tasarrufu için bu aygıtı kapatsın' seçeneği deaktif edilmelidir.
  • PIN ve PUK Güvenliği: PIN kodu 3 kez yanlış girildiğinde kilitlenen token, sağlayıcının online işlemler portalından PUK kodu ile sıfırlanmalıdır.

Sık Yapılan 3 Kritik Hata ve Çözüm Formülü

Hata: 'Kart Okuyucu Bulunamadı / Cihaz Takılı Değil' Uyarısı

Token cihazının USB 3.0 portlarında güç dalgalanması yaşaması veya sürücü sertifikasının tanınmamasından kaynaklanır. Cihaz doğrudan ana karta bağlı bir USB portuna takılmalıdır.

Hata: macOS Ortamında 'Library Not Loaded / dlopen' Hatası

macOS Sequoia ve Sonoma sürümlerinde ARM64 yerel Java ile x86_64 emülasyonu çakışır. Sisteme Java JDK 17+ ARM64 sürümü ve güncel OpenSC paketi kurulmalıdır.

Hata: Sertifika Süresi Dolmuş Token ile İşlem Yapılması

Süresi biten sertifikalar sistem tarafından anında geçersiz sayılır. Süre bitimine 30 gün kala yenileme başvurusu tamamlanmalıdır.

macOS Sequoia ve Sonoma E-İmza / Java Kurulum Tablosu Nasıl Uygulanır?

Apple Mac bilgisayarlarda (M1, M2, M3, M4) e-imza, akıllı kart sürücüsü ve Java kurulum adımları:

macOS Sequoia & Sonoma E-İmza Kurulum Parametreleri

Kurulum BileşenimacOS Uyumlu Paket / SürümTerminal Güvenlik KomutuDoğrulama Adımı
Java Runtime EnvironmentTemurin OpenJDK 8u412 (x64 veya aarch64)export JAVA_HOME=/Library/Java/...Terminalde 'java -version' komutuyla teyit
AKİS macOS KütüphanesiAKİS macOS PKCS#11 (.pkg)sudo spctl --master-disable (Gerekirse)AKİS uygulamasının Uygulamalar klasöründe açılması
Kart Okuyucu pcscd ServisimacOS yerel SmartCard altyapısısudo pkill -9 pcscdToken takılınca LED ışığının yanması
Tarayıcı Eklentisi (Chrome/Safari)Adalet Bakanlığı veya ESHS İmza YardımcısıTarayıcı güvenlik izinlerini onaylamaWeb arayüzünde sertifikanın listelenmesi
Featured Snippet (Sıfırıncı Sıra) Özeti: macOS Sequoia'da e-imza çalıştırmak için Apple Silicon uyumlu OpenJDK 8 kurulmalı ve terminalden kart kütüphanesine güvenlik izni verilmelidir.
A. Kılıç

A. Kılıç PKI_LEAD

Elektronik İmza & Kriptografi Uzmanı

Bilişim Sistemleri Y. Mühendisi | PKI & ESHS Danışmanı

5070 Sayılı Elektronik İmza Kanunu, BTK yetkili ESHS altyapıları, akıllı kart sürücüleri (AKİS/SafeNet) ve açık anahtar kriptografisi (PKI) alanında 10+ yıl deneyimli bilişim uzmanı.

← Tüm Rehberlere Dön

Yorumlar & Topluluk Deneyimleri 1 Yorum

Bu rehberle ilgili sorularınızı veya saha tecrübelerinizi paylaşın.

Yorum Yaz ↓
YM
Yazılım Mimarı T. Er macOS Sistem Uzmanı
07 Kasım 2026

macOS Sequoia sürümünde Apple Silicon ARM64 mimarisine yerel Akis sürücüsü kurarken spctl izinlerini tanımlama rehberiniz sayesinde şirketimizdeki 20 MacBook kullanıcısının UYAP imzalama sorununu tek seferde çözdük. Çok teşekkürler.

Bir Yorum Bırakın

Düşünceleriniz diğer okuyucular ve uzmanlar için değerlidir.

Bilgileriniz korunur. Yorumlar editoryal inceleme sonrası kalıcı olarak onaylanır.

İlginizi Çekebilecek Diğer Rehberler

Tümünü Gör →