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.
- Terminal uygulamasını açın ve cihaz mimarinizi doğrulamak için
uname -mkomutunu çalıştırın (arm64 yanıtı gelmelidir). - Resmi Java portalından macOS x64 değil, mutlaka macOS ARM64 DMG Installer paketini indirin.
- İndirilen paketi kurduktan sonra Terminal'de
java -versionyazarak 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.
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.
Resmi ve Güvenilir Kaynaklar:
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şeni | macOS Uyumlu Paket / Sürüm | Terminal Güvenlik Komutu | Doğrulama Adımı |
|---|---|---|---|
| Java Runtime Environment | Temurin OpenJDK 8u412 (x64 veya aarch64) | export JAVA_HOME=/Library/Java/... | Terminalde 'java -version' komutuyla teyit |
| AKİS macOS Kütüphanesi | AKİS macOS PKCS#11 (.pkg) | sudo spctl --master-disable (Gerekirse) | AKİS uygulamasının Uygulamalar klasöründe açılması |
| Kart Okuyucu pcscd Servisi | macOS yerel SmartCard altyapısı | sudo pkill -9 pcscd | Token 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 onaylama | Web arayüzünde sertifikanın listelenmesi |
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.