เซสชันและความปลอดภัย
เซสชันเอกสารและการควบคุมการเข้าถึง
โทเคน Doconut ระบุเอกสารที่เปิดอยู่ หากมีคำขอใดที่พาโทเคนนี้ไปให้บริการ ผู้ที่ได้มาจะสามารถอ่านทุกหน้าได้ หน้านี้อธิบายว่าเซสชันเอกสารเก็บอะไรไว้, มีอายุเท่าไร, และว่า DocImage.axd ตัดสินว่าใครสามารถดูหน้าของมันได้ — บนเซิร์ฟเวอร์เดียวและในฟาร์มเว็บ
สิ่งที่เซสชันเอกสารเก็บไว้
แต่ละ OpenDocumentAsync ที่สำเร็จจะสร้างเซสชันหนึ่ง, เก็บไว้ในหน่วยความจำ:
- loaded format viewer — อินสแตนซ์ของเอนจินที่เก็บเอกสารที่แปลงแล้ว,
- per-page state — การหมุน, การพลิก, และข้อมูลคำอธิบายที่ผู้ใช้ใส่ในวิดเจ็ต,
- ตัวเลือก search index, สร้างขึ้นในการค้นหาแรก (หรือโหลดจากไฟล์
.srhที่สร้างล่วงหน้า), - watermark ของเซสชันจาก
DocOptions.Watermark.
อายุการใช้งาน
เซสชันหมดอายุบน sliding window: DocOptions.TimeOut นาที (ค่าเริ่มต้น 60), รีเซ็ตโดยทุกคำขอที่นำโทเคนมา เมื่อเซสชันสิ้นสุด — ด้วยการหมดอายุหรือโดย CloseDocument(token) — เอนจินเอกสารของมันจะถูกปล่อยและหน่วยความจำจะถูกล้างทันที.
// เซสชันที่มีอายุสั้นสำหรับการพรีวิวแบบครั้งเดียว
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });คำขอที่มีโทเคนหมดอายุจะได้รับภาพข้อผิดพลาดที่อ่านว่า Document session not found. Please re-open document. หน้าต้องเปิดเอกสารใหม่เพื่อรับโทเคนใหม่ บนเซิร์ฟเวอร์เดียว, การรีไซเคิลแอปพลิเคชันพูลก็ทำให้ทุกเซสชันสิ้นสุดเช่นกัน.
หน้าให้บริการเฉพาะกับเซสชันที่เปิดมัน
ด้วย UnsafeMode = false — ค่าเริ่มต้น — การเปิดเอกสารให้สิทธิ์การเข้าถึง ASP.NET session ของคำขอที่เปิดมัน, โดยเขียนรายการ secure-{token} ลงในเซสชันนั้น DocImage.axd ต้องการสถานะเซสชันเอง, และให้บริการหน้าเฉพาะเมื่อเซสชันที่ขอมีรายการนั้น เบราว์เซอร์อื่นที่นำโทเคนเดียวกันมา จะได้รับภาพข้อผิดพลาดที่อ่านว่า You Are Not Authorized To View This Page.
Doconut.DoconutHost.Initialize(options =>
{
// false (ค่าเริ่มต้น): DocImage.axd ให้บริการหน้าเฉพาะกับเซสชัน ASP.NET ที่เปิดมัน
// เอกสาร ตัวจัดการขอสถานะเซสชันด้วยตนเอง; มันต้องการเพียงให้ไซต์ไม่ต้อง
// ปิดสถานะเซสชันใน Web.config.
options.UnsafeMode = false;
});สามผลลัพธ์เชิงปฏิบัติ:
- จุดเปิดต้องการสถานะเซสชัน. ตัวควบคุม MVC และหน้า Web Forms มีสถานะนี้โดยค่าเริ่มต้น.
IHttpHandlerแบบกำหนดเองไม่มีหากไม่ได้ทำการ implementSystem.Web.SessionState.IRequiresSessionState. การเปิดที่ทำงานโดยไม่มีเซสชันไม่มีสิ่งที่จะให้สิทธิ์, ดังนั้น viewer จะแสดงข้อความ "คุณไม่ได้รับอนุญาตให้ดูหน้านี้" ในทุกหน้า. - สถานะเซสชันต้องเปิดอยู่.
<sessionState mode="Off" />ในWeb.configปิดการทำงานของการให้สิทธิและการตรวจสอบ, ทำให้ทุกหน้าได้รับการปฏิเสธ. - เบราว์เซอร์ต้องส่งคุกกี้เซสชัน. คำขอของวิดเจ็ตเป็น same-origin, ดังนั้นจึงส่ง
ASP.NET_SessionIdโดยอัตโนมัติ. ลูกค้าที่ไม่มีคุกกี้เจอร์ — สคริปต์, การเรียก server-to-server, การตั้งค่า cross-origin ที่ลบคุกกี้ — จะถูกปฏิเสธ. นั่นคือฟีเจอร์ที่ทำงาน.
UnsafeMode = true ปิดการตรวจสอบ: คำขอใดที่พาโทเคนจะได้รับการให้บริการ. นี่คือสวิตช์ระดับโลกสำหรับทุกเอกสาร, ไม่มีการเขียนทับต่อเอกสารแต่ละอัน. ปล่อยไว้ false.
การเพิกถอน
CloseDocument(token) ทำมากกว่าการปล่อยหน่วยความจำ: มันลบรายการ secure-{token} จากเซสชันของคำขอปัจจุบันและเพิกถอนโทเคน, ทำให้โทเคนที่ปิดแล้วถูกปฏิเสธทันที.
ฟาร์มเว็บ: ตั๋วที่ลงลายเซ็น
ในฟาร์ม, คำขอถัดไปอาจไปยังเซิร์ฟเวอร์ที่ไม่เคยเห็นเอกสาร, ในกระบวนการทำงานที่ต่างกัน, มี ASP.NET session ของตนเอง. การให้สิทธิของเซสชันไม่สามารถตามมันได้. โหมดกระจายจะแทนที่ด้วย signed ticket ที่ผูกกับเบราว์เซอร์: ทุกโหนดแชร์ที่เก็บเดียวสำหรับเซสชันเอกสารและคีย์การลงลายเซ็นหนึ่งคีย์, และ DocImage.axd ยอมรับคำขอเมื่อตั๋วของมันถูกต้องสำหรับโทเคนนั้น, เบราว์เซอร์นั้น, และ — เมื่อผู้ใช้เข้าสู่ระบบ — ผู้ใช้นั้น.
การตั้งค่า, เหมือนกันบนทุกโหนด:
// Global.asax.cs - Application_Start
// ความลับของฟาร์ม: อย่างน้อย 32 ไบต์, เหมือนกันบนทุกโหนด, เก็บไว้ไกลจากการควบคุมเวอร์ชัน
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // การตรวจสอบตั๋วจะทำงานเฉพาะเมื่อค่านี้เป็น false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // โฟลเดอร์ที่ทุกโหนดสามารถเข้าถึงได้
d.SigningKey = farmKey; // อย่างน้อย 32 ไบต์, เหมือนกันบนทุกโหนด
}));จุดเปิดจะผูกตั๋วกับเบราว์เซอร์ก่อนเปิด, และส่งคืนตั๋วพร้อมกับโทเคน:
- ตั้งค่า
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— มันออกคุกกี้doconut-clientที่ตั๋วเชื่อมโยง — และDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - หลังจาก
OpenDocumentAsync, ส่งคืนviewer.AccessTokenควบคู่กับโทเคน; - ในหน้า, ส่งค่าทั้งสองให้วิดเจ็ต:
objViewer.View(token, access).
ย้ายจากแฟล็กเว็บฟาร์มแบบคลาสสิก (IsWebfarm กับ ExportToPng)? การย้าย แสดงขั้นตอนการเปลี่ยนแปลงทีละขั้นตอน.
เก็บคีย์การลงลายเซ็นให้อยู่นอกการควบคุมซอร์สโค้ด: มันใช้ลงลายเซ็นตั๋วและเข้ารหัสเอกสารในที่เก็บร่วม. โหนดที่มีคีย์ต่างกันจะปฏิเสธทุกตั๋วที่โหนดอื่นออก.
ทดสอบฟาร์มด้วยเบราว์เซอร์จริง, หรือสคริปต์ที่เก็บคุกกี้. ลูกค้าที่ไม่มีคุกกี้ doconut-client จะไม่ได้รับการตอบกลับด้วย 401: มันจะได้รับภาพข้อผิดพลาด "ไม่ได้รับอนุญาต" พร้อมสถานะ 200, ประมาณ 2 KB, ในขณะที่หน้าจริงมีขนาดหลายสิบถึงหลายร้อยกิโลไบต์.
รายการตรวจสอบการผลิต
- คงไว้
UnsafeMode = false(ค่าเริ่มต้น). - เปิดเอกสารจากคำขอที่มีสถานะเซสชัน, และอย่าปิดสถานะเซสชันเลย.
- ตรวจสอบให้คุกกี้เซสชันถึง
DocImage.axd(same origin, HTTPS, นโยบายSameSiteที่อนุญาต). - ในฟาร์ม, ใช้โหมดกระจายพร้อมคีย์การลงลายเซ็นหนึ่งคีย์ที่แชร์โดยทุกโหนด.
- เรียก
CloseDocumentเมื่อผู้ใช้ออกจากเอกสาร — ทั้งหน่วยความจำและความปลอดภัยจะได้ประโยชน์. - ห้ามบันทึกหรือแชร์โทเคน; ปฏิบัติเช่นเป็นข้อมูลรับรองที่มีอายุสั้น.
หน้านี้เป็นประโยชน์หรือไม่?