Yeni mali mühürle atılan imza neden doğrulanmıyor?

Önce imzanın gerçekten oluştuğunu belirleyin

Yeni mali mührünüzle işlem tamamlandı görünüyor, fakat başka bir bilgisayarda imza doğrulanmıyorsa önce oluşan dosyayı ve hata mesajını kaydedin. İmzalama aracının çalışması, imzalı çıktının oluşması ve o çıktının doğrulanması ayrı sonuçlardır. Sertifikanın yenilenmiş olması, tek başına sorunun kök sertifikadan kaynaklandığını göstermez.

Bu rehber, yenilenen mali mühürle üretilmiş bir imzanın doğrulama sonucunu incelemek içindir. Kart algılanmıyorsa veya PIN aşamasında işlem duruyorsa henüz bu aşamada değilsiniz. Yanlış sertifika seçilmiş olma ihtimalini de başta eleyin; aynı kurum adına düzenlenen eski ve yeni sertifikaların seri numaraları farklı olabilir.

Aynı belgeyi ve imzada kullanılan sertifikayı bulun

İncelemeye özgün imzalı dosyanın bir kopyasıyla başlayın. Asıl dosyayı düzenlemeyin, yeniden kaydetmeyin veya yeni mühürle tekrar imzalayıp eski kaydın üzerine yazmayın. Dosya adı, belge kimliği ve alınma kaynağını not edin. E-faturada yalnız PDF görüntüsünü karşılaştırmak yerine ilgili imzalı XML’i kullandığınızı teyit edin.

GİB’in Haziran 2018 tarihli Entegrasyon Kılavuzu, XML verisi ile görüntü oluşturan XSLT’yi ayırıyor; veri kuralları ve mali mühür doğrulaması da ayrı kontroller. Eylül 2015 tarihli Görüntüleyici Kılavuzu ise belgeyi açma, imzayı doğrulama ve GİB’den sorgulama işlevlerini ayırıyor. Bu eski belgeleri güncel kurulum veya menü talimatı olarak kullanmayın. Okunabilir bir fatura görüntüsü, tamamlanmış imza kontrolü değildir.

Kamu SM’nin mali mühür kullanım sayfasında, sertifika listesinden seri numarasıyla ayrıntıya ulaşılabildiği açıklanıyor. Bu kaydı, doğrulama aracının imzanın içinde gösterdiği sertifikayla karşılaştırın. Kurum bilgisi, seri numarası ve geçerlilik aralığı eşleşsin. Yalnız bilgisayarda takılı yeni kartı görmek, daha önce üretilmiş dosyanın hangi sertifikayla imzalandığını açıklamaz.

Bütünlük, zincir ve sertifika durumunu ayrı okuyun

Hatanın tam metnini alın. Bütünlük veya imza değeri kontrolüyle sertifika zinciri kontrolünün aynı sonucu verdiğini varsaymayın. Bir doğrulayıcıda “sonuç alınamadı” görülmesini doğrudan “belge değiştirilmiş” diye kaydetmek yerine hangi kontrolün tamamlanamadığını sorun. Eksik veya farklı dosya ihtimaliyle doğrulama ortamı ihtimalini ayrı takip edin.

Kamu SM’nin mali mühür Belgeler sayfasında kurumsal kök, mali mühür ara sertifikaları ve ilgili sertifika iptal listeleri ayrı yayımlanıyor. Belgedeki sertifikayı veren makamı ve araçta görülen zinciri bu resmî kaynakla eşleştirin. Sayfada birden fazla sürüm bulunması, hepsini gelişigüzel yüklemeniz gerektiği anlamına gelmez. Gereken zinciri uygulama desteğine doğrulatın.

Listede bulunan SHA özet değerleri, ilgili dosyanın karşılaştırılmasında kullanılacak bilgilerdir; şifreleme adı değildir. Yeni mali mühür için belirli bir kök sürümünün zorunlu olduğunu veya bir algoritmanın belli tarihte değiştiğini, yalnız “yenilendi” bilgisine dayanarak söylemeyin. Kaynağı belirsiz bir sertifikayı, uyarıyı kaldırmak amacıyla güvenilir olarak eklemeyin.

Kamu SM Yazılım Platformu’nun MA3 API açıklamaları, güvenilir kök bulunamaması ile sertifikanın iptal durumunun kontrolünü ayrı ele alıyor. İptal kontrolünde SİL ve OCSP gibi mekanizmalar açıklanıyor. Kullandığınız uygulama durum bilgisine ulaşamıyorsa bu erişim hatasını “sertifika iptal edilmiş” sonucuyla birleştirmeyin; kontrol yöntemi ve hata ayrıntısı uygulama desteğince incelensin. API’ye özgü ayarları başka ürüne aynen taşımayın.

İmza doğrulama teşhis fişi

Bu, destek görüşmesinde doldurmanız için hazırlanmış bir çalışma formudur. İlk sütundaki her alanı aynı belge üzerinden karşılaştırın. İmzalayan ortamda ayrıca doğrulama yapılmadıysa ilgili hücreye “kontrol edilmedi” yazın. Birden fazla doğrulayıcı kullanıyorsanız her biri için ayrı kopya açın; bilinmeyen sürüm veya sonucu tahmin etmeyin.

Ortamlar farklı sonuç veriyorsa farkı daraltın

Aynı özgün dosya bir uygulamada doğrulanıp diğerinde uyarı veriyorsa belgeyi değiştirerek sonuçları eşitlemeye çalışmayın. Önce uygulama sürümlerini, kullanılan zincir bilgisini ve sertifika durum kontrolünün tamamlanıp tamamlanmadığını karşılaştırın. Bir ortamın olumlu sonucu diğer ortamdaki hatayı açıklamaz; yalnız farkın araştırılacağı yeri daraltır.

Sağlayıcı belirli bir güncelleme önerirse uygulanacak bileşeni ve resmî kaynağı kayda alın. Aynı anda görüntüleyiciyi, kart yazılımını ve güven ayarlarını değiştirmeyin. Değişiklikten sonra aynı kopyayla yeniden kontrol yapın. Bir uyarının kaybolmasıyla hangi kontrolün başarıya ulaştığını ayrı yazın; doğrulama kontrolünü kapatmayı çözüm kabul etmeyin.

İmza doğrulaması başarılı olsa bile gönderim veya belge sorgusunun sonucunu ayrıca izleyin. Özellikle e-faturada doğrulanan dosyayla sistemde takip edilen belgenin aynı kimliği taşıdığını kontrol edin. Sırf denemek için yeniden gerçek fatura oluşturmayın veya aynı belgeyi tekrar göndermeyin.

Örnek: Yeni seri tanınıyor, zincir kontrolü tamamlanmıyor

Kurgusal bir işletmede yeni mali mühürle üretilen dosya, imzalayan uygulamanın doğrulamasından geçiyor; başka bir araçta zincir hatası görülüyor. İki tarafta aynı dosya ve aynı sertifika seri numarası bulunduğu teyit ediliyor. İkinci araçtaki kök/ara sertifika bilgisi ve uygulama sürümü destek kaydına ekleniyor; henüz hangi bileşenin eksik olduğu bilinmiyor.

Destek ekibi belgelenmiş bir güncelleme yolu verdiğinde işlem yetkili kişiyle uygulanıp aynı dosya yeniden kontrol ediliyor. Sonuç kayda alınana kadar “çözüldü” yazılmıyor. Bu örnek her zincir hatasının güncellemeyle giderileceği garantisi değildir. Sertifika yenilendi diye eski imzalı belgelerin bozulduğu sonucuna da varılmaz; eski kayıtlar kendi imza ve doğrulama bilgileriyle ayrıca değerlendirilir.

Destek talebini belgeyi değiştirmeden tamamlayın

Destek kaydına teşhis fişini, tam hata metnini ve gerekli alanlarla sınırlandırılmış ekran görüntüsünü ekleyin. Özgün belge gerekiyorsa paylaşım kanalını ve yetkiyi önceden netleştirin; faturayı bilinmeyen çevrimiçi doğrulama sitelerine yüklemeyin. PIN, hesap parolası veya tek kullanımlık kod göndermeyin.

Seri numarası ve resmî sertifika durumu sorularını Kamu SM’ye; kullanılan doğrulayıcının zincir, sürüm ve erişim hatalarını ilgili yazılım desteğine yönlendirin. Yenileme veya sertifika tedariki ihtiyacınızı e-imza.plus ile görüşebilirsiniz. Yeni ürün satın almak, mevcut imzalı dosyanın doğrulama sorununu tek başına çözmüş sayılmaz.