Kılavuz: Doconut Görüntüleyicisini React ile Güvenli Bir Şekilde Gömme – Baştan Sona
Bir belge görüntüleyiciyi güvenli bir şekilde gömmek, bir middleware kod parçacığını ASP.NET Core uygulamasına kopyalamaktan daha fazlasını gerektirir. Entegrasyon, kimlik doğrulama, belge erişimi, oturum yönetimi, renderleme, açıklamalar, arama, yazdırma ve denetim kaydı için net sınırlar tanımlamalıdır.
Kurumsallar, DMS, CRM, yasal inceleme veya mühendislik çizim uygulamaları gibi belge‑merkezli portallar oluştururken, özgün dosyaları uygulama sınırının arkasında tutmalıdır. Doconut, PDF, Office, CAD ve görüntü belgeleri için sunucu‑tarafı bir görüntüleme modeli sunar, React ön yüzü ise kullanıcı arayüzünü sağlayabilir.
Bu kılavuz, güvenilir bir mimariye odaklanır ve SDK sürümleri arasında değişebilecek paket adları, seçenek özellikleri, metod imzaları ve uç nokta yollarından kaçınır. Tam kayıt ve API ayrıntıları için lisanslı sürümünüzle eşleşen resmi belgeleri kullanın.
1️⃣ Adım 1 – ASP.NET Core ve React Projelerini Hazırlayın
Kod yazmaya başlamadan önce, geliştirme ortamınızın temel gereksinimleri karşıladığından emin olun:
| Gereksinim | Önerilen sürüm |
|---|---|
| .NET çalışma zamanı | .NET 6 veya üzeri |
| ASP.NET Core | 6.0+ |
| IDE | Desteklenen bir .NET geliştirme ortamı |
| Ön‑uç (isteğe bağlı) | Projenizle uyumlu bir React uygulaması |
- Yeni bir ASP.NET Core Web API projesi oluşturun
dotnet new webapi -n DocPortal
cd DocPortal
-
Lisanslı Doconut bağımlılıklarını ekleyin – Tam paket adlarını, sürümleri, yerel bağımlılıkları ve lisans‑yükleme talimatlarını resmi belgelerden alın. İlgisiz bir öğreticide gösterilen bir paket veya sarmalayıcının sürümünüzde geçerli olduğunu varsaymayın.
-
React uygulamasını hazırlayın – Görüntüleyici React üzerinden sunulacaksa, ekip tarafından onaylanmış ön‑uç kurulumunu kullanın. React uygulamasını, belgelenmemiş üçüncü‑taraf sarmalayıcılara değil, kendi kimlik doğrulamalı API’nize bağlayın.
-
İlk durumu commit edin – Çoğu kurumsal ekip, lisans veya güvenlik ayarlarını etkileyen her değişiklik için imzalı bir commit gerektiren bir Git politikası uygular.
Şimdi, belgelenmiş Doconut sunucu entegrasyonu için temiz bir çözüme sahipsiniz.
2️⃣ Adım 2 – Sunucu Entegrasyonunu Güvenli Bir Şekilde Yapılandırın
Görüntüleyiciyi, projenizdeki tam Doconut sürümü için sağlanan talimatları izleyerek kaydedin. Middleware sırası, servis kayıtları, lisans başlatma ve yapılandırma özelliği adları sürüme özgü detaylardır ve doğrulanmamış örneklerden kopyalanmamalıdır.
SDK sürümünden bağımsız olarak, ASP.NET Core uygulaması aşağıdaki kontrolleri uygulamalıdır:
- Belge açmadan önce kimlik doğrulama – Bir görüntüleyici oturumu, uygulamanın kimlik katmanını asla atlamamalıdır.
- Belge tanımlayıcılarını sunucuda çözümleme – Tarayıcı tarafından sağlanan rastgele fiziksel dosya yolunu değil, uygulama‑seviyesinde bir belge kimliğini kabul edin.
- Her işlemi yetkilendirme – Görüntüleme, açıklama, arama, indirme ve yazdırma farklı izinler gerektirebilir.
- Gizli bilgileri kaynak kontrol dışına tutma – Lisanslar, bağlantı dizesi ve şifreleme materyallerini onaylanmış gizli‑yönetim mekanizmasında saklayın.
- İstek limitleri uygulama – Yükleme, belge‑boyutu, zaman aşımı ve hız limitlerini görüntüleyici iş akışı etrafında ayarlayın.
- Güvenlik olaylarını kaydetme – Erişim kararlarını ve belge eylemlerini, belge içeriğini veya hassas tokenları loglara yazmadan kaydedin.
Tüm SDK ayarlarını sürüm‑bağlı yapılandırma olarak ele alın. Üretime geçmeden önce resmi referansta anlamlarını doğrulayın.
3️⃣ Adım 3 – Belge Oturumlarını Bir Uygulama Servisinin Arkasında İzole Edin
Doconut‑özel etkileşimleri, ayrılmış bir uygulama servisi içinde tutun. Viewer sınıfına referanslar mimari düzeyde faydalı olsa da, yapıcı imzaları, belge‑açma metodları, önbellek gereksinimleri ve lisans keşif davranışı, kurulu sürümünüzün belgelerinden gelmelidir.
Güvenli bir servis sınırı şunları yapmalıdır:
- Kimliği doğrulanmış bir kullanıcı ve uygulama seviyesinde bir belge tanımlayıcısı alın.
- Kullanıcının istenen eylem için iznini kontrol edin.
- Belgeyi onaylanmış sunucu tarafı depolamadan alın.
- Belgelendirilmiş görüntüleyici API'sinden bir belge oturumu oluşturmasını isteyin.
- İstemciye yalnızca gerekli minimum opak oturum bilgilerini döndürün.
- Oturumları, saklama ve önbellek politikalarınıza göre serbest bırakın veya süresini sonlandırın.
Tarayıcı, fiziksel depolama yolu, lisans verisi, iç önbellek anahtarı veya orijinal belgeye sınırsız referans asla almamalıdır.
4️⃣ Adım 4 – Açıklamaları, Aramayı ve Kontrollü Yazdırmayı Etkinleştirin
Açıklamalar, arama, OCR ve kontrollü yazdırma, yalnızca lisanslı Doconut yapılandırmanızda bulunuyorsa ve kurulu sürüm tarafından destekleniyorsa etkinleştirilmelidir. Metod adları, kalıcılık formatları veya seçenek sınıfları varsayımından kaçının.
- Açıklamalar – Hangi rollerin işaretleme oluşturabileceğini, düzenleyebileceğini, görüntüleyebileceğini veya silebileceğini belirleyin. Açıklama durumunu, SDK sürümünüzün kalıcılık yönergelerine ve kendi denetim gereksinimlerinize göre saklayın.
- Arama ve OCR – Hangi belge türlerinin OCR gerektirdiğini, çıkarılan metnin nerede tutulacağını ve indekslerin ne kadar süreyle mevcut olacağını belirleyin. Arama sonuçlarını belge verisi olarak ele alın ve buna göre yetkilendirin.
- Kontrollü yazdırma – Sayfa limitleri, filigran politikası, onay kuralları ve denetim olaylarını uygulama seviyesinde tanımlayın, ardından bu gereksinimleri belgelenmiş yazdırma yeteneklerine eşleyin.
Bu işlemleri, belge oturumları için kullanılan aynı uygulama servisi arkasında tutun; böylece denetleyiciler ince kalır ve iş kuralları test edilebilir olur.
5️⃣ Adım 5 – React Ön Ucunu Bağlayın
React uygulaması, depolama yollarını kabul etmek veya iç belge servislerine doğrudan bağlanmak yerine kimliği doğrulanmış ASP.NET Core API’nizi çağırmalıdır. İş eylemleri etrafında kendi kaynak‑odaklı API sözleşmenizi tanımlayın ve SDK‑özel uç nokta adlarını kamu istemci sözleşmesinin bir parçası olarak yayınlamaktan kaçının.
Tipik bir etkileşim sırası şudur:
- Kullanıcı, uygulamada zaten görünen bir belgeyi seçer.
- React, belgenin uygulama kimliğini kullanarak bir görüntüleme oturumu talep eder.
- ASP.NET Core, isteği kimlik doğrular, belgeyi yetkilendirir ve görüntüleyici oturumunu koordine eder.
- React, görüntüleyiciyi göstermek için gereken yalnızca bilgileri alır.
- Açıklama, arama ve yazdırma istekleri kimliği doğrulanmış uygulama API'si üzerinden geri döner.
- Sunucu, denetim olaylarını kaydeder ve uygun olduğunda oturumu sonlandırır.
React UI’da oturum durumunu kısa tutun, yetkilendirme hatalarını açıkça yönetin, hassas değerleri kalıcı tarayıcı depolamasına koymaktan kaçının ve iç yolları ya da istisna detaylarını ortaya çıkarmayan yükleme ve hata durumları sağlayın.
Bu ayrım, renderleme ve belge kontrollerini sunucuda tutarken React’ın yalnızca sunum ve etkileşimden sorumlu olmasını sağlar.
Sonuç
Doconut entegrasyonunu güvenli bir ASP.NET Core uygulama servisi arkasına yerleştirerek, React arayüzünü belgelenmemiş SDK detaylarıyla bağlamadan PDF, Office, CAD ve görüntü iş akışları için bir belge portalı oluşturabilirsiniz. Kimlik doğrulama, yetkilendirme, oturum yaşam döngüsü, arama, açıklama, yazdırma ve denetim politikaları, uygulama tasarımınızın açık parçaları olarak kalır.
Doconut’u .NET projenizde değerlendirmeye hazır mısınız? Seçtiğiniz sürüm için resmi paket, lisans ve API belgelerini kullanın, ardından yukarıdaki mimari ve güvenlik kontrol listesini uygulamanıza uygulayın.