A
7/10/2026

ASP.NET'te Eklenti Gerektirmeyen Bir Belge Görüntüleyiciyi Nasıl Gömersiniz

Adım adım .NET mühendislerinin Doconut App’in güvenli, eklenti gerektirmeyen belge görüntüleyicisini ASP.NET Core, MVC veya WebForms projelerine nasıl gömeceklerini gösteren bir rehber.

Evet—güvenli, eklenti gerektirmeyen bir çevrimiçi dosya görüntüleyiciyi herhangi bir ASP.NET Core, MVC veya WebForms uygulamasına sadece birkaç dakika içinde gömebilirsiniz ve Doconut App tüm ağır işi yapar.
Sözleşme, çizim veya tasarım varlıkları sunan işletmeler, kurumsal güvenlik politikalarına saygı gösteren, her tarayıcıda çalışan ve kullanıcılara üçüncü taraf eklentileri yükletmeyen bir görüntüleyiciye ihtiyaç duyar. Doconut App tam da bunu sunar: PDF, Office, CAD ve 50+ diğer formatı destekleyen, tarayıcı tabanlı bir görüntüleyici; AES‑256 şifreleme, yalnızca SSL üzerinden yüklemeler ve tamamen özelleştirilebilir bir UI sağlar. Bu gönderi, dosya yüklemesini güvenli hale getirmekten görüntüleyiciyi renderlamaya kadar tüm iş akışını adım adım anlatır—böylece sıfırdan bir render motoru yazmadan cilalı, kurumsal düzeyde bir çözüm sunabilirsiniz.

1. .NET web uygulamaları için güvenlik ve eklenti gerektirmeyen renderlamanın önemi

Modern işletmeler her belgeyi potansiyel bir veri sızıntısı olarak görür. ActiveX, Flash veya yerel bir istemciye dayanan bir görüntüleyici gömdüğünüzde üç risk üstlenirsiniz:

Risk.NET uygulamanız üzerindeki etkisiDoconut App'in bunu nasıl ortadan kaldırdığı
Eklenti bağımlılığıKullanıcıların bir tarayıcı eklentisi kurması veya etkinleştirmesi gerekir, bu da destek taleplerine ve uyumluluk sorunlarına yol açar.Doconut tamamen HTML5/Canvas içinde çalışır, sıfır eklenti gerektirir.
Şifrelenmemiş aktarımDosyalar HTTP üzerinden iletilir veya düz metin olarak saklanır, bu da GDPR, HIPAA veya iç politikaları ihlal eder.Tüm yüklemeler SSL üzerinden gerçekleşir ve AES‑256 şifreleme ile saklanır.
Kontrolsüz yaşam döngüsüDosyalar sunucuda kalabilir, bu da ihlal yüzeyini artırır.Doconut, görüntülemeden sonra dosyaları otomatik olarak silerek, kısa bir saklama süresi sağlar.

Görüntüleyici, Doconut'un güvenli render hizmetiyle iletişim kuran bir JavaScript bileşeni olarak sunulduğu için .NET yığınını temiz tutarsınız—ek yerel kütüphaneler, üçüncü taraf ikili dosyalar ve ek uyumluluk denetimleri yok.

2. .NET projenizi hazırlama – ASP.NET Core, MVC ve WebForms için minimum kurulum

ASP.NET Core, MVC 5 veya WebForms kullanıyor olsanız da hazırlık adımları aynıdır:

  1. Doconut script paketini ekleyin
    Doconut, hafif bir görüntüleyici scriptini CDN'inde barındırır. Layout sayfanıza (ör. _Layout.cshtml veya Site.Master) aşağıdaki satırı ekleyin:

    <script src="https://doconut.app/viewer.min.js"></script>
    
  2. Yer tutucu bir öğe oluşturun
    Görüntüleyici, belirttiğiniz herhangi bir <div> içine bir canvas enjekte eder. Razor için örnek:

    <div id="docViewer" style="width:100%; height:800px;"></div>
    

    WebForms için, runat="server" özelliğine sahip bir <asp:Panel> yerleştirin ve ID="docViewer" verin.

  3. Doconut CSS'yi referans gösterin (isteğe bağlı)
    Varsayılan araç çubuğu ve temayı istiyorsanız, CSS dosyasını ekleyin:

    <link rel="stylesheet" href="https://doconut.app/viewer.min.css" />
    

Bunlar ihtiyacınız olan tüm statik varlıklardır. Geri kalan iş, sunucu‑tarafı kodunuzda (yükleme, şifreleme, token oluşturma) ve küçük bir istemci‑tarafı başlatma scriptinde gerçekleşir.

3. Güvenli bir yükleme uç noktası oluşturma – AES‑256, SSL ve otomatik silme

Görüntüleyici, dosyalarınıza doğrudan dosya sisteminiz üzerinden erişmez. Bunun yerine, belgeyi Doconut'un talep üzerine okuduğu geçici, şifreli bir depolama konumuna yüklersiniz. Aşağıda ASP.NET Core için gerekli adımların yüksek seviyeli bir açıklaması verilmiştir; aynı fikirler MVC ve WebForms için de geçerlidir.

Sunucu‑tarafı iş akışı

  1. Yüklenen dosyayı kabul edin – İstemciden belgeyi almak için standart IFormFile (veya WebForms'ta HttpPostedFile) kullanın.
  2. Dosyayı AES‑256 ile şifreleyin – Akışı kalıcı hale getirmeden önce System.Security.Cryptography.Aes gibi kanıtlanmış bir kütüphane kullanarak şifreleyin. Şifreli bloğu güvenli bir konumda saklayın (ör. sunucu‑tarafı şifreleme etkin Azure Blob Storage veya SSE‑AES256 ile bir S3 bucket).
  3. Kısa ömürlü imzalı bir URL oluşturun – Birkaç dakika (ör. 5 dakika) geçerli olacak bir URL oluşturun. URL HTTPS olmalı ve Doconut'un doğrulayabileceği kriptografik bir token içermelidir. Çoğu bulut depolama sağlayıcısı bu ihtiyaca uygun bir “ön‑imzalı URL” özelliği sunar.
  4. İmzalı URL'yi istemciye geri gönderin – URL'yi içeren bir JSON yanıtı gönderin. İstemci bu URL'yi Doconut görüntüleyicisine aktaracaktır.
  5. Otomatik silmeyi zamanlayın – İmzalı URL süresi dolduktan sonra, bir arka plan işi (Hangfire, Azure Functions vb.) şifreli bloğu siler ve dosyanın sunucuda kalmamasını garanti eder.

Tek fark yönlendirme sözdizimidir; güvenlik iş akışı aynı kalır.

4. Doconut görüntüleyiciyi render etme – URL'den tarayıcı içi canvas'a

İstemci imzalı URL'yi aldığında, görüntüleyici tek bir JavaScript çağrısıyla başlatılabilir. Doconut'un SDK'sı akışı, renderlamayı ve UI etkileşimlerini otomatik olarak yönetir.

<script>
    // Assume `response.viewerUrl` contains the signed URL returned from the upload endpoint
    function launchViewer(viewerUrl) {
        // Initialise the Doconut viewer. The global object provided by the script is `DoconutViewer`.
        DoconutViewer.init({
            containerId: "docViewer",   // The <div> we placed earlier
            fileUrl: viewerUrl,          // Signed, HTTPS URL to the encrypted file
            toolbar: true,               // Show the built‑in toolbar
            theme: "light"              // Optional visual theme
        });
    }

    // Example: after a successful upload
    fetch("/api/document/upload", {
        method: "POST",
        body: myFormData,
        credentials: "include"
    })
    .then(r => r.json())
    .then(data => launchViewer(data.viewerUrl));
</script>

Neden bu her .NET çeşidi için çalışır

  • ASP.NET Core Razor – Script, yükleme formunu barındıran aynı view içinde bulunur, bu yüzden akış sorunsuzdur.
  • MVC – Aynı snippet'i enjekte etmek için @section Scripts kullanın; denetleyici, MVC'nin $.ajax'ının tüketebileceği JSON döndürür.
  • WebForms – Yükleme tamamlandıktan sonra script'i ClientScript.RegisterStartupScript ile kaydedin, ardından launchViewer'ı aynı şekilde çağırın.

Doconut, belgeyi doğrudan imzalı URL'den akıttığı için sunucu, yükleme adımından sonra dosyaya bir daha dokunmaz. Görüntüleyici PDF, Word dosyaları, CAD çizimleri ve ürün özelliklerinde listelenen tüm diğer formatları ek bir sunucu‑tarafı dönüşüm olmadan renderlar.

5. Görüntüleyiciyi markanıza göre özelleştirme – çevrimiçi dosya görüntüleyiciyi ince ayar yapma

İşletmeler genellikle görüntüleyicinin portalının yerel bir parçası gibi görünmesini ister.

Özelleştirme.NET'te nasıl uygulanır
Araç çubuğu düzenitoolbar: false geçirerek kendi butonlarınızı oluşturun ve görüntüleyicinin JavaScript API'sini (ör. zoomIn(), print()) çağırın.
Renk şemasıtheme: "dark" ayarlayın veya varsayılan sınıfları geçersiz kılan özel bir CSS dosyası sağlayın.
Dil ve erişilebilirlikDoconut, konteyner üzerindeki lang özniteliğine saygı gösterir; ayrıca accessibility seçeneğiyle ARIA etiketleri ekleyebilirsiniz.
Olay kancalarıonPageChange, onError ve onDownload gibi geri çağırmalar, mevcut telemetri hattınızda kullanım metriklerini kaydetmenizi sağlar.

Bu kancaların tümü, önceki bölümde gösterilen aynı JavaScript nesnesinde yapılandırılır. Görüntüleyici tamamen istemci tarafında çalıştığı için ek bir sunucu yükü yoktur—.NET arka ucunuz kimlik doğrulama, şifreleme ve iş mantığına odaklanmaya devam eder.

6. Performans ve ölçeklenebilirlik – deneyimi hızlı tutun

Yüksek trafikli bir portalda görüntüleyici gömmek iki pratik endişeyi gündeme getirir: yükleme süresi ve eşzamanlı renderlama.

EndişeDoconut'un yerleşik avantajıEk .NET ipucu
İlk indirmeGörüntüleyici scripti sadece ~150 KB, gziplenmiş.Statik dosya sıkıştırmasını (app.UseResponseCompression()) ve önbelleği (Cache‑Control: public, max‑age=31536000) etkinleştirin.
Dosya akışıDoconut, yalnızca gereken sayfaları HTTP aralık istekleriyle akıtır.Şifreli blokları bölgesel bir CDN'de (Azure Front Door, Amazon CloudFront) depolayarak gecikmeyi azaltın.
Eşzamanlı kullanıcılarRenderlama istemci tarafında gerçekleşir; sunucu sadece her görüntüleme için şifreli dosyayı bir kez sunar.Ani artışları önlemek için yükleme uç noktasını IApplicationRateLimiter ile sınırlayın.
Bellek ayak iziSunucu‑tarafı PDF dönüşüm kütüphaneleri yoktur, bu yüzden ASP.NET süreci hafif kalır.Yoğun bir arka plan iş kuyruğunuz varsa, yükleme hizmetini ayrı bir mikroservis olarak çalıştırın.

Bu yönergeleri izleyerek, mevcut .NET web katmanınızı aşmadan binlerce eşzamanlı görüntüleyiciyi destekleyebilirsiniz.

Temel Çıkarımlar

  • Doconut App, ASP.NET Core, MVC ve WebForms ile çalışan eklentisiz, %100 güvenli bir görüntüleyici sunar.
  • Yüklemeler yalnızca SSL üzerinden yapılır, AES‑256 şifreleme ile saklanır ve imzalı URL süresi dolduktan sonra otomatik olarak silinir.
  • Entegrasyon sadece bir CDN scripti, bir konteyner <div> ve imzalı URL döndüren küçük bir sunucu‑tarafı uç nokta gerektirir.
  • Görüntüleyici PDF, Office, CAD ve 50+ görüntü formatını destekler—sunucu‑tarafı dönüşüm gerekmez.
  • UI, kurumsal marka ile eşleşecek şekilde tamamen özelleştirilebilir ve görüntüleyici CAD dosyaları için yerleşik yakınlaştırma, ölçüm ve katman araçları sunar.
  • Performans istemci tarafında yönetilir; .NET geliştiricileri sadece statik dosya sıkıştırması ve isteğe bağlı CDN önbelleklemesini sağlamalıdır.
  • Güvenli yüklemeden tarayıcı içi renderlamaya kadar tüm iş akışı, mevcut .NET kimlik doğrulama ve yetkilendirme hatlarına sorunsuz bir şekilde uyar.

Yaygın Sorular

S1: Doconut kullanmak için herhangi bir NuGet paketi yüklemem gerekiyor mu?
C: Hayır. Görüntüleyici, Doconut'un CDN'inden istemci‑tarafı bir JavaScript paketi olarak sunulur. Sunucunuz sadece dosya yüklemeleri ve şifreleme için genellikle zaten sahip olduğunuz ASP.NET Core ara katmanına ihtiyaç duyar.

S2: Doconut, dosyanın görüntülenmeden sonra silindiğinden nasıl emin olur?
C: Doconut, yapılandırılabilir bir süre (genellikle beş dakika) geçerli olan kısa ömürlü bir imzalı URL oluşturur. URL süresi dolduktan sonra, siz (veya bir arka plan temizlik işi) şifreli bloğu silersiniz. Bu, belgenin gerektiğinden daha uzun süre saklanmadığını garanti eder ve katı veri‑saklama politikalarını karşılar.

S3: Görüntüleyiciyi belgeyi yazdırmak veya dışa aktarmak için kullanabilir miyim?
C: Evet. Doconut'un yerleşik araç çubuğu, kaynak dosyanın orijinal kalitesini ve düzenini koruyan yazdırma ve dışa aktarma seçeneklerini içerir.

Güvenli, eklenti gerektirmeyen bir belge görüntüleyiciyi .NET uygulamanıza gömmeye hazır mısınız? Bugün Doconut App ile başlayın ve PDF, Office, CAD ve onlarca diğer formatı güvenli ve anında sunun.