Oturumlar ve Güvenlik

Belge oturumları ve erişim kontrolü

Bir Doconut tokenı açık bir belgeyi tanımlar. Onu taşıyan herhangi bir istek hizmet alırsa, tokenı elde eden herkes her sayfayı okuyabilir. Bu sayfa bir belge oturumunun ne tuttuğunu, ne kadar sürdüğünü ve DocImage.axd'ın sayfalarını kimlerin görebileceğine nasıl karar verdiğini — tek bir sunucuda ve bir web çiftliğinde — açıklar.

Bir belge oturumu ne tutar

Her başarılı OpenDocumentAsync bir oturum oluşturur ve bellek içinde tutulur:

  • yüklenmiş format görüntüleyicisi — ayrıştırılmış belgeyi tutan motor örneği,
  • sayfa başına durum — döndürme, çevirme ve kullanıcının widget içinde uyguladığı açıklama verileri,
  • isteğe bağlı arama dizini, ilk aramada oluşturulur (veya önceden oluşturulmuş bir .srh dosyasından yüklenir),
  • oturum filigranı DocOptions.Watermark'dan.

Ömür

Oturumlar kaydırmalı bir pencere üzerinden sona erer: DocOptions.TimeOut dakika (varsayılan 60), tokenı sunan her istekle sıfırlanır. Bir oturum sona erdiğinde — süresi dolduğunda veya CloseDocument(token) ile — belge motoru serbest bırakılır ve belleği hemen boşaltılır.

csharp
// Tek seferlik önizleme için kısa ömürlü bir oturum
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Süresi dolmuş bir token taşıyan bir istek, Document session not found. Please re-open document. okuyan bir hata resmi alır. Sayfa yeni bir token almak için belgeyi tekrar açmalıdır. Tek bir sunucuda, uygulama havuzunun yeniden başlatılması da tüm oturumları sonlandırır.

Sayfalar yalnızca onları açan oturuma hizmet edilir

UnsafeMode = false ile — varsayılan — bir belgeyi açmak, belgeyi açan isteğin ASP.NET oturumuna erişim verir; bunun için o oturuma bir secure-{token} girişi yazılır. DocImage.axd kendisi oturum durumunu gerektirir ve yalnızca istek yapan oturum bu girişi tuttuğunda bir sayfa sunar. Aynı tokenı sunan başka bir tarayıcı You Are Not Authorized To View This Page. okuyan bir hata resmi alır.

csharp
Doconut.DoconutHost.Initialize(options =>
{
    // false (varsayılan): DocImage.axd yalnızca açan ASP.NET oturumuna bir sayfa sunar
    // belge. İşleyici kendisi oturum durumunu ister; yalnızca sitenin bunu kapatmamasına ihtiyaç duyar
    // Web.config içinde oturum durumunu kapat.
    options.UnsafeMode = false;
});

Üç pratik sonuç:

  • Açma uç noktası oturum durumuna ihtiyaç duyar. MVC denetleyicileri ve Web Forms sayfaları bunu varsayılan olarak sağlar. Özel bir IHttpHandler, System.Web.SessionState.IRequiresSessionState'ı uygulamadıkça bunu sağlamaz. Oturum olmadan çalışan bir açma işlemi vermek için bir şey yoktur, bu yüzden görüntüleyici her sayfada "You Are Not Authorized To View This Page." mesajını gösterir.
  • Oturum durumu açık kalmalıdır. <sessionState mode="Off" />, Web.config içinde hem izni hem de kontrolü devre dışı bırakır ve her sayfa reddedilir.
  • Tarayıcı oturum çerezini göndermelidir. Widget'ın istekleri aynı kökenden olduğundan, ASP.NET_SessionId otomatik olarak taşırlar. Çerez kavanozu olmayan bir istemci — bir betik, sunucu‑sunucu çağrısı, çerezleri kaldıran çapraz‑köken yapı — reddedilir. Bu, özelliğin çalışmasıdır.

UnsafeMode = true kontrolü kapatır: token taşıyan herhangi bir istek hizmet alır. Bu, her belge için tek bir global anahtardır, belge bazlı bir geçersiz kılma yoktur. false bırakın.

İptal

CloseDocument(token) sadece belleği serbest bırakmanın ötesine geçer: mevcut isteğin oturumundan secure-{token} girişini kaldırır ve tokenı iptal eder, böylece kapatılan bir token anında reddedilir.

Web çiftlikleri: imzalı biletler

Bir çiftlikte, sonraki istek belgeyi hiç görmemiş bir sunucuya, farklı bir işçi sürecine ve kendi ASP.NET oturumuna sahip bir sunucuya yönlenebilir. Oturum izni onu takip edemez. Dağıtık mod, bunu tarayıcıya bağlı imzalı bir bilet ile değiştirir: her düğüm belge oturumları için tek bir depolama ve tek bir imzalama anahtarı paylaşır ve DocImage.axd, biletin o token, o tarayıcı ve — kullanıcı oturum açmışsa — o kullanıcı için geçerli olduğu zaman isteği kabul eder.

Kurulum, her düğümde aynı:

csharp
// Global.asax.cs - Application_Start
// Çiftlik sırrı: en az 32 bayt, her düğümde aynı, kaynak kontrolünden dışarıda tutulur.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));

Doconut.DoconutHost.Initialize(
    options => options.UnsafeMode = false,     // bilet kontrolü yalnızca bu false olduğunda çalışır
    services => services.AddDoconutDistributed(d =>
    {
        d.Store             = CloudLocation.FileShare;
        d.FileShareRootPath = @"\\fileserver\doconut-shared";  // her düğümün erişebileceği bir klasör
        d.SigningKey        = farmKey;                          // en az 32 bayt, HER düğümde AYNI
    }));

Açma uç noktası daha sonra bilet'i tarayıcıya bağlar, açmadan önce ve bilet ile tokenı birlikte döndürür:

  • DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions) ayarlayın — biletin bağlı olduğu doconut-client çerezini verir — ve DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • OpenDocumentAsync sonrası, tokenın yanında viewer.AccessToken döndürülür;
  • sayfada, ikisini de widget'a geçirin: objViewer.View(token, access).

Klasik web‑çiftlik bayrağından (IsWebfarm ile ExportToPng) geçiş mi? Geçiş adım adım değişikliği gösterir.

İmzalama anahtarını kaynak kontrolünden uzak tutun: hem biletleri imzalar hem de paylaşılan depodaki belgeleri şifreler. Farklı bir anahtara sahip bir düğüm, diğerlerinin verdiği tüm biletleri reddeder.

Bir çiftliği gerçek bir tarayıcıyla ya da çerezleri tutan bir betikle test edin. doconut-client çerezi olmayan bir istemci, 401 ile yanıt almaz: "not authorized" hata resmini 200 durum kodu ile alır, yaklaşık 2 KB, gerçek bir sayfanın onlarca hatta yüzlerce kilobayt olduğu yerde.

Üretim kontrol listesi

  • UnsafeMode = false tutun (varsayılan).
  • Oturum durumuna sahip isteklerden belgeleri açın ve oturum durumunu asla kapatmayın.
  • Oturum çerezinin DocImage.axd'a ulaştığından emin olun (aynı köken, HTTPS, bunu izin veren bir SameSite politikası).
  • Bir çiftlikte, her düğüm tarafından paylaşılan tek bir imzalama anahtarıyla dağıtık modu kullanın.
  • Kullanıcı belgeyi terk ettiğinde CloseDocument çağırın — bellek ve güvenlik her ikisi de fayda sağlar.
  • Tokenları asla kaydetmeyin veya paylaşmayın; kısa ömürlü kimlik bilgileri olarak ele alın.

Bu sayfa yardımcı oldu mu?