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
.srhdosyası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.
// 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.
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.configiç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_SessionIdotomatik 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ı:
// 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ğudoconut-clientçerezini verir — veDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);OpenDocumentAsyncsonrası, tokenın yanındaviewer.AccessTokendö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 = falsetutun (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 birSameSitepolitikası). - 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?