ESYA’dan İmza API’sine Geçiş: Kurumsal Migrasyon Rehberi

ESYA e-imza kütüphanesinin ücretsiz sürümünün kullanımdan kalkması, imzalama altyapısını kendi uygulamasının içine gömmüş ekipleri bir karar noktasına getirdi. Bu rehber, kütüphane tabanlı bir yapıdan servis/API tabanlı bir imzalama mimarisine geçerken izlenecek yolu, vendor bağımsız biçimde özetliyor.

Mimari Fark: Kütüphane mi, Servis mi?

• Kütüphane yaklaşımı: İmza kodu uygulamanızın içinde çalışır. Sürüm yönetimi, platform bağımlılıkları ve güncellemeler size aittir.
• Servis/API yaklaşımı: İmzalama işlemi HTTP çağrılarıyla ayrı bir servise devredilir. Uygulamanız hafifler, güncellemeler merkezîleşir; buna karşılık ağ erişimi, gecikme ve servis sürekliliği yeni birer değişken olur.

Doğru seçim iş yükünüze bağlıdır. Yoğun toplu imzalama yapan bir sistemde ağ turlarının maliyetini, düşük hacimli bir uygulamada ise bakım yükünü öne alın.

Migrasyon Kontrol Listesi

1. Envanter: İmza üreten tüm kod noktalarını çıkarın; hangi modül, hangi belge tipi, hangi format?
2. Format eşleştirmesi: Kullandığınız imza formatlarının (belge içine gömülü ya da ayrık imza) yeni çözümde birebir karşılığı var mı?
3. Sertifika erişimi: İmza kullanıcının token’ında mı üretilecek, yoksa sunucu tarafında saklanan bir sertifikayla mı? Bu, hukuki sorumluluğu doğrudan etkiler.
4. Zaman damgası: Mevcut akışta zaman damgası varsa yeni yapıda da olmalı; ayrıntılar zaman damgası yazımızda.
5. Doğrulama: Ürettiğiniz imzaları bağımsız doğrulama araçlarıyla test edin — kendi kodunuzla doğrulamak yeterli değildir.
6. Hata yönetimi: Servis erişilemediğinde kullanıcıya ne olacak? Kuyruk mü, hata mı, yeniden deneme mi?
7. Pilot ve geri dönüş planı: Tek modülde pilot yapın, sorun çıkarsa eski akışa dönebilecek şekilde ilerleyin.

Sık Atlanan Üç Nokta

• Arşivdeki eski imzalar: Geçmişte üretilmiş belgeler yeni sistemde de doğrulanabilmelidir; doğrulama tarafını unutmayın.
• Kullanıcı deneyimi: İmza ekranı değişiyorsa son kullanıcıyı önceden bilgilendirin; aksi hâlde destek hattınız kilitlenir.
• Yetkili sertifikaları: Test ve canlı ortam için ayrı sertifikalar planlayın; canlı yetkilinin token’ıyla test yapmak kötü bir alışkanlıktır.

Değişikliğin genel çerçevesini ESYA kütüphanesi kapanıyor yazımızda, imzanın kullanıcı tarafındaki karşılığını ise nasıl e-imza atılır rehberimizde bulabilirsiniz.

Hizmet Bölgelerimiz

Ankara’nın üniversite ve teknoloji hattındaki yazılım ekiplerine aynı gün elden teslim: Beytepe, Bilkent, Ümitköy, Çayyolu, 100. Yıl, Çiğdem Mahallesi, Üniversiteler Mahallesi ve Mustafa Kemal Mahallesi. Geliştirme ve test ihtiyacınız için birden fazla sertifikayı tek seferde tedarik ediyoruz. Türkiye’nin her iline kargoyla adrese teslim.