เซสชันและความปลอดภัย
เซสชันของเอกสารและการควบคุมการเข้าถึง
โทเค็น Doconut มีพลัง: ผู้ที่นำเสนอมันสามารถขอรับทุกหน้าของเอกสารได้หากไม่ได้ผูกกับเซสชันที่เปิดเอกสารนี้ หน้านี้อธิบายว่าเซสชันเก็บอะไรไว้, อายุการใช้งานเท่าใด, และการตรวจสอบที่ UseDoconut() เปิดใช้งานโดยค่าเริ่มต้น.
สิ่งที่เซสชันเอกสารเก็บไว้
แต่ละ OpenDocumentAsync ที่สำเร็จจะสร้างเซสชันหนึ่งใน IMemoryCache:
- ตัวแสดงรูปแบบที่โหลดแล้ว (อินสแตนซ์เอนจินเอกสารที่ถือเอกสารที่แปลงแล้ว),
- สถานะต่อหน้า — การหมุน, การพลิก, และข้อมูลคำอธิบายที่ผู้ใช้ใส่ในวิดเจ็ต,
- ตัวเลือก ดัชนีการค้นหา, สร้างแบบ lazy ในการค้นหาครั้งแรก (หรือโหลดจากไฟล์
.srhที่สร้างล่วงหน้าเมื่อหน้าถูกให้บริการจากที่เก็บข้อมูลร่วม), - ลายน้ำ ของเซสชันจาก
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 (ค่าเริ่มต้น), OpenDocumentAsync ผูกโทเค็นใหม่กับ เซสชัน ASP.NET ของคำขอ HTTP ที่เปิดมัน, โดยเขียนตัวทำเครื่องหมาย secure-{token} ลงในเซสชันนั้น. มิดเดิลแวร์ Doconut จากนั้นจะปฏิเสธการให้บริการหน้าให้กับเซสชันเบราว์เซอร์อื่น:
- เบราว์เซอร์/เซสชันที่ต่างกันนำเสนอโทเค็นที่ถูกขโมย → ภาพข้อผิดพลาด
You Are Not Authorized To View This Page. - มิดเดิลแวร์เซสชันไม่ได้ลงทะเบียน → HTTP 500
Session middleware not configured. Call UseSession() before UseDoconut().
นี่คือเหตุผลที่ เริ่มต้นอย่างเร็ว ยืนยันให้ใช้ AddSession() + app.UseSession() ก่อนสาขา Doconut. ผลลัพธ์เชิงปฏิบัติสองประการ:
- ลูกค้าต้องส่ง คุกกี้เซสชัน ของ ASP.NET พร้อมกับคำขอหน้า. การตั้งค่า cross-origin ที่ลบคุกกี้ (หรือไคลเอนต์ API ที่ไม่มี cookie jar) จะทำให้การตรวจสอบล้มเหลว — นั่นคือฟีเจอร์ทำงาน, ไม่ใช่บั๊ก.
options.UnsafeMode = trueปิดการผูกโทเค็นทั้งหมด. มันมีไว้สำหรับสถานการณ์ที่ควบคุมได้ (เช่น การเรนเดอร์ server-to-server); ปล่อยให้มันfalseในการผลิต.
การผูกโทเค็นถูกควบคุมโดยสวิตช์ global UnsafeMode นี้เท่านั้น — มันเปิดโดยค่าเริ่มต้น (UnsafeMode = false) และใช้กับทุกเซสชัน. ไม่มีการเลือกออกต่อเอกสาร; การตั้งค่า UnsafeMode = true จะปิดการผูกโทเค็นทั่วโลก.
การให้สิทธิ์การเข้าถึงและผู้ใช้ที่ผ่านการรับรอง
เมื่อ UnsafeMode เป็น false, UseDoconut() จะใส่ DocumentAccessMiddleware อัตโนมัติก่อนมิดเดิลแวร์หน้า. อย่าลงทะเบียนมันซ้ำ. เมื่อคำขอมีโทเค็น, มันจะค้นหา สิทธิ์การเข้าถึง ที่บันทึกเมื่อเอกสารถูกเปิดและให้สิทธิ์เฉพาะเมื่อเงื่อนไขต่อไปนี้เป็นจริง:
- มีการให้สิทธิ์สำหรับโทเค็น,
- ยังไม่หมดอายุ (อายุการให้สิทธิ์ =
TimeOutของเอกสาร), - ID ของเซสชัน ASP.NET ที่ร้องขอตรงกับที่เปิดเอกสาร,
- หากผู้เปิดเอกสารผ่านการรับรอง, คำร้องของผู้ใช้ที่ร้องขอมี claim
NameIdentifierตรงกันด้วย.
การล้มเหลวจะคืนค่า 403 — เป็นภาพ PNG ของข้อผิดพลาดสำหรับคำขอหน้า/ภาพย่อ, เป็นข้อความธรรมดาในกรณีอื่น. ข้อความและคีย์ query ของโทเค็นมาจาก DocumentSecurityOptions (TokenQueryKey, ค่าเริ่มต้น "token"; UnauthorizedMessage, ค่าเริ่มต้น "You Are Not Authorized To View This Page."). ตั้งค่าตัวเลือกเหล่านี้ผ่าน DI ของ ASP.NET Core ก่อนสร้างแอป. หาก สถานะเซสชัน ไม่พร้อมใช้งาน มิดเดิลแวร์จะปิดการทำงานด้วย HTTP 500: 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.";
});มิดเดิลแวร์หน้า core จากนั้นตรวจสอบ ตัวทำเครื่องหมายเซสชัน secure-{token} ก่อนให้บริการเอกสาร. ด้วย UnsafeMode = true, UseDoconut() จะข้ามมิดเดิลแวร์การเข้าถึงและการตรวจสอบตัวทำเครื่องหมาย core ก็ถูกปิดด้วย.
ความปลอดภัยข้ามหลายโหนด
โทเค็นที่ผูกกับเซสชันสมมติว่าโหนดที่ให้บริการหน้าก็ได้เห็นคำขอที่เปิดเอกสารด้วย. สมมติฐานนี้ไม่เป็นจริงเมื่อหลายโหนดให้บริการเอกสารเดียวกันจากที่เก็บข้อมูลร่วม: คำขอหน้าอาจไปยังโหนดที่ไม่เคยเห็นการเปิด, และการตรวจสอบต่อเซสชันจะปฏิเสธ.
คำตอบคือไม่ให้เอกสารไม่มีการป้องกัน. ใช้ signed access tickets ผ่าน AddDoconutDistributedDocumentSecurity(...), ซึ่งแทนที่การตรวจสอบเซสชันด้วยข้อมูลรับรองที่แต่ละโหนดสามารถตรวจสอบได้อย่างอิสระ. การจัดเรียงเต็มรูปแบบอยู่ใน การปรับใช้แบบกระจาย.
การเพิกถอน
CloseDocument(token) ไม่ได้แค่ปลดปล่อยหน่วยความจำ — มันยังลบ ตัวทำเครื่องหมาย secure-{token} และเพิกถอน สิทธิ์การเข้าถึง, ดังนั้นโทเค็นที่ปิดจะตายบนชั้นความปลอดภัยทั้งสองทันที.
รายการตรวจสอบสำหรับการผลิต
- รักษา
UnsafeMode = false(ค่าเริ่มต้น) บนโหนดเดียว — สวิตช์ global นี้คือสิ่งที่ผูกโทเค็นกับเซสชัน. - ลงทะเบียน
AddDistributedMemoryCache()(แอป MVC และ Razor Pages มีแล้ว) และAddSession(), และเรียกapp.UseSession()ก่อนสาขามิดเดิลแวร์ Doconut. - ตรวจสอบให้แน่ใจว่า นโยบายคุกกี้เซสชัน ของคุณอนุญาตให้คำขอของวิดเจ็ตพาคุกกี้ไปด้วย (
SameSite, HTTPS). - ใช้
CloseDocumentเมื่อผู้ใช้ออกจากเอกสาร — ทั้งหน่วยความจำและความปลอดภัยจะได้ประโยชน์. - อย่าเก็บบันทึกหรือแชร์โทเค็น; ปฏิบัติเช่นเป็นข้อมูลรับรองที่มีอายุสั้น.
- ให้บริการจากที่เก็บข้อมูลร่วม? ย้ายไปใช้ signed access tickets แทนการรับเอกสารที่ไม่มีการป้องกัน.
หน้านี้เป็นประโยชน์หรือไม่?