เซสชันและความปลอดภัย
เซสชันของเอกสารและการควบคุมการเข้าถึง
โทเค็น Doconut มีพลัง: ผู้ที่นำเสนอมันสามารถร้องขอทุกหน้าของเอกสารได้หากไม่ได้ผูกกับเซสชันที่เปิดเอกสาร หน้านี้อธิบายว่าเซสชันเก็บอะไรไว้, อายุการใช้งานเป็นเท่าไหร่, และการตรวจสอบที่ UseDoconut() เปิดใช้งานโดยค่าเริ่มต้น.
สิ่งที่เซสชันของเอกสารเก็บไว้
แต่ละ OpenDocumentAsync ที่สำเร็จจะสร้างเซสชันหนึ่งใน IMemoryCache:
- ตัวแสดงรูปแบบที่โหลดแล้ว (อินสแตนซ์เอนจินเอกสารที่ถือเอกสารที่แปลงแล้ว),
- สถานะต่อหน้า — การหมุน, การพลิก, และข้อมูลคำอธิบายที่ผู้ใช้ใส่ในวิดเจ็ต,
- ดัชนีการค้นหา (แบบเลือกใช้), สร้างแบบขี้เกียจเมื่อทำการค้นหาแรก (หรือโหลดจากไฟล์
.srhที่สร้างล่วงหน้าเมื่อหน้าถูกให้บริการจากที่เก็บข้อมูลร่วม), - ลายน้ำ ของเซสชันจาก
DocOptions.Watermark.
อายุการใช้งาน
เซสชันหมดอายุบน หน้าต่างเลื่อน: 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().
นี่คือเหตุผลที่ Quick Start ยืนยันให้ใช้ 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."). กำหนดตัวเลือกเหล่านี้ผ่าน ASP.NET Core DI ก่อนสร้างแอป. หาก สถานะเซสชัน ไม่พร้อมใช้งาน มิดเดิลแวร์จะปิดการทำงานด้วย 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.";
});มิดเดิลแวร์หน้าแกนหลักจากนั้นจะตรวจสอบมาร์กเกอร์เซสชัน secure-{token} ก่อนให้บริการเอกสาร. ด้วย UnsafeMode = true, UseDoconut() จะข้ามมิดเดิลแวร์การเข้าถึงและการตรวจสอบมาร์กเกอร์แกนหลักก็ถูกปิดด้วยเช่นกัน.
ความปลอดภัยข้ามหลายโหนด
โทเค็นที่ผูกกับเซสชันสมมติว่าโหนดที่ให้บริการหน้าก็ได้เห็นคำขอที่เปิดเอกสารด้วย. สมมติฐานนี้ไม่เป็นจริงเมื่อหลายโหนดให้บริการเอกสารเดียวกันจากที่เก็บข้อมูลร่วม: คำขอหน้าอาจไปยังโหนดที่ไม่เคยเห็นการเปิดเอกสาร, และการตรวจสอบต่อเซสชันจะปฏิเสธมัน.
คำตอบคือไม่ปล่อยให้เอกสารไม่มีการปกป้อง. ใช้ตั๋วการเข้าถึงที่ลงลายเซ็นผ่าน AddDoconutDistributedDocumentSecurity(...), ซึ่งแทนที่การตรวจสอบเซสชันด้วยข้อมูลประจำตัวที่แต่ละโหนดสามารถตรวจสอบได้อย่างอิสระ. การจัดเรียงเต็มรูปแบบอยู่ใน การปรับใช้แบบกระจาย.
การเพิกถอน
CloseDocument(token) ไม่ได้เพียงแค่ปล่อยหน่วยความจำ — มันยังลบมาร์กเกอร์ secure-{token} และเพิกถอน สิทธิ์การเข้าถึง, ดังนั้นโทเค็นที่ปิดจะตายบนชั้นความปลอดภัยทั้งสองทันที.
รายการตรวจสอบสำหรับการผลิต
- เก็บ
UnsafeMode = false(ค่าเริ่มต้น) บนโหนดเดียว — สวิตช์ global นี้คือสิ่งที่ผูกโทเค็นกับเซสชัน. - ลงทะเบียน
AddDistributedMemoryCache()(แอป MVC และ Razor Pages มีแล้ว) และAddSession(), และเรียกapp.UseSession()ก่อนสาขามิดเดิลแวร์ Doconut. - ตรวจสอบให้แน่ใจว่า นโยบายคุกกี้เซสชัน ของคุณอนุญาตให้คำขอของวิดเจ็ตส่งคุกกี้ (
SameSite, HTTPS). - ใช้
CloseDocumentเมื่อผู้ใช้ออกจากเอกสาร — ทั้งหน่วยความจำและความปลอดภัยจะได้ประโยชน์. - อย่าเคยบันทึกหรือแชร์โทเค็น; ปฏิบัติกับมันเหมือนข้อมูลประจำตัวที่มีอายุสั้น.
- ให้บริการจากที่เก็บข้อมูลร่วม? ย้ายไปใช้ตั๋วการเข้าถึงที่ลงลายเซ็นแทนการยอมรับเอกสารที่ไม่มีการปกป้อง.
หน้านี้เป็นประโยชน์หรือไม่?