Sesi & Keamanan
Sesi dokumen dan kontrol akses
Token Doconut mengidentifikasi dokumen yang terbuka. Jika ada permintaan yang membawa token tersebut dilayani, siapa pun yang mendapatkannya dapat membaca setiap halaman. Halaman ini menjelaskan apa yang disimpan dalam sesi dokumen, berapa lama sesi tersebut hidup, dan bagaimana DocImage.axd memutuskan siapa yang boleh melihat halamannya — pada satu server dan di web farm.
Apa yang disimpan dalam sesi dokumen
Setiap OpenDocumentAsync yang berhasil membuat satu sesi, disimpan dalam memori:
- penampil format yang dimuat — instance mesin yang menyimpan dokumen yang diparsing,
- per-page state — rotasi, pembalikan, dan data anotasi yang diterapkan pengguna di widget,
- indeks pencarian opsional, dibangun pada pencarian pertama (atau dimuat dari file
.srhyang telah dibangun sebelumnya), - tanda air sesi dari
DocOptions.Watermark.
Umur Sesi
Sesi berakhir pada jendela geser: DocOptions.TimeOut menit (bawaan 60), direset oleh setiap permintaan yang menyajikan token. Ketika sesi berakhir — karena kedaluwarsa atau oleh CloseDocument(token) — mesin dokumen dilepaskan dan memorinya dibebaskan segera.
// Sesi singkat untuk pratinjau satu kali
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Permintaan dengan token yang kedaluwarsa akan menampilkan gambar error yang menampilkan Document session not found. Please re-open document.. Halaman harus membuka dokumen kembali untuk mendapatkan token baru. Pada satu server, mendaur ulang application pool juga mengakhiri setiap sesi.
Halaman hanya dilayani untuk sesi yang membukanya
Dengan UnsafeMode = false — bawaan — membuka dokumen memberikan akses ke ASP.NET session dari permintaan yang membukanya, dengan menulis entri secure-{token} ke dalam sesi tersebut. DocImage.axd memerlukan session state itu sendiri, dan melayani halaman hanya ketika sesi yang meminta memiliki entri tersebut. Browser lain yang menyajikan token yang sama akan menampilkan gambar error yang menampilkan You Are Not Authorized To View This Page..
Doconut.DoconutHost.Initialize(options =>
{
// false (default): DocImage.axd menyajikan halaman hanya kepada sesi ASP.NET yang membuka
// dokumen. Handler meminta status sesi sendiri; hanya membutuhkan situs agar tidak
// mematikan status sesi di Web.config.
options.UnsafeMode = false;
});Tiga konsekuensi praktis:
- Endpoint pembukaan memerlukan session state. Kontroler MVC dan halaman Web Forms memilikinya secara bawaan.
IHttpHandlerkhusus tidak memilikinya kecuali ia mengimplementasikanSystem.Web.SessionState.IRequiresSessionState. Sebuah pembukaan yang berjalan tanpa sesi tidak memiliki apa pun untuk diberikan, sehingga penampil menampilkan "You Are Not Authorized To View This Page." pada setiap halaman. - Session state harus tetap aktif.
<sessionState mode="Off" />dalamWeb.configmenonaktifkan baik pemberian maupun pemeriksaan, dan setiap halaman ditolak. - Browser harus mengirim cookie sesi. Permintaan widget bersifat sumber yang sama, sehingga mereka secara otomatis membawa
ASP.NET_SessionId. Klien tanpa cookie jar — skrip, panggilan server-ke-server, pengaturan cross-origin yang menghapus cookie — ditolak. Itu adalah fitur yang berfungsi.
UnsafeMode = true mematikan pemeriksaan: setiap permintaan yang membawa token dilayani. Itu adalah saklar global tunggal untuk setiap dokumen, tanpa penimpaan per-dokumen. Biarkan itu false.
Pencabutan
CloseDocument(token) melakukan lebih dari membebaskan memori: ia menghapus entri secure-{token} dari sesi permintaan saat ini dan mencabut token, sehingga token yang ditutup ditolak seketika.
Web farm: tiket yang ditandatangani
Di sebuah farm, permintaan berikutnya dapat mendarat pada server yang belum pernah melihat dokumen, di proses worker yang berbeda, dengan ASP.NET session miliknya sendiri. Pemberian sesi tidak dapat mengikutinya. Mode terdistribusi menggantinya dengan tiket yang ditandatangani yang terikat pada browser: setiap node berbagi satu penyimpanan untuk sesi dokumen dan satu kunci penandatanganan, dan DocImage.axd menerima permintaan ketika tiketnya valid untuk token tersebut, browser itu, dan — ketika pengguna sudah masuk — pengguna itu.
Pengaturan, identik pada setiap node:
// Global.asax.cs - Application_Start
// Rahasia farm: setidaknya 32 byte, sama pada setiap node, disimpan di luar kontrol sumber.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // pemeriksaan tiket hanya dijalankan ketika ini false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // folder yang dapat diakses oleh setiap node
d.SigningKey = farmKey; // setidaknya 32 byte, SAMA pada setiap node
}));Endpoint pembukaan kemudian mengikat tiket ke browser sebelum membuka, dan mengembalikan tiket bersama token:
- atur
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— ia mengeluarkan cookiedoconut-clientyang terikat pada tiket — danDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - setelah
OpenDocumentAsync, kembalikanviewer.AccessTokenbersamaan dengan token; - di halaman, kirimkan keduanya ke widget:
objViewer.View(token, access).
Berpindah dari flag web-farm klasik (IsWebfarm dengan ExportToPng)? Migration menunjukkan perubahan langkah demi langkah.
Simpan kunci penandatanganan di luar kontrol sumber: kunci tersebut menandatangani tiket dan mengenkripsi dokumen dalam penyimpanan bersama. Node dengan kunci yang berbeda menolak setiap tiket yang dikeluarkan oleh node lain.
Uji farm dengan browser nyata, atau skrip yang menyimpan cookie. Klien tanpa cookie doconut-client tidak dijawab dengan 401: ia menerima gambar error "tidak berwenang" dengan status 200, sekitar 2 KB, sementara halaman nyata berukuran puluhan hingga ratusan kilobyte.
Daftar periksa produksi
- Pertahankan
UnsafeMode = false(bawaan). - Buka dokumen dari permintaan yang memiliki session state, dan jangan pernah mematikan session state.
- Pastikan cookie sesi mencapai
DocImage.axd(sumber yang sama, HTTPS, kebijakanSameSiteyang mengizinkannya). - Di farm, gunakan mode terdistribusi dengan satu kunci penandatanganan yang dibagikan oleh setiap node.
- Panggil
CloseDocumentketika pengguna meninggalkan dokumen — memori dan keamanan keduanya mendapat manfaat. - Jangan pernah mencatat atau membagikan token; perlakukan mereka sebagai kredensial berumur pendek.
Apakah halaman ini membantu?