Oturumlar ve Güvenlik
Belge oturumları ve erişim kontrolü
A Doconut token'ı güçlüdür: onu sunan herkes, açılış oturumuna bağlanmamış olsaydı belgenin her sayfasını isteyebilir. Bu sayfa bir oturumun ne tuttuğunu, ne kadar süre yaşadığını ve UseDoconut() varsayılan olarak hangi kontrolleri etkinleştirdiğini açıklar.
Bir belge oturumu ne tutar
Her başarılı OpenDocumentAsync, IMemoryCache içinde bir oturum oluşturur:
- yüklenmiş format görüntüleyicisi (ayrıştırılmış belgeyi tutan belge motoru örneği),
- sayfa başına durum — döndürme, çevirme ve kullanıcının widget içinde uyguladığı ek açıklama verileri,
- isteğe bağlı arama indeksi, ilk aramada tembelce oluşturulur (veya sayfalar paylaşımlı depolamadan sunulduğunda önceden oluşturulmuş
.srhdosyasından yüklenir), - oturum filigranı
DocOptions.Watermark'dan.
Ömür
Oturumlar bir kaydırmalı pencere üzerinden süresi dolar: DocOptions.TimeOut dakika (varsayılan 60), token sunan her istekle sıfırlanır. Bir oturum — süresi dolduğunda ya da CloseDocument(token) tarafından — atıldığında, atma geri çağrısı belge motorunu kapatır ve ilişkili belleği hemen serbest bırakı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 ile yapılan istek, Document session not found. Please re-open document. okuyan bir hata resmi alır — istemcinin yeni bir token elde etmek için yeniden açması gerekir.
Yerleşik token bağlama
UnsafeMode = false (varsayılan) ile, OpenDocumentAsync yeni token'ı, onu açan HTTP isteğinin ASP.NET oturumuna bağlar, bu oturuma bir secure-{token} işareti yazarak. Doconut ara katmanı daha sonra başka bir tarayıcı oturumuna sayfa sunmayı reddeder:
- Çalınmış bir token sunan farklı tarayıcı/oturum → hata resmi
You Are Not Authorized To View This Page. - Oturum ara katmanı kaydedilmemiş → HTTP 500
Session middleware not configured. Call UseSession() before UseDoconut().
Bu, Quick Start'ın Doconut dalından önce AddSession() + app.UseSession() zorunlu kılmasının nedenidir. İki pratik sonuç:
- İstemcinin sayfa istekleriyle ASP.NET oturum çerezini göndermesi gerekir. Çerezleri temizleyen çapraz kaynak yapılandırmaları (veya çerez kutusu olmayan bir API istemcisi) kontrolü başarısız kılar — bu bir özellik, hata değildir.
options.UnsafeMode = truebağlamayı tamamen devre dışı bırakır. Kontrollü senaryolar için vardır (ör. sunucu‑sunucu render); üretimdefalsebırakın.
Token bağlama yalnızca bu global UnsafeMode anahtarıyla kontrol edilir — varsayılan olarak açıktır (UnsafeMode = false) ve her oturuma uygulanır. Belge başına bir vazgeçme seçeneği yoktur; UnsafeMode = true ayarı bağlamayı küresel olarak devre dışı bırakır.
Erişim izinleri ve kimliği doğrulanmış kullanıcılar
UnsafeMode false olduğunda, UseDoconut() DocumentAccessMiddleware'ı sayfa ara katmanından önce otomatik olarak ekler. İkinci kez kaydetmeyin. Bir istek token taşıdığında, belgenin açıldığı sırada kaydedilen erişim iznini bulur ve yalnızca aşağıdakiler sağlandığında yetkilendirir:
- token için bir izin vardır,
- izin süresi dolmamıştır (izin ömrü = belgenin
TimeOut), - istek yapan ASP.NET oturum kimliği, belgeyi açan oturum kimliğiyle eşleşir,
- eğer açan kimliği doğrulanmışsa, istek yapan kullanıcının
NameIdentifiertalebi de eşleşir.
Hatalar 403 döndürür — sayfa/küçük resim istekleri için PNG hata resmi, aksi takdirde düz metin olarak. Mesaj ve token sorgu anahtarı DocumentSecurityOptions'dan gelir (TokenQueryKey, varsayılan "token"; UnauthorizedMessage, varsayılan "You Are Not Authorized To View This Page."). Bu seçenekleri uygulamayı oluşturmadan önce ASP.NET Core DI aracılığıyla yapılandırın. Oturum durumu kullanılamazsa ara katman HTTP 500 ile kapalı şekilde başarısız olur: ASP.NET Session is required for Doconut document security.
builder.Services.Configure<Doconut.Security.DocumentSecurityOptions>(options =>
{
options.TokenQueryKey = "token";
options.UnauthorizedMessage = "You Are Not Authorized To View This Page.";
});Temel sayfa ara katmanı, belgeyi sunmadan önce secure-{token} oturum işaretini doğrular. UnsafeMode = true ile, UseDoconut() erişim ara katmanını atlar ve temel işaret kontrolü de devre dışı bırakılır.
Birden çok düğümde güvenlik
Oturuma bağlı token'lar, bir sayfayı sunan düğümün belgeyi açan isteği de gördüğünü varsayar. Bu varsayım, birden çok düğüm aynı belgeleri paylaşımlı depolamadan sunduğunda geçerli değildir: bir sayfa isteği, açma isteğini hiç görmemiş bir düğüme gelebilir ve oturum başına kontrol onu reddeder.
Cevap, belgeleri korumasız bırakmak değildir. AddDoconutDistributedDocumentSecurity(...) aracılığıyla imzalı erişim biletleri kullanın; bu, oturum kontrolünü her düğümün bağımsız olarak doğrulayabileceği bir kimlik bilgisiyle değiştirir. Tam düzenleme Dağıtılmış Dağıtımlar sayfasındadır.
İptal
CloseDocument(token) sadece belleği serbest bırakmaz — aynı zamanda secure-{token} işaretini kaldırır ve erişim iznini iptal eder, böylece kapatılan token her iki güvenlik katmanında da hemen etkisiz hale gelir.
Üretim için kontrol listesi
UnsafeMode = false(varsayılan) tek bir düğümde tutun — bu global anahtar token'ları oturumlara bağlayan şeydir.AddDistributedMemoryCache()(MVC ve Razor Pages uygulamaları zaten sahip) veAddSession()kaydedin ve Doconut ara katmanı dalından önceapp.UseSession()çağırın.- Oturum çerez politikası widget isteklerinin çerezi taşımasına izin verdiğinden emin olun (
SameSite, HTTPS). - Kullanıcı belgeyi terk ettiğinde
CloseDocumentkullanın — hem bellek hem de güvenlik fayda sağlar. - Token'ları asla kaydetmeyin veya paylaşmayın; onları kısa ömürlü kimlik bilgileri gibi ele alın.
- Paylaşımlı depolamadan mı sunuyorsunuz? Korunmasız belgeleri kabul etmek yerine imzalı erişim biletlerine geçin.
Bu sayfa yardımcı oldu mu?