הפעלות ואבטחה
הפעלות מסמכים ובקרת גישה
אסימון Doconut מזהה מסמך פתוח. אם כל בקשה שנושאת אותו תשרת, מי שקיבל אותו יוכל לקרוא כל דף. דף זה מסביר מה מכילה הפעלת מסמך, כמה זמן היא נמשכת, וכיצד DocImage.axd מחליט מי רשאי לראות את הדפים — בשרת יחיד ובחוות רשת.
מה שמכילה הפעלת מסמך
כל OpenDocumentAsync מוצלח יוצר הפעלה אחת, הנשמרת בזיכרון:
- המציג הפורמט הטעון — מופע המנוע המחזיק את המסמך המפוענח,
- מצב לכל דף — סיבוב, הפיכות, ונתוני ההערות שהמשתמש מוסיף בווידג'ט,
- האינדקס חיפוש האופציונלי, נבנה בחיפוש הראשון (או נטען מקובץ
.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 — ברירת המחדל — פתיחת מסמך מעניקה גישה להפעלה של ASP.NET של הבקשה שפתחה אותו, על‑ידי כתיבת רשומת secure-{token} באותה הפעלה. DocImage.axd דורש את מצב ההפעלה עצמו, ומגיש דף רק כאשר הפעלת המבקש מחזיקה ברשומה זו. כל דפדפן אחר המציג את אותו אסימון מקבל תמונת שגיאה עם הטקסט You Are Not Authorized To View This Page..
Doconut.DoconutHost.Initialize(options =>
{
// false (ברירת המחדל): DocImage.axd מגיש דף רק ל‑session של ASP.NET שפתח
// המסמך. המטפל מבקש את מצב ה‑session בעצמו; הוא רק צריך שהאתר לא
// לכבות את מצב ה‑session ב‑Web.config.
options.UnsafeMode = false;
});שלוש תוצאות מעשיות:
- קצה הפתיחה צריך מצב הפעלה. בקרי MVC ודפי Web Forms כוללים אותו כברירת מחדל.
IHttpHandlerמותאם אישית אינו כולל זאת אלא אם הוא מממשSystem.Web.SessionState.IRequiresSessionState. פתיחה שפועלת ללא הפעלה לא יכולה להעניק דבר, ולכן הצופה מציג את ההודעה "אינך מורשה לצפות בדף זה" בכל דף. - מצב ההפעלה חייב להישאר פעיל.
<sessionState mode="Off" />ב-Web.configמשביתים הן את ההענקה והן את הבדיקה, וכל דף נדחה. - הדפדפן חייב לשלוח את קוביית ההפעלה. הבקשות של הווידג'ט הן מאותו מקור, ולכן הן נושאות את
ASP.NET_SessionIdבאופן אוטומטי. לקוח ללא מכולת קוביות — סקריפט, קריאה משרת‑לשרת, או הגדרה חוצת‑מקור שמסירה קוביות — נדחה. זהו האופן שבו הפונקציה פועלת.
UnsafeMode = true מכבה את הבדיקה: כל בקשה שנושאת את האסימון משרתת. זהו מתג גלובלי אחד לכל מסמך, ללא אפשרות דריסת הגדרה לכל מסמך בנפרד. השאירו אותו false.
שלילה
CloseDocument(token) עושה יותר משחרור זיכרון: הוא מסיר את רשומת secure-{token} מההפעלה של הבקשה הנוכחית ומבטל את האסימון, כך שאסימון שבוטל נדחה מייד.
חוות רשת: כרטיסים חתומים
בחווה, הבקשה הבאה יכולה להגיע לשרת שמעולם לא ראה את המסמך, בתהליך עובד שונה, עם הפעלה משלו של ASP.NET. ההענקה של ההפעלה אינה יכולה לעקוב אחריה. מצב מבוזר מחליף זאת בכרטיס חתום הקשור לדפדפן: כל צומת חולקת מחסן אחד להפעלות מסמכים ומפתח חתימה אחד, ו-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 ק״ב, בעוד שדף אמיתי הוא בעשרות עד מאות קילובייטים.
רשימת בדיקה לייצור
- השאירו את
UnsafeMode = false(ברירת המחדל). - פתחו מסמכים מבקשות שיש להן מצב הפעלה, ולעולם אל תכבו את מצב ההפעלה.
- ודאו שקוביית ההפעלה מגיעה ל
DocImage.axd(אותו מקור, HTTPS, מדיניותSameSiteהמאפשרת זאת). - בחווה, השתמשו במצב מבוזר עם מפתח חתימה אחד משותף לכל הצמתים.
- קראו ל-
CloseDocumentכאשר המשתמש עוזב מסמך — זיכרון ואבטחה משפרים יחד. - לעולם אל תתעדו או תשתפו אסימונים; התייחסו אליהם כאל אישורים קצרים טווח.
האם דף זה היה מועיל?