Dijital Kimlik Lab ZERO-TRUST // PKI // KVKK MATRIX
Yazılım Geliştirme • 2026-09-24 • 6 dk okuma • Doğrulanmış Rehber • 0 Yorum

Web Uygulamalarında E-İmza Entegrasyonu: JavaScript ve WebSocket Kütüphaneleri

Google Chrome, Firefox ve Safari tarayıcılarının Java Applet ve NPAPI eklenti desteğini tamamen sonlandırmasıyla birlikte web tabanlı e-imza entegrasyonu modern WebSocket mimarisine evrilmiştir.

1. Localhost Agent Mimarisi Nasıl Çalışır?

Kullanıcının bilgisayarında çalışan hafif bir arka plan servisi (Örn: C# veya Go ile yazılmış yerel ajan), ws://localhost:8443 veya yerel HTTPS portu üzerinden dinleme yapar. Web sayfası JavaScript kodu bu ajana imzalanacak verinin özetini (SHA-256 hash) iletir; ajan PKCS#11 üzerinden USB token'daki anahtarla özeti imzalayıp web sayfasına döndürür. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için Çok Faktörlü Kimlik Doğrulamada SIM Swap ve Session Hijacking Saldırılarını Önleme rehberimizden de faydalanabilirsiniz.

2. WebAssembly ve WebUSB Geleceği

Geleceğin LegalTech web uygulamalarında harici ajan kurulumuna gerek kalmadan, W3C WebUSB API standartları ve WebAssembly (Wasm) kütüphaneleriyle tarayıcının doğrudan akıllı kartla konuşabilmesi hedeflenmektedir. Konuyla ilgili teknik gereksinimler ve mevzuat adımları için Kurumsal SaaS Platformlarında FIDO2 Passkey Entegrasyonu rehberimizden de faydalanabilirsiniz.

LTV Standartları: İmzaların uzun vadeli arşivlenmesi için LTV Doğrulama Rehberimizi inceleyin.
Resmî Mevzuat & Tebliğ Dayanağı

5070 Sayılı Elektronik İmza Kanunu ve W3C Modern Web Tarayıcı Güvenlik Standartları: Web tarayıcılarında Java Applet desteğinin (NPAPI) sona ermesiyle birlikte, istemci bilgisayarındaki akıllı karta erişim yerel WebSocket (127.0.0.1) köprü istemcileri aracılığıyla yasal standartlara uygun yürütülür.

Tarayıcı İstemcisi, Yerel WebSocket Köprüsü (Localhost) ve PKCS#11 DLL Çağrıları

Modern bir web uygulamasında (SaaS ERP, Hukuk Portalı, Bankacılık) kullanıcının e-İmza atabilmesi için 3 katmanlı bir mimari çalışır: 1) Sunucu Katmanı: İmzalanacak belgenin özetini (SHA-256 Hash) hesaplar ve web arayüzüne gönderir. 2) Web Arayüzü: JavaScript üzerinden yerel bilgisayarda çalışan arka plan uygulamasına `wss://127.0.0.1:port` üzerinden bağlanır. 3) Yerel Köprü (ArkSigner / Kamu SM İstemcisi): PKCS#11 kütüphanesini (`akisp11.dll`) çağırarak akıllı karttaki özel anahtarla hash'i imzalar. İmzalanan özet JavaScript üzerinden sunucuya döner ve belgeye iliştirilir; böylece megabaytlarca dosya internete yüklenmeden milisaniyeler içinde imzalanır.

Web Tabanlı e-İmza Entegrasyon Mimarileri Karşılaştırması

Entegrasyon Modeliİstemci YüküTarayıcı UyumluluğuHız ve Performans
Yerel WebSocket Köprüsü (Önerilen)Küçük bir arka plan servisi kurulurTüm Modern Tarayıcılar (Chrome, Edge, Safari)Çok Hızlı (Yalnızca hash taşınır)
WebCrypt / Tarayıcı EklentisiÖzel tarayıcı eklentisi gerektirirYalnızca desteklenen masaüstü tarayıcılarHızlı ancak eklenti bakım yükü yüksek
Java Web Start (JNLP)Java JRE kurulumu zorunluTarayıcı dışı harici pencerede açılırYavaş ve kullanıcıyı sistemden koparır
Bulut e-İmza (Uzaktan İmza)Kullanıcıda sıfır donanım/yazılımTüm Mobil ve Web TarayıcılarıAnlık (Özel anahtar HSM'de saklanır)

En Sık Karşılaşılan 3 Uygulama Hatası ve Çözüm Yolları

1 WebSocket Bağlantısını wss:// (SSL) Yerine ws:// Açıp Güvenlik Kısıtlamasına Takılmak

HTTPS sitelerde güvenli olmayan ws:// soketi tarayıcı tarafından 'Karma İçerik' gerekçesiyle engellenir.

2 İmzalanacak Tüm PDF Dosyasını İstemciye İndirip Ağ Trafiğini Kilitlemek

Kural: Dosya asla istemciye inmez, yalnızca sunucuda hesaplanan 32 byte'lık SHA-256 hash imzalanır.

3 Antivirüs Yazılımlarının 127.0.0.1 Yerel Port İletişimini Engellemesini Öngörememek

Uygulama kurulum paketinde antivirüs istisnası ve SSL kök sertifika tanımı bulunmalıdır.

SaaS İK Yazılımı Vakası: 100.000 Çalışanın Sözleşmelerini WebSocket ile İmzalatma

Büyük bir İK yazılımı şirketi, bordro onayları için Java Applet kullanırken sürekli destek çağrısı almaktaydı. Yazılım ekibi yerel hafif bir WebSocket köprüsü geliştirmiş; web sayfası tek tıkla kullanıcının akıllı kartına bağlanarak bordro hash'ini 2 saniyede imzalatmış ve destek talepleri %95 oranında azalmıştır.

Uygulama ve Denetim Kontrol Listesi (Checklist)

  • Sunucu tarafında belgenin CAdES veya PAdES formatına uygun SHA-256 hash'ini hesaplayan kütüphaneyi kurun.
  • Kullanıcı tarafında çalışacak hafif yerel istemcinin (Localhost Service) Windows ve Mac kurulum paketlerini hazırlayın.
  • Yerel istemciye geçerli bir 127.0.0.1 yerel SSL sertifikası tanımlayarak `wss://` bağlantısını garantiye alın.
  • JavaScript API üzerinden akıllı kart takılı mı, sertifika geçerli mi kontrollerini yapın.
  • İmza sonucunu sunucuya döndürerek doğrulama servisinden (CRL/OCSP) yeşil onay aldığını kontrol edin.
İlgili Rehber & Dizin: Web uygulamalarında kişisel verilerin korunması ve VERBİS yükümlülükleri için: VERBİS Kayıt ve Web Güvenliği Rehberi sayfamızı inceleyebilirsiniz. Dizine Git →
B. Demirtaş

B. Demirtaş [CISSP / CEH]

Kıdemli Bilgi Güvenliği & Kimlik Doğrulama Uzmanı

CISSP | CEH | ICAO e-ID & Zaman Damgası Mimarisi

Zaman damgası protokolleri (RFC 3161), ICAO çipli kimlik standartları, kurumsal kimlik yönetimi (IAM) ve oltalama (phishing) koruması konularında uzman siber güvenlik analisti.

← Tüm Rehberlere Dön

Yorumlar & Topluluk Deneyimleri Henüz Yorum Yok

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

Yorum Yaz ↓

Henüz Yorum Yapılmamış

Bu rehber hakkındaki deneyimlerinizi veya teknik sorularınızı aşağıdaki formu kullanarak ilk siz paylaşın.

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 →