UYAP'ın kendine özgü UDF formatında imza alırken karşılaşılan 'kart okuyucu bulunamadı', 'imza kütüphanesi yüklenemedi' ve 'Java security exception' hataları 2026 boyunca avukatların gündeminden düşmedi. Hatalar farklı görünse de altta yatan birkaç temel sebep var.

UYAP Doküman Editörü, Java tabanlı bir masaüstü uygulaması olarak yıllar içinde Türkiye'nin neredeyse tüm avukatlarının iş akışına yerleşti. 2026'da Windows 11'in 24H2 güncellemesi, yenilenen AKİS kart sürücüleri ve genişleyen 64-bit Java ortamı bir araya gelince eski sürüm UYAP Editör kurulu cihazlarda çok sayıda imzalama hatası ortaya çıktı.

Türkiye Barolar Birliği bu konuda 2026 boyunca birden fazla bilgilendirme yayımladı; barolar da kendi üyeleri için pratik kılavuzlar paylaştı. Bu yazıda en sık karşılaşılan UDF imzalama hatalarını, gerçek sebeplerini ve adım adım çözümlerini ele alıyoruz. Hedefimiz, son dakikaya kalan bir tebliğ gününde panik yapmadan sorunu sahada çözebilmenizdir.

UDF nedir, neden ayrı bir formatın imzalanması gerekir?

UDF (UYAP Doküman Formatı): UYAP'ın resmi yazışma standartlarına uygun, dijital imza alanları gömülebilen yapısal bir doküman biçimidir. PDF veya DOCX'ten farklı olarak doğrudan UYAP Doküman Editörü ile açılır ve elektronik imza akışı bu format üzerinden işletilir.

UYAP, mahkemelere ve icra dairelerine sunulan belgelerin biçimsel tutarlılığı için UDF formatını ortak zemin olarak kabul eder. Format, sayfa düzeni, imza alanı, ek listesi ve doküman üst bilgisi gibi metin işlemcilerin standart olarak sunmadığı UYAP'a özgü alanları taşır. Bu yüzden UDF, basit bir doküman değil; doğrudan UYAP iş akışına bağlı yapısal bir kayıttır.

UYAP Doküman Editörü, UDF dosyalarının hem oluşturulması hem de imzalanması için resmi araçtır. Editör Java tabanlı çalışır; bu, ona platformlar arası taşınabilirlik avantajı sağlar ama aynı zamanda Java mimarisindeki değişikliklere duyarlı olmasına yol açar. Bu duyarlılık, 2026 yılındaki sorunların büyük bölümünün arka planındaki teknik gerçekliktir.

Pratik sonuç: PDF veya Word olarak hazırladığınız bir dilekçeyi UYAP'a sunabilmek için pek çok durumda UDF biçiminde de saklamanız ve imzalamanız gerekir. UDF imzalama sorununun "neden ortak bir PDF imzaya geçemiyoruz" şikayetiyle çözümü yok; çünkü UYAP'ın arka uç iş akışı bu formatın gömülü imza alanlarına dayalıdır.

2026'da en sık karşılaşılan üç imza hatası

2026 yılı boyunca avukatlar ve bürolardan toplanan raporlarda en sık tekrarlanan üç hata öne çıkıyor:

  1. "İmza kütüphanesi yüklenemedi": UYAP Editör'ün AKİS PKCS#11 kütüphanesini bulamadığı veya yanlış mimarinin yüklenmesi.
  2. "Kart okuyucu bulunamadı": AKİS sürücüsü, kart okuyucu sürücüsü ya da fiziksel bağlantıda problem; bazen de Java tarafında "Security Exception" olarak görünür.
  3. "Lisans kontrolü hatası" / imzalama yarıda kalıyor: UYAP Editör sürümü, Java sürümü veya merkezi UYAP servisleriyle uyumsuzluk.

Bu üç ana grubun ortak özelliği şu: hata mesajları yüzeyde farklı görünür, ama altta birkaç çekirdek nedenden birinde toplanırlar. Doğru çözüm yolu, hata mesajına değil olası nedenlerin elenmesine odaklanmaktır.

Pratik bir kural: yeni bir hata gördüğünüzde aklınızda "neyi değiştirdim?" sorusunun olması, çözüm süresini ciddi biçimde kısaltır. Son zamanlarda işletim sistemi güncellemesi mi geçtiniz, Java sürümü mü değişti, yeni bir kart okuyucuya mı geçtiniz, AKİS güncellendi mi? Hata bu değişikliklerden biriyle ilişkili olma ihtimali her zaman yüksektir; en son değişen değişken, en sık suçludur.

Çözüm 1: UYAP Doküman Editörü'nü güncel sürüme almak

Çoğu sorun, UYAP Editör'ün eski sürümlerinden kaynaklanır. Şu adımları izleyin:

  1. Mevcut UYAP Editör'ü Denetim Masası → Programlar üzerinden kaldırın. macOS'taysanız Uygulamalar klasöründen Çöp Kutusu'na atın.
  2. Bilgisayarı yeniden başlatın. Bu adım, eski Java süreçlerinin tam olarak kapanması için önemlidir.
  3. uyap.gov.tr/Uyap-Editor adresinden işletim sisteminize uygun en güncel sürümü indirin.
  4. Kurulumu yönetici izniyle gerçekleştirin. Windows'ta sağ tıklayıp "Yönetici olarak çalıştır"; macOS'ta Gizlilik ve Güvenlik penceresinden gelen uyarıyı onaylayın.
  5. Kurulum biter bitmez UYAP Editör'ü açıp Ayarlar bölümüne girip yeni sürümün hangi Java ve hangi imza kütüphanesini kullandığını görün.

Bu adım tek başına vakaların önemli bir kısmında sorunu çözer; çünkü 2026'daki en sık problem, eski UYAP Editör'ün artık güncel olmayan Java/AKİS uyumlulukları beklemesidir.

Çözüm 2: AKİS sürücüleri ve PKCS#11 kütüphane yolu

"İmza kütüphanesi yüklenemedi" hatasının kalbi burada atar. Windows için klasik adımlar:

  • akisp11.dll'i bulun: Dosyanın C:\Windows\System32\akisp11.dll yolunda bulunması beklenir. 64-bit sistemlerde aynı dosyanın 32-bit muadili C:\Windows\SysWOW64\akisp11.dll içinde de bulunmalıdır.
  • AKİS sürücüsünü yeniden kurun: Eski sürümü kaldırın; sertifika sağlayıcınızın (TÜRKTRUST, e-Güven vb.) sitesinden en güncel macOS / Windows AKİS yazılımını indirip kurun.
  • UYAP Editör'de yol tanımını doğrulayın: Editör → Ayarlar → İmza Kütüphanesi bölümünden, akisp11.dll yolunun doğru olduğunu kontrol edin. Bu alan boş ya da yanlış ise hata mesajı doğrudan "kütüphane yüklenemedi" der.
  • Mimari uyumu: 64-bit Java kullanıyorsanız 64-bit akisp11.dll'ye işaret etmelisiniz. 32-bit Java + 64-bit DLL kombinasyonu sessizce başarısız olabilir.

macOS için ise PKCS#11 kütüphanesi farklı bir yolda bulunur (sürüme göre değişir). AKİS macOS yazılımını kurarken kurulumun bittiği yolu not alın; UYAP Editör Mac sürümünde aynı yolu ayarlardan doğrulayın.

Çözüm 3: Java mimarisi ve güvenlik politikası

2026'da pek çok büro, Java tarafından kaynaklanan iki temel sorunla yüzleşti:

  • Eski Java 8 (1.8) ile yeni AKİS sürümlerinin uyumsuzluğu. UYAP Editör'ün önceki sürümleri 32-bit Java 8'e bağımlıydı; 2026'da güncellenen AKİS sürücüleri 64-bit Java ile daha sorunsuz çalışır hâle geldi. Eski yapıdaki bilgisayarlarda imzalama yarıda kalabilir.
  • Java Security Policy ayarları. Bazı kurumsal bilgisayarlarda Java'nın güvenlik politikası imzalama eklentilerini engelleyebilir. Java Kontrol Paneli'nden (Windows'ta "Configure Java") "Security" sekmesinden güvenlik seviyesini gözden geçirin; UYAP alanını istisna listesine ekleyin.

Uygulamada şu pratik kural çoğu büro için doğrudur: UYAP Editör'ün en güncel sürümü hangi Java sürümünü öneriyorsa, onu kurun. Aynı bilgisayarda birden fazla Java sürümü tutmak, hangisinin kullanılacağı konusunda istikrarsızlık yaratır.

Çözüm 4: .uki klasörü temizliği ve mobil imza

Mobil imzayla UDF imzalayamayan avukatlar için klasikleşmiş bir çözüm vardır. UYAP Editör, kullanıcı klasörünün altında bir .uki dizini tutar; burada açılış değerleri, son açılan dosyalar ve tercihler saklanır. Bu dosyalar bozulduğunda mobil imza akışı kırılabilir.

  1. Kullanıcı klasörünüze gidin (Windows: C:\Users\<kullaniciAdi>\; macOS: /Users/<kullaniciAdi>/).
  2. .uki klasörünü açın.
  3. İçindeki acilisDegerleri, lastOpened ve tercihler dosyalarını silin (klasörün kendisini değil, yalnızca bu üç dosyayı).
  4. UYAP Editör'ü kapatıp yeniden açın. Mobil imza akışını tekrar deneyin.

Bu adım, "mobil imza penceresi açılmıyor" veya "imza isteği gönderilemedi" benzeri hataların çoğunda işe yarar. Operatörünüzden gelen mobil imza onay SMS'inin geldiğinden ve sertifikanızın aktif olduğundan da emin olun.

Çözüm 5: Sertifika geçerlilik kontrolü ve sürücü çakışmaları

Yukarıdaki dört adımı uyguladığınız hâlde sorun çözülmüyorsa kalan iki büyük olasılık şudur:

  • Sertifika süresi dolmuş olabilir. Sağlayıcınızın müşteri portalından sertifikanın geçerlilik tarihini kontrol edin. Genel görünen pek çok hata, aslında biten bir sertifikanın son aşamada başarısız olmasından kaynaklanır.
  • Birden fazla kart yazılımı çakışması. Bilgisayarınızda SafeNet, AKİS dışı bir kart yazılımı veya eski versiyonlar bir arada kuruluysa hangi sürücünün konuştuğu konusunda belirsizlik oluşur. Kullanmadığınız kart yazılımlarını kaldırın.

Bu noktada hâlâ çözüm bulunamadıysa TBB ve baronuzun duyurularına bakın. UYAP'ta merkezi bir aksaklık olduğunda bu kanallarda hızla bilgilendirme yapılır; "sorun bende mi?" şüphesine düşmeden kaynağı görmek vakit kazandırır.

Sertifika sağlayıcıları kart yenileme sürecini birkaç haftaya yayabilir; bu yüzden geçerlilik tarihinin son 30 günü yakalandığında yenileme başvurusunu vakit kaybetmeden başlatın. Yenilenen sertifikanın bilgisayarınızda görünebilmesi için bazen kart sürücüsünün yeniden başlatılması veya cihazın yeniden başlatılması gerekir; bu fiziksel adımı atlamak yine "kart bulunamadı" hatasına dönüşür.

Belirli ortamlar için ek ipuçları

Aşağıdaki üç senaryo, Türk hukuk bürolarında özellikle sık karşılaşılan ortamlar. Yaşıyorsanız özel olarak gözden geçirin:

  • Windows 11 24H2 üzerinde yeni kurulum: Smart App Control ve yeni güvenlik politikaları imza eklentilerine müdahale edebilir. Kurulumdan sonra Windows Güvenliği → Uygulama ve Tarayıcı Denetimi bölümünden UYAP Editör'ün engellenmediğinden emin olun.
  • VPN ya da kurumsal proxy: Bürodaki ağ politikaları, UYAP'ın gerekli arka uç servislerine erişimi engelliyor olabilir. İmzalamadan önce VPN'i kapatıp deneyin; sorun ortadan kalkıyorsa BT yöneticinizle UYAP IP/alan adlarının istisna listesine eklenmesini konuşun.
  • Sanal makine (VM) kullanımı: Sanal makine içinde USB kart okuyucunun "passthrough" edilmesi her zaman stabil değildir. İmzalama gibi kritik akışlarda doğrudan ana makinede çalışmak en güvenli yoldur.

İmzanın gerçekten geçerli olup olmadığını nasıl doğrulayalım?

UYAP imza akışı "başarılı" mesajı verdiğinde işin bittiğini varsaymayalım. Pratikte üç hızlı doğrulama önerilir:

  • İmza alanı görünüyor mu? UDF dosyasının imza alanında adınızın, kurumunuzun ve imza zamanının doğru görüntülendiğini açıp kontrol edin.
  • Saat damgası (zaman damgası) eklendi mi? İcra gibi süre kritik işlerde zaman damgalı imza şarttır; sertifikanız zaman damgası destekliyorsa bu adımın işaretli olduğunu doğrulayın.
  • UYAP'a yükleme aşamasında ek bir hata var mı? İmzaladığınız UDF'yi UYAP üzerinden ilgili dosyaya yüklemeye çalıştığınızda hata almıyor olmak, imzanın gerçekten kabul edildiğinin nihai kanıtıdır.

Sık görülen bir karışıklık: "Editör üzerinde imzaladım, başarılı dedi; ama UYAP yükleme yapmıyor." Bu durumda imza alanının doğru gömülmediği veya sertifikanın UYAP tarafında tanınmıyor olduğu olasıdır. Sertifikanızın UYAP Avukat Portal'ı için kayıtlı olduğunu sağlayıcınızla teyit edebilirsiniz.

UDF imzalama akışını sade tutmanın yolu

Bürodaki tüm avukatların farklı bilgisayarda farklı Java sürümleriyle çalışması, sorun yaşandığında "biri başarıyor diğeri başaramıyor" karmaşasına yol açar. Şu basit politikalar, bu karmaşayı azaltır:

  • Ortak bir kurulum kontrol listesi tutun. Hangi UYAP Editör sürümü, hangi Java, hangi AKİS — üç satırlık bir not yeterlidir.
  • Yıllık bir bakım günü belirleyin. Adli tatil veya yoğun olmayan bir hafta sonu, tüm bilgisayarlarda sürümleri güncel hâle getirin. Sorun bir tebliğ günü çıkmasın.
  • Yeni gelen avukat / stajyere standart kurulum yapın. "Bende çalışıyor" tabanlı dağınık kurulumlar büronun teknik borcunu büyütür.
  • İmza akışında "tek noktada başarısızlık" yaratmayın. Tek bir bilgisayar veya tek bir kart üzerinden çalışan bürolarda o gün hata çıkması işi durdurur. Yedek bir kart okuyucu, mobil imza yedeği veya en az iki kuruluma sahip bir avukat ofiste hazır bulunsun.

Sonuç

UDF imzalama sorunları zor görünse de kaynakları belli ve çözüm yolları büyük oranda tekrar eder. Pratik bir yaklaşım, hata mesajına saplanmak yerine sırayla eleme yapmaktır: UYAP Editör güncel mi, AKİS doğru mu kurulu, Java mimarisi uyumlu mu, .uki klasörü temiz mi, sertifika hâlâ geçerli mi? Bu beş soruyu rutin biçimde sorduğunuz sürece kritik bir tebliğ gününde sürpriz yaşama olasılığınız ciddi biçimde azalır. UYAP altyapısı kademeli olarak yenileniyor; iyi kurulmuş ve güncel tutulan bir büro kurulumu, bu geçiş döneminde de işin akışını bozmaz.

Sıkça Sorulan Sorular

'İmza kütüphanesi yüklenemedi' hatası gördüğümde ne yapmalıyım?

İlk adım, UYAP Doküman Editörü → Ayarlar → İmza Kütüphanesi bölümünde tanımlı yolun doğru olduğunu doğrulamaktır. Windows için tipik yol C:\Windows\System32\akisp11.dll'dir; 64-bit sistemlerde SysWOW64 altındaki muadil dosyanın da bulunması beklenir. AKİS sürücüsünü yeniden kurmak çoğu durumda yeterlidir.

UDF dosyamı PDF olarak imzalayabilir miyim?

UYAP'a sunulması gereken bazı evraklar UDF olarak imzalanmak zorundadır; çünkü UYAP iş akışı bu formatın gömülü imza alanlarını kullanır. PDF'e dönüştürdüğünüz bir belge UYAP'taki bazı işlemler için kabul edilmeyebilir; mahkeme veya icra dairesinin talep ettiği biçime sadık kalmak en güvenli yoldur.

AKİS sürücüsünü güncellediğim hâlde sorun devam ediyor; başka ne kalıyor?

En sık görülen ikinci sebep, yüklü Java sürümünün mimariyle (32-bit / 64-bit) UYAP Editör'ün beklediği sürümün uyumsuz olmasıdır. UYAP Editör'ü kaldırıp güncel sürümle yeniden kurmak, Java cache'ini temizlemek ve gerekiyorsa eski Java sürümlerini kaldırmak çoğu durumda çözüm olur.

Mobil imza ile UDF imzalayamıyorum; ne yapmalıyım?

Mobil imza akışlarında kullanıcı klasörünüzün altındaki .uki klasöründe yer alan acilisDegerleri, lastOpened ve tercihler dosyalarını silip UYAP Editör'ü yeniden açmak çoğu kullanıcıda sorunu giderir. Operatörünüzün mobil imza sertifikanızın aktif olduğundan da emin olun; SMS onayı gelmiyorsa numaranızın doğru kayıtlı olduğunu kontrol edin.

E-imza sertifikamın süresi dolmuş olabilir mi?

Evet, bu çoğunlukla atlanan bir noktadır. Sertifika sağlayıcınızın (TÜRKTRUST, e-Güven vb.) müşteri portalından geçerlilik tarihini kontrol edin; süresi dolan sertifika imza adımının son aşamasında genel bir hata mesajıyla başarısız olabilir ve bu yüzeyde 'UYAP hata veriyor' gibi görünür.

Sorun yalnızca benim bilgisayarımda mı, yoksa toplu mu yaşanıyor?

TBB, baro web siteleri ve UYAP duyurularını takip etmek faydalıdır. UYAP altyapısında merkezi bir aksaklık varsa Adalet Bakanlığı ve TBB hızla duyurmaktadır; 'ben mi yapamıyorum' şüphesine düşmeden önce duyurulara bakmak vakit kazandırır.