เซสชันและความปลอดภัย

เซสชันของเอกสารและการควบคุมการเข้าถึง

โทเค็น Doconut มีพลัง: ผู้ที่นำเสนอมันสามารถร้องขอทุกหน้าของเอกสารได้หากไม่ได้ผูกกับเซสชันที่เปิดเอกสาร หน้านี้อธิบายว่าเซสชันเก็บอะไรไว้, อายุการใช้งานเป็นเท่าไหร่, และการตรวจสอบที่ UseDoconut() เปิดใช้งานโดยค่าเริ่มต้น.

สิ่งที่เซสชันของเอกสารเก็บไว้

แต่ละ OpenDocumentAsync ที่สำเร็จจะสร้างเซสชันหนึ่งใน IMemoryCache:

  • ตัวแสดงรูปแบบที่โหลดแล้ว (อินสแตนซ์เอนจินเอกสารที่ถือเอกสารที่แปลงแล้ว),
  • สถานะต่อหน้า — การหมุน, การพลิก, และข้อมูลคำอธิบายที่ผู้ใช้ใส่ในวิดเจ็ต,
  • ดัชนีการค้นหา (แบบเลือกใช้), สร้างแบบขี้เกียจเมื่อทำการค้นหาแรก (หรือโหลดจากไฟล์ .srh ที่สร้างล่วงหน้าเมื่อหน้าถูกให้บริการจากที่เก็บข้อมูลร่วม),
  • ลายน้ำ ของเซสชันจาก DocOptions.Watermark.

อายุการใช้งาน

เซสชันหมดอายุบน หน้าต่างเลื่อน: DocOptions.TimeOut นาที (ค่าเริ่มต้น 60), รีเซ็ตโดยทุกคำขอที่นำเสนอโทเค็น เมื่อเซสชันถูกขับออก — ด้วยการหมดอายุหรือโดย CloseDocument(token) — คอลแบ็กการขับออกจะทำลายเอนจินเอกสารและปลดปล่อยหน่วยความจำที่เกี่ยวข้องทันที.

csharp
// เซสชันระยะสั้นสำหรับการพรีวิวแบบครั้งเดียว
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 อัตโนมัติก่อนมิดเดิลแวร์หน้า. อย่าลงทะเบียนมันซ้ำอีกครั้ง. เมื่อคำขอมีโทเค็น, มันจะค้นหา สิทธิ์การเข้าถึง ที่บันทึกเมื่อเอกสารถูกเปิดและจะอนุญาตเฉพาะเมื่อเงื่อนไขทั้งหมดต่อไปนี้เป็นจริง:

  1. มีสิทธิ์สำหรับโทเค็น,
  2. ยังไม่หมดอายุ (อายุสิทธิ์ = TimeOut ของเอกสาร),
  3. ID ของเซสชัน ASP.NET ที่ร้องขอตรงกับที่เปิดเอกสาร,
  4. หากผู้เปิดได้รับการรับรอง, คำร้องของผู้ใช้ที่ร้องขอมี 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.

csharp
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 เมื่อผู้ใช้ออกจากเอกสาร — ทั้งหน่วยความจำและความปลอดภัยจะได้ประโยชน์.
  • อย่าเคยบันทึกหรือแชร์โทเค็น; ปฏิบัติกับมันเหมือนข้อมูลประจำตัวที่มีอายุสั้น.
  • ให้บริการจากที่เก็บข้อมูลร่วม? ย้ายไปใช้ตั๋วการเข้าถึงที่ลงลายเซ็นแทนการยอมรับเอกสารที่ไม่มีการปกป้อง.

หน้านี้เป็นประโยชน์หรือไม่?