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

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

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

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

แต่ละ OpenDocumentAsync ที่สำเร็จจะสร้างเซสชันหนึ่ง, เก็บไว้ในหน่วยความจำ:

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

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

เซสชันหมดอายุบน sliding window: 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 — ค่าเริ่มต้น — การเปิดเอกสารให้สิทธิ์การเข้าถึง ASP.NET session ของคำขอที่เปิดมัน, โดยเขียนรายการ secure-{token} ลงในเซสชันนั้น DocImage.axd ต้องการสถานะเซสชันเอง, และให้บริการหน้าเฉพาะเมื่อเซสชันที่ขอมีรายการนั้น เบราว์เซอร์อื่นที่นำโทเคนเดียวกันมา จะได้รับภาพข้อผิดพลาดที่อ่านว่า You Are Not Authorized To View This Page.

csharp
Doconut.DoconutHost.Initialize(options =>
{
    // false (ค่าเริ่มต้น): DocImage.axd ให้บริการหน้าเฉพาะกับเซสชัน ASP.NET ที่เปิดมัน
    // เอกสาร ตัวจัดการขอสถานะเซสชันด้วยตนเอง; มันต้องการเพียงให้ไซต์ไม่ต้อง
    // ปิดสถานะเซสชันใน Web.config.
    options.UnsafeMode = false;
});

สามผลลัพธ์เชิงปฏิบัติ:

  • จุดเปิดต้องการสถานะเซสชัน. ตัวควบคุม MVC และหน้า Web Forms มีสถานะนี้โดยค่าเริ่มต้น. IHttpHandler แบบกำหนดเองไม่มีหากไม่ได้ทำการ implement System.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 ยอมรับคำขอเมื่อตั๋วของมันถูกต้องสำหรับโทเคนนั้น, เบราว์เซอร์นั้น, และ — เมื่อผู้ใช้เข้าสู่ระบบ — ผู้ใช้นั้น.

การตั้งค่า, เหมือนกันบนทุกโหนด:

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

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