רבים מהמפתחים מתחילים בחיפוש אחר ספריות רכיבי UI כאשר הם צריכים להציג מסמכים ביישום אינטרנט. Doconut מציג הוא SDK של .NET להוספת צפייה בדפדפן ללא תוספים ל‑ASP.NET Core, MVC או פרויקטים קלאסיים של WebForms. האבטחה עדיין תלויה בארכיטקטורה המלאה של היישום: אימות, הרשאה, העברה, אחסון, אימות קלט, ניקוי, עדכונים וניטור.

מציג מסמכי ASP.NET מאובטח המוגן על ידי בקרות אפליקציה מרובות שכבות

1. התקנת ערכת הפיתוח של Doconut App והכנת פרויקט .NET שלך לתמיכה בפורמטים מרובים

1.1 הוספת החבילה הנתמכת

השתמשו בחבילה העדכנית ובהוראות ההתקנה מהדף הרשמי של דף ההורדה של Doconut. רשמו את הגרסה שנבחרה וודאו שהיא תומכת בזמן הריצה של .NET היעד.

1.2 אימות הפנייה לחבילה

לאחר ההתקנה, אשרו את הפנייה לחבילה ואת הגרסה שנפתרה בקובץ הפרויקט. שמירת גרסאות מפורטת מסייעת להפוך בניות והפצות לחוזרות.

1.3 הפעלת HTTPS

Doconut App דורש SSL לכל העלאות הקבצים. ודאו שהיישום שלכם מקשיב ב‑HTTPS. עבור אפליקציה המופעלת ב‑Kestrel, הוסיפו תצורת נקודת קצה ב‑appsettings.json:

 {
   "Kestrel": {
     "Endpoints": {
       "Https": {
         "Url": "
       }
     }
   }
 }

אם אתם מארחים ב‑IIS, קשורו תעודת HTTPS לאתר. עם HTTPS מופעל, כל קובץ עובר בערוץ מאובטח לפני שמגיע למנוע הרינדור של Doconut App.

למה Doconut App?
Doconut App הוא מציג מקורי ל‑.NET היחיד המשלב רינדור ללא תוספים עם הצפנה מקצה לקצה של AES‑256, ומאפשר לכם לעמוד בדרישות הציות ללא צורך בתשתית נוספת.

2. הגדרת העלאות קבצים מאובטחות ואחסון לניהול מסמכים

מודל האבטחה של Doconut App מבוסס על שלושה עמודים: העברת SSL, הצפנת AES‑256 במנוחה, ומחיקה אוטומטית לאחר הצפייה. ערכת הפיתוח מספקת שירות מוכן לשימוש שניתן לרשום ביישום שלכם.

2.1 רישום שירות ההעלאה

ב‑Startup.cs (או Program.cs עבור .NET 6+), הוסיפו את שירותי Doconut למיכל ה‑dependency injection. הגדרו תיקיית אחסון זמנית, הפעלו הצפנת AES‑256, וקבעו את מרווח המחיקה האוטומטית (לדוגמה, 10 דקות לאחר שהמסמך נצפה).

2.2 יצירת נקודת קצה להעלאה

ממשו פעולה בבקר שמקבלת קובץ שהועלה, מעבירה אותו לשירות Doconut לאחסון מאובטח, ומחזירה אסימון חד‑פעמי קצר. האסימון הוא מה שהמציג בצד הלקוח ישתמש בו כדי לאחזר ולרנדר את המסמך.

2.3 הגנת נקודת הקצה

מאחר שנקודת הקצה של ההעלאה מטפלת בנתונים רגישים, הגנו עליה באמצעות אימות והרשאה מבוססת תפקידים (למשל, רק משתמשים בתפקיד DocumentViewer יכולים להעלות). זה מבטיח שרק צוות מורשה יוכל לאחסן ולצפות במסמכים חסויים.

יתרון Doconut App: ערכת הפיתוח מטפלת בהצפנה ובניקוי עבורכם, כך שלא תצטרכו לכתוב קוד קריפטוגרפי מותאם אישית או לדאוג לקבצים יתומים.

3. הטמעת רכיב המציג ב‑ASP.NET Core, MVC או WebForms

עם החלק האחורי מוכן, אתחלו את המציג באמצעות המשאבים וה‑API המתועדים לגרסה המותקנת של Doconut.

3.1 הוספת חבילת JavaScript

ב‑layout המשותף שלכם, כללו רק את משאבי המציג המתוארים בתיעוד המתאים לגרסה המותקנת של SDK. אל תתבססו על שמות חבילות קבועים או מיקומים שונים בין גרסאות.

3.2 יצירת תצוגת Razor ל‑Core/MVC

הוסיפו תצוגה (למשל, Views/Document/View.cshtml) הכוללת קלט קובץ, אלמנט מכולה עבור המציג, וסקריפט קטן שמעלה את הקובץ שנבחר, מקבל את האסימון המאובטח, ומאתחל את וידג׳ט Doconut Viewer.

הסקריפט צריך:

ללכוד את הקובץ שנבחר מהאלמנט <input type="file">.
לשלוח את הקובץ לנקודת הקצה של ההעלאה באמצעות fetch או XMLHttpRequest.
כאשר מתקבלת תגובה מורשית, לאתחל את המציג באמצעות ה‑API הנתמך לגרסה המותקנת.

3.3 מקבילה ל‑WebForms

ב‑דף WebForms (למשל, DocumentViewer.aspx), הציבו פקד asp:FileUpload, כפתור להפעלת ההעלאה, ו‑<div> שיארח את המציג. בקוד‑מאחורי, קראו לשירות Doconut כדי לאחסן את הקובץ שהועלה, לקבל את האסימון, ולרשום סקריפט אתחול שמקרא לפונקציית JavaScript (initViewer(token)) ליצירת מופע המציג.

יתרון Doconut App: וידג׳ט JavaScript אחד, שלושה מודלים של UI ב‑.NET, אפס ספריות נוספות. פשטות במיטבה.

4. התאמת המציג לניהול מסמכים

מתוך הקופסה, Doconut Viewer מספק סרגל כלים נקי, פקדי זום, והחלפת נושא אור/חשוך. ניתן להתאים את הממשק למותג שלכם ולסוגי מסמכים ספציפיים.

4.1 תצורת סרגל הכלים

בעת אתחול המציג, ניתן לציין אילו פריטי סרגל כלים יהיו גלויים (למשל, download, print, zoomIn, zoomOut, fullScreen). הסרת כפתור download, לדוגמה, מונעת מהמשתמשים לשמור את הקובץ המקורי.

4.2 נושא וצבעים

הגדירו את האפשרות theme ל‑'dark' או 'light' ובאופן אופציונלי ספקו primaryColor המתאים לפלטת הצבעים של החברה שלכם. המציג מכבד משתני CSS, ומאפשר עיצוב עמוק יותר באמצעות גיליון סגנון מותאם.

4.3 כלי CAD ייעודיים

אם אתם מציגים קבצי DWG, DXF או DGN, הפעילו את אפשרויות CAD enableMeasurement ו‑enableLayerToggle. זה מוסיף כלי מדידת מרחק, זווית ושטח וכן פאנל נראות שכבות ישירות בסרגל הכלים.

4.4 לוקליזציה

העבירו קוד locale (למשל, 'fr' לצרפתית) בעת האתחול. כל מחרוזות הממשק, טיפים והודעות שגיאה יוצגו בשפה שנבחרה.

למה להתאים? Doconut App מאפשר לכם לשמור על מראה המציג כהרחבה טבעית של האתר שלכם תוך שמירה על חוויית צפייה מאובטחת וללא תוספים.

5. בדיקת האינטגרציה לכל הפורמטים הנתמכים

לפני העלייה לאוויר, הריצו בדיקת תקינות מהירה לכל סוג קובץ שאתם מצפים שהמשתמשים שלכם יצפו בו. באמצעות המציג של Doconut App, פתחו קובץ דוגמה של כל פורמט וודאו שהרינדור, הניווט וכל כלי המיוחדים פועלים כפי שמתואר.

פורמט	תרחיש בדיקה	תוצאה צפויה
PDF	דוח גדול מרובה עמודים עם תמונות משובצות	גלילה חלקה, זום, והצגת צבעים מדויקת
DOCX	מסמך Word עם טבלאות והערות שוליים	כל הטקסט, הטבלאות וההערות נראים; אין שינוי פריסה
XLSX	גליון אלקטרוני עם גרפים	הגרפים מוצגים כגרפיקה וקטורית; הזום שומר על חדות
PPTX	מצגת שקפים עם תצוגה מקדימה סטטית	השקף הראשון מוצג כראוי; אין משאבים שבורים
DWG	שרטוט טכני עם שכבות מרובות	אפשרות החלפת שכבות, מדידות פועלות, הקווים נשארים חדים
PSD	קובץ Photoshop עם שכבות	השכבות נראות, הצבעים מדויקים, הזום נשאר חד
SVG	גרפיקה וקטורית עם גרדיאנטים	הגרדיאנטים מוצגים בצורה חלקה; הזום נשאר חד
TIFF	סריקה ברזולוציה גבוהה	התמונה נטענת במהירות; הזום מגלה פרטים

הרצת רשימת הבדיקה הזו עם Doconut App מבטיחה שכל פורמט נתמך יתנהג באופן אמין עבור המשתמשים שלכם.

סיכום

הטמעת מציג מסמכים מאובטח וללא תוספים הפכה כעת לפשוטה עם Doconut App. על‑ידי ביצוע הצעדים שלמעלה — התקנת ערכת הפיתוח, קונפיגורציית העלאות מוצפנות, הטמעת וידג׳ט JavaScript הקל, והתאמת הממשק — תוכלו לספק רינדור מסמכים מהיר ואיכותי ביישומי ASP.NET Core, MVC ו‑WebForms.

מוכנים להעריך זאת? התחילו ב‑דף ההורדה והתיעוד הרשמי של Doconut, ולאחר מכן בדקו את ערכת הפיתוח במסגרת סקירת האבטחה זהה לזו של שאר היישום שלכם מבוסס Windows‑ASP.NET.