מדריך: הטמעה מאובטחת של מציג Doconut עם React – מקצה לקצה
הטמעת מציג מסמכים בצורה מאובטחת דורשת יותר מהעתקת קטע קוד middleware לתוך אפליקציית ASP.NET Core. האינטגרציה חייבת להגדיר גבולות ברורים לאימות, גישה למסמכים, ניהול סשנים, רינדור, אנוטציות, חיפוש, הדפסה ורישום אירועי ביקורת.
ארגונים הבונים פורטלים ממוקדי מסמכים—כגון DMS, CRM, סקירת משפטית או יישומי שרטוט הנדסי—גם צריכים לשמור על הקבצים המקוריים מאחורי גבול האפליקציה. Doconut תומך במודל צפייה בצד השרת עבור מסמכי PDF, Office, CAD ותמונות, בעוד שממשק React יכול לספק את חוויית המשתמש.
המדריך הזה מתמקד בארכיטקטורה אמינה ובכוונה נמנע מציון שמות חבילות, מאפייני אפשרויות, חתימות מתודות ונתיבי קצה שעלולים להשתנות בין גרסאות SDK. השתמש בתיעוד הרשמי המתאים לגרסת הרישיון שלך לקבלת פרטי הרישום וה‑API המדויקים.
1️⃣ שלב 1 – הכנת פרויקטי ASP.NET Core ו‑React
לפני כתיבת קוד, ודא שסביבת הפיתוח שלך עומדת בדרישות הבסיסיות:
| דרישה | גרסה מומלצת |
|---|---|
| סביבת ריצה של .NET | .NET 6 או מאוחר יותר |
| ASP.NET Core | 6.0+ |
| IDE | סביבת פיתוח .NET נתמכת |
| חזית (אופציונלי) | יישום React תואם לפרויקט שלך |
- צור פרויקט Web API חדש של ASP.NET Core
dotnet new webapi -n DocPortal
cd DocPortal
-
הוסף את תלויות Doconut המורשות – השג את שמות החבילות המדויקים, הגרסאות, התלויות הטבעיות והוראות טעינת הרישיון מהתיעוד הרשמי עבור גרסת Doconut שלך. אל תניח שחבילה או עטיפה המופיעה במדריך שאינו רלוונטי חלה על הגרסה שלך.
-
הכן את יישום ה‑React – אם המציג יוצג דרך React, השתמש בהגדרת החזית שכבר אושרה על‑ידי הצוות שלך. שמור את יישום ה‑React תלוי ב‑API המאומת שלך ולא במעטפות צד שלישי לא מתועדות.
-
בצע מחויבות של המצב הראשוני – רוב צוותי הארגון מחייבים מדיניות Git הדורשת מחויבות חתומה לכל שינוי המשפיע על רישוי או הגדרות אבטחה.
כעת יש לך פתרון נקי מוכן לאינטגרציית ה‑server של Doconut המתועדת.
2️⃣ שלב 2 – קונפיגורציית האינטגרציה בשרת בצורה בטוחה
רשום את המציג באמצעות ההוראות המסופקות עבור גרסת Doconut המדויקת בפרויקט שלך. סדר ה‑middleware, רישומי השירותים, אתחול הרישיון ושמות מאפייני הקונפיגורציה הם פרטים ספציפיים לגרסה ולא יש להעתיקם מדוגמאות לא מאומתות.
ללא קשר לגרסת SDK, על אפליקציית ASP.NET Core הסובבת לאכוף את הבקרות הבאות:
- אימות לפני פתיחת מסמך – סשן מציג לעולם לא צריך לעקוף את שכבת הזהות של האפליקציה.
- פתרון מזהי מסמכים בשרת – קבל מזהה מסמך ברמת האפליקציה, לא נתיב קובץ פיזי שסופק על‑ידי הדפדפן.
- אישור לכל פעולה – צפייה, אנוטציה, חיפוש, הורדה והדפסה עשויים לדרוש הרשאות שונות.
- שמירת סודות מחוץ לבקרת גרסאות – אחסן רישיונות, מחרוזות חיבור וחומרי הצפנה במנגנון ניהול סודות המאושר.
- הגבלת בקשות – קבע מגבלות העלאה, גודל מסמך, זמן קצוב וקצב סביב זרימת העבודה של המציג.
- רישום אירועי אבטחה – תעד החלטות גישה ופעולות על מסמכים מבלי לכתוב את תוכן המסמך או אסימונים רגישים ללוגים.
התייחס לכל הגדרות SDK כהגדרות גרסה. אמת את משמעותן במקור הרשמי לפני הפעלתן בייצור.
3️⃣ שלב 3 – בידוד סשני מסמכים מאחורי שירות אפליקציה
החזק אינטראקציות ספציפיות ל‑Doconut בתוך שירות אפליקציה ייעודי. הפניות למחלקת Viewer שימושיות ברמת האדריכלות, אך חתימות קונסטרוקטור, מתודות פתיחת מסמך, דרישות מטמון והתנהגות גילוי רישיון חייבות לבוא מהתיעוד של הגרסה המותקנת שלך.
שירות מאובטח צריך:
- לקבל משתמש מאומת ומזהה מסמך ברמת האפליקציה.
- לבדוק את ההרשאה של המשתמש לפעולה המבוקשת.
- לאתר את המסמך מאחסון צד‑שרת מאושר.
- לבקש מ‑API המציג המתועד להקים סשן מסמך.
- להחזיר רק את המידע האופקי המינימלי הדרוש ללקוח.
- לשחרר או לפוג סשנים בהתאם למדיניות השמירה והמטמון שלך.
הדפדפן לעולם לא צריך לקבל נתיב אחסון פיזי, נתוני רישיון, מפתח מטמון פנימי או הפניה בלתי מוגבלת למסמך המקורי.
4️⃣ שלב 4 – הפעלת אנוטציות, חיפוש והדפסה מבוקרת
אנוטציות, חיפוש, OCR והדפסה מבוקרת צריכים להיות מופעלים רק כאשר הם נכללים בתצורת Doconut המורשית שלך ותומכים בגרסה המותקנת. אל תניח שמות מתודות, פורמטים של שמירה או מחלקות אפשרויות.
- אנוטציות – החלט אילו תפקידים יכולים ליצור, לערוך, לצפות או למחוק סימונים. שמור את מצב האנוטציות בהתאם להנחיות השמירה של גרסת SDK שלך ולדרישות הביקורת הפנימיות.
- חיפוש ו‑OCR – קבע אילו סוגי מסמכים דורשים OCR, היכן נשמר הטקסט המופק וכמה זמן נשמרים האינדקסים. התייחס לתוצאות החיפוש כנתוני מסמך ואשר אותן בהתאם.
- הדפסה מבוקרת – הגדר מגבלות עמודים, מדיניות סימן מים, כללי אישור ואירועי ביקורת ברמת האפליקציה, ולאחר מכן מפת את הדרישות ליכולות ההדפסה המתועדות.
שמור על פעולות אלו מאחורי אותו שירות אפליקציה המשמש לסשני מסמכים כך שהבקרות יישארו רזות והכללים העסקיים יישארו ניתנים לבדיקה.
5️⃣ שלב 5 – חיבור חזית ה‑React
יישום ה‑React צריך לקרוא ל‑API המאומת של ASP.NET Core שלך במקום לקבל נתיבי אחסון או להתחבר ישירות לשירותי המסמכים הפנימיים. הגדר חוזה API מבוסס משאבים משלי סביב פעולות עסקיות והימנע מפרסום שמות קצה של SDK כחלק מהחוזה הציבורי של הלקוח.
סדרת אינטראקציה טיפוסית היא:
- המשתמש בוחר מסמך שכבר גלוי באפליקציה.
- React מבקש סשן צפייה באמצעות מזהה המסמך ברמת האפליקציה.
- ASP.NET Core מאמת את הבקשה, מאשר את המסמך ומתאם את סשן המציג.
- React מקבל רק את המידע הדרוש להצגת המציג.
- בקשות אנוטציה, חיפוש והדפסה חוזרות דרך API האפליקציה המאומת.
- השרת מתעד אירועי ביקורת ומפוג את הסשן במועד המתאים.
ב‑UI של React, שמור על מצב סשן קצר‑טווח, טיפול מפורש בכישלונות הרשאה, הימנע מהצבת ערכים רגישים באחסון קבוע של הדפדפן, וספק מצבי טעינה ושגיאה שאינם חושפים נתיבים פנימיים או פרטי חריגה.
הפרדה זו משאירה את הרינדור ובקרות המסמך בשרת בעוד ש‑React אחראי על הצגת הממשק והאינטראקציה.
סיכום
על‑ידי הצבת אינטגרציית Doconut מאחורי שירות אפליקציה מאובטח ב‑ASP.NET Core, ניתן לבנות פורטל מסמכים עבור PDF, Office, CAD ותמונות ללא קישור ישיר של ממשק React לפרטים בלתי מתועדים של SDK. אימות, הרשאה, מחזור חיי סשן, חיפוש, אנוטציה, הדפסה ומדיניות ביקורת נשארים חלקים מפורשים בתכנון האפליקציה שלך.
מוכן להעריך את Doconut עבור פרויקט .NET שלך? השתמש בחבילה הרשמית, ברישיון ובתיעוד ה‑API של הגרסה שנבחרה, ולאחר מכן יישם את רשימת הבדיקה של הארכיטקטורה והאבטחה שלמעלה במימוש שלך.