Tarayıcıda Dijital İmza (Eİ) ile Çalışmak İçin CryptoPro Eklentisinin Yapılandırılması

Elektronik imzanın (Eİ) tarayıcıda çalışması için üç bileşenin kesin bir sırayla kurulması gerekir: sertifikanın "Kişisel" depolama alanına yüklenmesi, CryptoPro CSP programı ve CryptoPro Browser Plugin uzantısı. Bu öğelerden herhangi biri eksikse, siteler (Gosuslugi, FNS, ticaret platformları) imzanızı göremez.

CryptoPro Browser Plugin Nedir ve Neden Gereklidir?

CryptoPro Browser Plugin, tarayıcı ile bilgisayara yüklü kriptografik yazılım (CryptoPro CSP) arasında bir köprü görevi görür. Eklentinin kendisi verileri şifrelemez veya anahtarları saklamaz. Sadece web sayfasından gelen isteği, belgelerin imzalanması veya kimlik doğrulaması için yerel yazılıma iletir.

Adım Adım Kurulum ve Yapılandırma

Yapılandırma süreci üç aşamaya ayrılır. Sıranın bozulması, sorunların en yaygın nedenidir.

1. Adım. Kök Sertifikanın ve Kişisel Anahtarın Yüklenmesi

Eklentiyi kurmadan önce, Eİ sertifikanızın sistem tarafından görülebildiğinden emin olun.

1. CryptoPro Araçlarını (veya certmgr.msc) açın.
2. Kişisel -> Sertifikalar bölümüne gidin.
3. Sertifikanızın listede bulunduğundan ve ilişkili bir özel anahtara sahip olduğundan emin olun (sertifika simgesindeki anahtar işareti).
4. Sertifika yoksa, CryptoPro CSP kontrol panelindeki "Kişisel sertifikayı yükle" seçeneği aracılığıyla yükleyin.

2. Adım. CryptoPro CSP'nin Kurulması ve Kontrol Edilmesi

Eklenti, kripto sağlayıcının kendisinin mevcut olmasını gerektirir.

1. Resmi web sitesinden güncel CryptoPro CSP 5.0 sürümünü (veya eski yazılımlarla uyumluluk gerekiyorsa 4.0 sürümünü) indirin.
2. Programı kurun ve bilgisayarı yeniden başlatın.
3. Lisans anahtarını girin veya CryptoPro CSP kontrol paneli üzerinden ("Genel" sekmesi -> "Lisans gir") 90 günlük deneme süresini etkinleştirin.

3. Adım. Uzantının Tarayıcıya Yüklenmesi

Uzantı, Chromium tabanlı tarayıcılar (Yandex.Browser, Google Chrome, Microsoft Edge, Chromium-Gost) ve Firefox için mevcuttur.

Yandex.Browser ve Chrome için:

1. Tarayıcınızın uzantılar kataloğuna gidin.
2. CryptoPro Extension for CAdES Browser Plug-in öğesini bulun.
3. "Ekle" veya "Yükle" düğmesine tıklayın.
4. Kurulumdan sonra eklenti simgesi uzantılar panelinde (puzzle parçası) görünecektir.

Firefox için:

1. Mozilla Add-ons eklentilerine gidin.
2. CAdES Browser Plug-in öğesini yükleyin.

Yaygın Hatalar ve Çözüm Yöntemleri

Doğru kuruluma rağmen arızalar meydana gelebilir. Aşağıda en yaygın sorunlar ve bunların giderilme yöntemleri listelenmiştir.

Hata: "Eklenti yüklü değil" veya "Eklenti sürümü desteklenmiyor"

Bu hata, sitenin yerel hizmetle iletişim kuramadığında ortaya çıkar.

Çözüm:

1. cades_plugin.exe veya cryptopro_cades işleminin çalışıp çalışmadığını kontrol edin.
2. Tarayıcının adres çubuğunda eklenti kontrol sayfasına gidin (genellikle bu, CryptoPro'nun kendi sayfası veya çalıştığınız portalın test sayfasıdır).
3. Eklenti sürümünün CSP sürümüyle eşleştiğinden emin olun. CSP 5.0 için eklentinin en son sürümü gerekir.
4. Eski uzantıyı tamamen kaldırarak eklentiyi yeniden yükleyin.

Hata: "Özel anahtara erişim yok" / "Anahtar bulunamadı"

Tarayıcı sertifikayı görür ancak belgeyi imzalayamaz.

Nedenler ve çözümler:

• Yanlış depolama alanı: Sertifika, geçerli kullanıcının "Kişisel" depolama alanında bulunmalıdır. "Diğer kullanıcılar" veya "Güvenilen kökler" içindeyse, taşıyın.
• Erişim hakları: Tarayıcıyı yönetici olarak çalıştırın (nadiren gerekir ancak kurumsal ağlarda yardımcı olur).
• Anahtar bağlantısı: CryptoPro CSP kontrol panelinin "Hizmet" sekmesinde, seçili konteynerde "Test et" düğmesine tıklayın. Test başarısız olursa, anahtar hasar görmüş veya okuyucu (flash bellek/token) bağlantısı kesilmiş demektir.

Hata: "Sertifika geçersiz" veya "Sertifika zinciri oluşturulamadı"

Sertifika Yetkilisine (CA) güven sorunu.

Çözüm:

1. Eİ'nizi veren Sertifika Yetkilisinin kök sertifikasını "Güvenilen Kök Sertifika Yetkileri" deposuna yükleyin.
2. Sertifika Yetkilisinin ara sertifikalarını "Ara Sertifika Yetkileri" deposuna yükleyin.
3. Rusya Dijital Kalkınma Bakanlığı'nın güncel kök sertifikalarını resmi Gosuslugi portalında veya CryptoPro web sitesinde bulabilirsiniz.

Firefox'ta Hata: "Bağlantı güvenli değil" veya NPAPI engellemesi

Firefox'un modern sürümleri eski eklenti türlerini iyi desteklemez.

Çözüm: Firefox için özel eklenti sürümünü kullanın veya Chromium tabanlı bir tarayıcıya geçin. Firefox için, modern CryptoPro Browser Plugin dağıtımlarıyla birlikte gelen Native Messaging Host'un yüklü olması şarttır.

Kullanıcıların Sık Yaptığı Hatalar

SSS

Eklentinin çalışması için internet gerekli mi? Hayır, eklenti yerel olarak çalışır. İnternet yalnızca imza isteyen web sitesiyle bağlantı kurmak için gereklidir. İmzalama işlemi bilgisayarınızda gerçekleşir.

Eklenti macOS ve Linux'ta çalışıyor mu? Evet, CryptoPro CSP ve Browser Plugin macOS ve Linux'u (Astra Linux, ALT Linux, Ubuntu) destekler. Kurulum süreci benzerdir ancak işletim sisteminize özgü dağıtımlar gerekir. macOS'ta genellikle "Sistem Tercihleri" -> "Genel" -> "Profiller" bölümünde uzantıya izin verilmesi gerekir.

Windows güncellemesinden sonra eklenti çalışmayı durdurursa ne yapılmalı? Çoğu zaman sistem güncellemeleri CSP kütüphanelerine giden yolları bozar. CryptoPro CSP'yi mevcut sürümün üzerine yeniden yüklemeyi ("Onarım" modu) deneyin ve PC'yi yeniden başlatın.

Eİ telefonlarda kullanılabilir mi? Standart CryptoPro Browser Plugin, mobil cihazlarda (Android/iOS) normal tarayıcıda çalışmaz. Mobil imzalama için "Goskluch" uygulamasını veya Eİ operatörünüz tarafından sağlanıyorsa kriptografi destekli özel tarayıcıları kullanın.