💡 דוגמה מלאה עובדת זמינה ב‑GitHub:
secure-untrusted-document-upload-conversion-dotnet
האתגר של חשבונות לשלם: למה המרת העלאות של ספקים מתקלקלת בקנה מידה
השרת שלך ממיר את החשבונית; ה‑HTML של הספק מחליט מה הוא קורא בנוסף. המרת העלאה בטוחה של ספק עם GroupDocs.Conversion עבור .NET ממירה קובץ שהועלה ל‑PDF מבלי לאפשר להפניות של הקובץ עצמו לבחור מה השרת שלך ימשוך או יקרא הלאה.
פורטל חשבוניות של ספק מאפשר לכל ספק מאושר להעלות חשבונית – בדרך כלל כ‑HTML או PDF, לפעמים עם ציור SVG מצורף לפריט של מתקנים או בנייה – והמערכת של חשבונות לשלם ממירה אותה ל‑PDF לצורך ארכיב והפצת אישורים. ה‑HTML נכתב על ידי הספק, לא על ידי הצוות שלך, והוא יכול להפנות לכל דבר שדף אינטרנט יכול להפנות אליו: גיליון סגנונות, סקריפט, תמונה המתארחת ב‑CDN של הספק, או – אם חשבון הספק נפרץ – כתובת שלעולם לא הייתה אמורה להיות נגישה מהרשת שלך.
נפח הספקים רק גדל. כאשר הוא עובר ממספר ספקים בודדים למאות, תיקיית ההעלאות שהייתה פעם מכילה קבצים של חברה אחת עכשיו מכילה את כולם – והפנייה לתמונה יחסית בתוך חשבונית של ספק אחד יכולה להסתיים בקובץ ששייך לספק אחר היושב בדיוק לידו.
מה שהצוות של חשבונות לשלם באמת צריך אינו כלל חוק חומת אש ברשת, אלא שלב המרה שמטפל בכל הפנייה בתוך העלאה כלא מהימנה כברירת מחדל, מאפשר נכס שנבדק כמו לוגו של ספק לעבור במודע, ומדווח בכישלון רועש – ולא בשקט – כאשר ערך ברשימת ההיתר נכתב בצורה שגויה.
בדיקת מציאות: תג
<img>אחד שמפנה ל‑
http://169.254.169.254/latest/meta-data/iam/security-credentials/מבקש מהשרת הממיר לקרוא את שירות המטא‑דאטה של הענן – בקשה שהמעלה לעולם לא יכל לבצע מבחוץ. זהו זיוף בקשת צד‑שרת, והעלאת HTML היא כל מה שנדרש.
למה תיקונים כלליים לא סוגרים פער זה
צוותי חשבונות לשלם בדרך כלל פונים לאחת מהאפשרויות הבאות לפני אימוץ ספריית המרה עם מדיניות משאבים משלה:
- חסימת יציאת רשת במארח ההמרה: עוצרת משיכה מרוחקת, אך אינה פותרת בעיית קובץ בתיקייה זהה שהפנייה היחסית יכולה לפתור – בדיוק מה שקורה כאשר העלאה מומרת ישירות מהנתיב השמור שלה.
- הסרת תגיות לפני ההמרה: שבירה בפני סוגי הפניות חדשים (
<link>, SVG<image>, CSS@import) וצריך לבצע ביקורת מחדש בכל פעם שהפורמט של ההעלאה משתנה. - הסתמכות על סורק ההעלאות של פורטל הספק: סורק לחתימות נוזקה, לא על כתובת URL שמפנה לתשתית שלך.
GroupDocs.Conversion סוגר פער זה בנקודה החשובה ביותר: ברגע שהמסמך נטען להמרה, לפני שנוצר כל פלט.
הפתרון: GroupDocs.Conversion בתהליך חשבונית ספק
GroupDocs.Conversion עבור .NET 26.10 דוחה משאבים חיצוניים כברירת מחדל דרך SkipExternalResources, מאפשר לך לציין במדויק את המיקומים שאתה סומך עליהם דרך WhitelistedResources, ומספק לך קריאת חוזר לכל משאב דרך IExternalResourceHandler שיכולה לאשר, לעקוף או לספק את הבייטים של המשאב ישירות – כך שלוגו ספק שנבדק עדיין יכול להופיע ב‑PDF ללא בקשת רשת.
כדי לעקוב אחרי המימוש למטה, תזדקק ל‑:
- .NET 8.0 או גרסה מאוחרת יותר
- GroupDocs.Conversion עבור .NET (קבל ניסיון חינם)
- קובץ HTML או SVG לדוגמה שאתה לא שולט בו
dotnet add package GroupDocs.Conversion --version 26.10.0
מימוש שלב המרת העלאה של ספק צעד אחר צעד
הדוגמה למטה ממפה לתרחיש פורטל ספק אמיתי: המרת חשבונית שהועלתה (invoice-upload.html) שמפנה ללוגו, כתובת פנימית, קובץ מקומי וקובץ היושב לידו.
רוב הקטעים למטה מעבירים אובייקט ResourceAudit – IExternalResourceHandler קטן שרושם כל החלטת טעינה ויכול לספק את הבייטים של נכס מהימן. הקוד המלא שלו נמצא ב‑Program.cs של מאגר הדוגמה.
שלב 1 – טעינה והמרה מהנתיב השמור של ההעלאה
זהו האופן שבו פורטל עשוי להמיר העלאה מייד לאחר שמירתה בתיקייה משותפת – והשלב שבו קובץ שכני יכול לדלוף פנימה.
var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(uploadPath, (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
טעינה ישירה מ‑uploadPath מציבה את כל תיקיית החשבונית בטווח, ולא רק את הקובץ היחיד בתוכה. הטווח, ולא האמון, מחליט מה נטען. בריצה זו, כל הפנייה מרוחקת ו‑file:/// בחשבונית נחסמת, אך other-customer-signature.svg – קובץ שונה שנשמר באותה תיקייה – נטען, מכיוון ש‑SkipExternalResources חוץ רק הפניות מחוץ לתיקייה ההיא.
שלב 2 – קונפיגורציה לדרישות העלאות של ספקים
להעלאות של ספקים, הסר לחלוטין את תיקיית הבסיס על‑ידי טעינה מ‑stream במקום מ‑path:
var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
מדוע הגדרה זו חשובה לפורטלי ספקים:
- קלט מ‑Stream: מסמך שמומר מ‑stream אין לו תיקייה, ולכן הפנייה יחסית בתוכו אינה יכולה להסתיים בקובץ של ספק אחר.
ExternalResourceHandler: עדיין פועל עבור כל משאב, כך שאתה שומר רישום מדויק של מה שכל העלאת ספק ביקשה.
שלב 3 – ביצוע ותפיסת נכס שנבדק
לוגו של ספק הוא אחת ההפניות שאולי תרצה לשמור – מסופק מהעתק שאתה שולט בו, ולא נמשך מ‑URL של הספק עצמו:
var trustedAssets = new Dictionary<string, byte[]>
{
[assetUrl] = File.ReadAllBytes(assetPath)
};
var audit = new ResourceAudit(trustedAssets);
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
המתאם של ResourceAudit בודק את ה‑URL המבוקש מול מילון של נכסים מהימנים; כאשר יש התאמה, הוא מגדיר את ExternalResourceLoadingArgs.Data לבייטים מקומיים ואת Skipped ל‑false, כך שהלוגו מופיע ב‑PDF בעוד חמשת ההפניות האחרות של החשבונית נשארות חסומות.
שלב 4 – דחיית ערך ברשימת ההיתר שהוגדר בצורה שגויה מוקדם
ערך ברשימת ההיתר שהוא רק שם מארח, ולא קידומת URI מוחלטת, גורם לכישלון ההמרה במקום להתאים בשקט יותר מדי:
var loadOptions = new WebLoadOptions
{
WhitelistedResources = new List<string> { entry }
};
try
{
using var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions);
converter.Convert(outputPath, new PdfConvertOptions());
return null;
}
catch (InvalidLoadOptionsException exception)
{
return exception.Message;
}
העברת cdn.example.com במקום https://cdn.example.com/brand/ זורקת InvalidLoadOptionsException עם ההודעה:
Whitelisted resource 'cdn.example.com' is not valid. Expected an absolute URI prefix without a query, fragment or encoded '/', '\' or '.', such as 'https://cdn.example.com/assets/' or 'file:///C:/assets/'.
תפיסה של שגיאה זו בזמן ההמרה, בביקורת תצורה או בבדיקה בזמן אתחול, זולה בהרבה מגילוי של משאב שהותאם באופן שגוי בייצור. תפסו אותה לפני שהיא נשלחת.
למה ערך ברשימת ההיתר של URL עלול להידחות?
WhitelistedResources מקבל רק קידומות URI מוחלטות, כגון https://cdn.example.com/brand/ או file:///C:/assets/. גרסאות קודמות התאימו ערך לכל מקום שבו הוא הופיע ב‑URL, ולכן cdn.example.com התאימה גם לכתובת של תוקף שהכילה רק את המילים האלו. מאז גרסה 26.10 ערך זה נכשל בטעינה עם InvalidLoadOptionsException, והשיטה האחרונה של הדוגמה מדפיסה את ההודעה המדויקת.
קבצי SVG מצורפים של ספקים נושאים את אותו סיכון
ציור מתקנים שמצורף לחשבונית בנייה הוא עדיין קובץ SVG, והוא עובר דרך SvgLoadOptions במקום WebLoadOptions. החוזה זהה, רק האלמנט שונה: ExternalResourceHandler חלים על הפניות <image> שלו באותו אופן שבו הוא חלה על תגיות <img> של החשבונית, וכל <script> משולב בציור אינו מתבצע:
var audit = new ResourceAudit();
var loadOptions = new SvgLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
זה בדיוק תרחיש החשבונית הבנייה מהפתיחה: ציור שנראה כמו תכנית קומה יכול עדיין לשאת הפנייה לנקודת המטא‑דאטה של הענן שלך, קובץ מקומי, או שרת של תוקף. בדוגמה העובדת שלושתם חסומים, והכיתוב מוצג בדיוק כפי שנצייר, מכיוון שהסקריפט המצורף אליו לעולם לא מתבצע.
התנהגות לפני ואחרי
| בדיקה | המרה ישירה מהנתיב השמור | גישה זו |
|---|---|---|
| קובץ שכני באותה תיקייה | נטען אוטומטית | חסום – קלט מ‑Stream מסיר את תיקיית הבסיס |
| לוגו ספק | חסום; ה‑PDF מציג רק את הטקסט החלופי | מסופק מקובץ מקומי שנבדק |
| מטא‑דאטה של ענן / כתובת פנימית | חסום כברירת מחדל | חסום כברירת מחדל |
| ערך ברשימת היתר של שם מארח בלבד | נדחה עם InvalidLoadOptionsException |
נדחה באותו אופן, נתפס בבדיקה בזמן אתחול |
| סקריפט משולב בהעלאה | אינו מתבצע | אינו מתבצע |
שתי שורות משתנות: הלוגו וקובץ השכן. קובץ השכן הוא מה שבדיקה ברמת הרשת לעולם לא תתפוס, מכיוון שאין בקשת רשת.
תרחישי מסמכי ספק נוספים שבהם זה רלוונטי
המאפיין ExternalResourceHandler קיים באפשרויות הטעינה של מספר פורמטים נוספים שהפורטלים של ספקים מקבלים לעיתים קרובות, ולכן הדפוס שלמעלה אינו מוגבל ל‑HTML ו‑SVG:
- קבצי Word או Excel שמוגשים על‑ידי ספק:
WordProcessingLoadOptionsו‑SpreadsheetLoadOptionsחושפים את אותו חוזה מתאם. - חשבוניות שנשלחות במייל:
EmailLoadOptionsחושף את אותו מתאם עבור התמונות המרוחקות שהגוף של האימייל מפנה אליהן. - דוחות כספיים בפורמט XBRL:
FinanceLoadOptionsמכסה הפניות טקסונומיות במסמכי XBRL שמוגשים על‑ידי ספקים.
התחלת עבודה עם צינור העלאות של ספקים
ראית כיצד GroupDocs.Conversion מטפל בהעלאות ספקים לא מהימנות בצורה בטוחה. הנה מה שעליך לעשות הלאה:
- התחל בחינם: קבל רישיון זמני כדי להסיר את מגבלות ההערכה
- קרא את מדיניות המשאבים המלאה: דילוג על טעינת משאבים חיצוניים מכסה
WhitelistedResources,IExternalResourceHandler, וטיפול בסקריפטים בפירוט - בדוק מה נוגע לרשת בכלל: גישה לרשת ופרטיות נתונים
- עקוב אחרי המדריך שלב‑אחר‑שלב: המרת העלאות לא מהימנות בבטחה – מקרה שימוש
- עיין בדוגמה העובדת: secure-untrusted-document-upload-conversion-dotnet ב‑GitHub