Legal departmanlar sözleşmeler, delil dosyaları ve diğer son derece gizli belgelerle ilgilenir. Bir PDF'yi bulut‑tabanlı bir paylaşım hizmetine yükleme akışı, dosyanın kurumsal sınırlarınızın dışına çıkması ve kimlerin ne kadar süreyle görüntüleyebileceği üzerinde ayrıntılı kontrolü kaybetmeniz nedeniyle anında bir güvenlik riski oluşturur.

Bir PDF görüntüleyiciyi doğrudan .NET web portalınıza gömüp, belgenin hiçbir zaman üçüncü‑taraf bir sunucuya dokunmadığını garanti edebilseniz ne olurdu?

Bu kılavuzda, Doconut Viewer adlı .NET belge görüntüleyici SDK'sı etrafında inşa edilmiş pratik bir mimariyi adım adım inceliyoruz. SDK, kendi uygulamanıza kurulur ve Doconut sunucularına hiçbir çağrı yapmaz; böylece belge altyapınızdan ayrılmaz.

İlk adıma geçmeden önce netleştirmeniz gereken iki nokta var, çünkü rehberin geri kalanı bunlara dayanıyor. Doconut.app ücretsiz bir web görüntüleyicidir — bir web sitesi, bir bileşen değildir ve burada kurduğunuz şey değildir. Şifreleme, token'lar ve denetim günlüğü ise sizin tarafınızdan oluşturulacak şeylerdir: SDK belgeleri render eder, bir uyumluluk programı sunmaz. Doconut, ISO 27001 sertifikası, SOC 2 raporu veya HIPAA onayı tutmaz; bu yüzden düzenleyiciye sunabileceğiniz uyumluluk argümanı mimari temellidir — dosya zaten kontrol ettiğiniz bir sınır içinde kalır.

Neden Geleneksel Bulut Paylaşımları Yetersiz Kalıyor

Risk	Tipik Bulut Servisi	Bu mimarinin yaptığı şey
Veri sürgünlüğü - dosya dış sunucularda depolanır	Dosyalar sağlayıcının depolama alanında tutulur, genellikle kontrol edemediğiniz bölgelerde.	PDF, kendi altyapınızda kalır. SDK onu orada render eder ve kimseyi aramaz.
Erişim ömürleri üzerindeki kontrol kaybı	Paylaşım linkleri süresiz olarak iletilebilir.	Kısa ömürlü, tek kullanımlık token'lar oluşturursunuz. Bu, sizin yazdığınız kod, bir anahtar değil.
Uyumluluk boşlukları	Denetim günlükleri genellikle sadece “indirme” olaylarını içerir.	Her önizleme isteğini kaydedersiniz, çünkü istek kendi uç noktanıza gider.
Eklenti bağımlılığı	Birçok görüntüleyici Flash, ActiveX veya tarayıcı eklentileri gerektirir.	Okuyucunun makinesine hiçbir şey kurulmaz; tarayıcı render edilmiş sayfaları alır.

Çözüm Genel Bakışı

Doconut Viewer'ı .NET projenize kurun.
PDF'leri dinlenirken sunucu‑tarafı bir anahtar ile şifreleyin, .NET'in kendi kriptografisini kullanarak.
Viewer'ı bir Razor sayfasına veya MVC görünümüne gömün, uygulamanızın oluşturduğu bir token'ın arkasına yerleştirerek.
Denetim izleri ve anomali tespiti için her önizleme isteğini kaydedin.

Adımlar 2, 3 ve 4, uygulamanızın sorumluluğundadır. SDK’nın görevi adım 1 ve render işlemleridir; bu tasarımdaki tüm koruyucu unsurlar sizin kodunuzdur, bu da kendi ekibiniz tarafından denetlenebilmesini sağlar.

Aşağıda her adımı ayrıntılı olarak ele alıyoruz; anahtar yönetimi, token güvenliği ve uyumluluk günlükleme konularında en iyi uygulama önerileri de yer alıyor.

Adım 1 – .NET Ortamınızı Hazırlayın

Çözümünüzü Visual Studio'da açın (2022 veya daha yeni sürüm önerilir).
Hedef çerçevenizi seçin. Doconut Viewer, ASP.NET, MVC, .NET Core, .NET 6+ ve Blazor’u destekler. Karar verdiğiniz sürümü not alın — entegrasyon detayları sürüme özgüdür.
SDK'yı Doconut indirme sayfasından kurun, seçtiğiniz sürümle eşleşen paket ve belgeleri kullanarak. Paketin adını ve kurulum adımlarını bir makaleden değil, o sürüme ait belgelerden alın; her iki kaynak da sürümler arasında değişiklik göstermiştir.

Lisans yapılandırmasını kaynak kontrolünden uzak tutun. Çalışan bir prototipten en sık sızdırılan şey budur.

Ekstra İpuçları

Directory.Packages.props dosyasında paket referansını saklayın; bu, birden çok hizmette merkezi sürüm yönetimi sağlar.

Adım 2 – PDF'leri Güçlü Şifreleme ile Depolama

2.1 Bir Şifreleme Algoritması Seçin

Bu sizin kararınız ve kodunuz. .NET'teki System.Security.Cryptography size AES-256-GCM sağlar; bu, kimlik doğrulamalı şifreleme sunar — gizlilik ve bütünlük bir arada — ve dinlenme halindeki belgeler için savunulabilir bir varsayılandır.

Hiçbir şifreleme algoritması bir sistemi GDPR, HIPAA veya ISO 27001 ile uyumlu hâle getirmez. Bu çerçeveler süreçler, erişim kontrolü, saklama ve kanıt hakkında sorular sorar. Şifreleme, birçok kontrolden sadece biridir ve bir görüntüleyici kütüphanesi geri kalanını sağlayamaz.

2.2 Güvenli Anahtar Yönetimini Uygulayın

Anahtarları asla kod içinde sabitlemeyin. Azure Key Vault, AWS KMS veya HashiCorp Vault kullanarak şifreleme anahtarını çalışma zamanında alın.
Anahtarları düzenli olarak döndürün — her 90 günde bir yaygın bir uygulamadır. Yeniden şifreleme işini ihtiyacınız olmadan önce planlayın; bir anahtarı döndürmenin bir yolunun olmadığını keşfetmek bir olay sırasında öğrenilecek kötü bir şeydir.

Adım 3 – Zaman‑Sınırlı, Tek‑Kullanımlık Token Oluşturma

Ön izleme tokenı, otomatik olarak süresi dolan tek‑kullanımlık bir rozet gibi davranır. İçerdiği bilgiler:

Kullanıcı Kimliği – Belgeyi görüntülemeye yetkili olan kişi.
PDF Kimliği – Akışa gönderilecek şifreli dosya.
Süre – Genellikle 5–10 dakika, politika bazında yapılandırılabilir.
İmza – HMAC veya RSA ile imzalanarak manipülasyon önlenir.

3.1 Güvenlik Hususları

TLS her yerde – Tokenı her zaman HTTPS üzerinden sunun.
En az ayrıcalık – Ön izleme için yalnızca gerekli veriyi kodlayın; ekstra talepleri gömmekten kaçının.
Token iptali – Redis'te basit bir “kara liste”, bir kullanıcının erişim hakları değiştiğinde anında iptal sağlar.

Adım 4 – DoconutApp Görüntüleyicisini Gömme

4.1 Sunucu‑Tarafı Akış Uç Noktası

Bellekte çözümle eğer tehdit modeliniz bunu gerektiriyorsa, böylece düz metin diske hiç yazılmaz. Bu sizin uç noktanızdır, bu yüzden karar sizin ve kodunuz da sizin incelemenize açıktır.
Render işlemi sunucunuzda gerçekleşir, okuyucunun tarayıcısında değil. Bu, tarayıcının belgeyi kaynak dosyayı hiç almadan görüntülemesini sağlar — aynı zamanda SDK'nın geçici render çıktısını nereye yazdığını ve ne zaman sildiğini kontrol etmeniz gerektiği anlamına gelir.

4.2 Eklenti Gerekmiyor

Okuyucu, standart web teknolojileri üzerinden işlenmiş sayfaları alır; bu sayede görüntüleyici Chrome, Edge, Firefox ve Safari'de eklenti, ActiveX kontrolü veya Flash bağımlılığı olmadan çalışır. Bir avukatın dizüstü bilgisayarına hiçbir şey kurulmaz; bu genellikle bir güvenlik incelemesinin tamamlanıp tamamlanmadığını belirleyen farktır.

Adım 5 – Uyum İçin Erişimi Denetleme ve Günlüğe Kaydetme

Hukuk ekipleri genellikle manipülasyona dayanıklı bir iz gerekir; kim hangi sözleşmeyi ne zaman görüntülediğini gösterir. Yapılandırılmış bir günlükleme hattı uygulayın:

Alan	Açıklama
`UserId`	Talep eden hukuk profesyonelinin tanımlayıcısı
`PdfId`	Şifreli belgeye iç referans
`Timestamp`	Ön izleme isteğinin UTC zamanı
`IpAddress`	Kaynak IP (coğrafi konum kontrolleri için yararlı)
`UserAgent`	Adli analiz için tarayıcı dizesi
`Result`	Başarı / Başarısız (örn., token geçersiz, şifreleme hatası)

En İyi Uygulamalar

Günlükleri ek‑sadece, değiştirilemez bir veri deposunda saklayın (ör. Azure Log Analytics, Splunk veya bir kez‑yazılabilir S3 kovası).
Uyarılamayı etkinleştirin anormal kalıplar için — örneğin aynı tokenın birkaç saniye içinde iki farklı IP'den kullanılması.
Saklama politikası: Yargı bölgenizin gerektirdiği süre boyunca günlükleri tutun (genellikle yasal kayıtlar için 7 yıl).

Hızlı Özet

Doconut Viewer'ı .NET projenize kurun, sürüm belgelerini kullanın.
PDF'leri yazma sırasında .NET'in kendi kriptografi kütüphanesinden AES-256-GCM ile şifreleyin; anahtarları bir kasa hizmetiyle yönetin.
Kısa ömürlü, tek‑kullanımlık ön izleme tokenı oluşturun; bir kullanıcı görüntüleme talep ettiğinde verin.
Sunucunuzda render edin ve görüntüleyiciyi bir Razor sayfasına gömün. Belge hiçbir üçüncü tarafa gitmez ve okuyucunun makinesine hiçbir şey kurulmaz.
Her ön izlemeyi denetim amaçlı günlüğe kaydedin, şüpheli kalıplar için uyarı ekleyin.

2, 3 ve 5. maddeler sizin kodunuzdur. Bu, iş bölümü konusunda dürüst bir ifadedir ve güvenlik belgelerinizde açıkça belirtilmelidir; çünkü bir inceleyici sonunda hangi tarafın ne için sorumlu olduğunu soracaktır.

Sonuç

Güvenli PDF paylaşımı üçüncü taraf hizmeti içermek zorunda değildir. Kendi .NET portalınızda Doconut Viewer ile, hukuk departmanınız gizli sözleşmeleri, dava sergilerini ve iç politikaları dosya altyapınızdan hiç çıkmadan sunabilir.

SDK'nın size sağladığı şey son kısımdır: ortamınızda, dışarıya çağrı yapmadan renderleme. Uçtan uca şifreleme, erişim kontrolü ve denetim izi size aittir — işte bu noktadır, çünkü bunları sağladığını iddia eden bir görüntüleyici, sizin kendi uyumluluğunuza güvenmek yerine bir satıcının uyumluluğuna güvenmenizi ister.

Denemeye hazır mısınız? doconut.com adresini ziyaret edin — deneme lisansı ücretsizdir ve canlı demolar en kötü serginizde renderlemenin nasıl durduğunu kod yazmadan önce görmenin en hızlı yoludur.

Bu adımları uygulamak, uyumluluk görevlilerine iç huzur verir, saldırı yüzeyini azaltır ve PDF'lerinizi kurumsal güvenlik duvarınızın içinde tutar — tam da herhangi bir hukuk ekibinin ihtiyaç duyduğu güvenlik duruşu.

Güvende kalın, uyumlu kalın ve o mühürlü zarfları olması gereken yerde tutun: kendi kasanızın içinde.