Názov súboru nahraný zákazníkom nemožno priamo použiť ako cestu k úložisku: aby sa zabránilo prechodu cesty a pokrytiu duplicitným názvom
Odovzdaný súbor sa nazýva `../../report.pdf`, čo však neznamená, že ho server má uložiť pod týmto názvom. Názov súboru pochádza od používateľa a patrí medzi vstupné údaje; cesta k disku patrí k hranici systémových povolení. Zámena týchto dvoch môže ľahko viesť k problémom, ako je prechod cesty, pokrytie duplicitných mien a odlišné správanie medzi systémami Windows a Linux.
To, že sa nahraný súbor volá ../../report.pdf, neznamená, že ho server má uložiť pod týmto názvom. S týmto problémom sa stretnú vývojári, ktorí píšu funkcie nahrávania na strane servera, ako aj tímy, ktoré sa musia zaoberať používateľskými súbormi a obávať sa prechodu cesty a pokrytia duplicitných mien. Po prečítaní tohto článku budete schopní rozlišovať medzi zobrazovanými názvami a názvami úložiska, vedieť, aké kontroly by sa mali vykonať na každej vrstve, a skontrolovať svoju vlastnú implementáciu podľa akceptačných položiek.
Názov súboru pochádza od používateľa a patrí medzi vstupné údaje; cesta k disku patrí k hranici systémových povolení. Zámena týchto dvoch môže ľahko viesť k problémom, ako je prechod cesty, pokrytie duplicitných mien a odlišné správanie medzi systémami Windows a Linux.
Tento článok používa syntetické vzorky na demonštráciu spôsobu spracovania. Kód bol vzorovo skontrolovaný v izolovanom prostredí a nie je zárukou všetkých skutočných súborov alebo výkonu produktu. Pred spracovaním dôležitých dokumentov si uschovajte originály a skontrolujte ich podľa hraníc a akceptačných položiek v texte.
Môže byť nahraný názov súboru priamo použitý ako cesta k úložisku? Záver jednou vetou
Nedá sa použiť priamo. Zobrazovaný názov sa používa na zobrazenie rozhrania a cestu úložného priestoru generuje server na základe interného ID.
| vaša situácia | Odporúčané postupy | dôvod |
|---|---|---|
| Na rozhraní musí byť zobrazený pôvodný názov súboru používateľa | Zobrazovaný názov vyhradený len na zobrazenie | Zobrazovaný názov oddelený od cesty disku, aby sa zabránilo kríženiu cesty |
| Je potrebné uložiť nahrané súbory | Server vygeneruje interné ID a spojí cestu úložného priestoru | Vyhnite sa prepísaniu duplicitného mena a nie sú ovplyvnení vstupom používateľa |
| Prípona súboru sa musí podieľať na ukladaní | Vezmite príponu zo zoznamu povolených serverov | Nekopírujte rozšírenia poskytnuté používateľmi |
| Je potrebné určiť skutočný typ súboru | Vykonajte detekciu a analýzu obsahu | Rozšírenia môžu byť sfalšované |
Zobrazovaný názov a názov úložiska sú oddelené
Pôvodný názov sa zachová pre zobrazenie rozhrania, ale internú identifikáciu generuje server. Prípona úložiska by tiež mala pochádzať zo zoznamu povolených na strane servera, a nie kopírovať rozšírenie poskytnuté používateľom.
Nasledujúci príklad vytvára iba cestu a nevytvára adresár ani súbor.
Konštruktor minimálnej cesty
from pathlib import Path
import re
def storage_path(root, internal_id, extension):
if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
raise ValueError("invalid internal id")
if extension not in {".pdf", ".docx", ".udoc"}:
raise ValueError("unsupported extension")
base = Path(root).resolve()
candidate = (base / (internal_id + extension)).resolve()
if candidate.parent != base:
raise ValueError("outside storage root")
return candidate
root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
try:
storage_path(root, bad, ".pdf")
except ValueError:
pass
else:
raise AssertionError(bad)
Tento príklad predpokladá, že interné ID vygeneroval server. Nejde o bezpečnú implementáciu súborov na zápis pre prostredia s ľubovoľným útokom na disk:
- Medzi kontrolou a skutočným otvorením môže stále dôjsť k pretekom.
- Povolenia nadradeného adresára a zásady symbolických odkazov musia byť riadené oddelene.
- Jedinečné ID tiež neznamená, že zásadu „bez prepísania"možno ignorovať.
Dezinfekcia názvu súboru nie je overenie súboru
Čistenie názvu súboru môže vyriešiť len časť problému a rôzne javy je potrebné riešiť na rôznych úrovniach:
| vstupný jav | Na akej úrovni by mal byť spracovaný? | nedostatky |
|---|---|---|
| Obsahuje oddeľovač cesty | Nepoužíva sa ako úložná cesta | Jednoduché odstránenie lomky nestačí |
| rozšírenie PDF | Detekcia a analýza obsahu | Nástavce je možné kovať |
| Zobrazovaný názov obsahuje HTML | Výstup rozhrania uniká | Nedá sa to vyriešiť zmenou názvu disku. |
| Rovnaký zobrazovaný názov | Vnútorná izolácia ID | Predchádzajúce nahrané súbory by sa nemali prepísať |
📊 Základné porovnanie
| prax | Čo sa dá vyriešiť | nedostatky |
|---|---|---|
| Použite priamo názov používateľského súboru | Najjednoduchšia implementácia | Môže sa vyskytnúť kríženie cesty a pokrytie duplicitných mien |
| Stačí odstrániť oddeľovače cesty | Spracovaná časť vstupu | Jednoduché odstránenie lomky nestačí |
| Určte typ na základe rozšírenia | predbežný diferenciačný súbor | Rozšírenia je možné sfalšovať a vyžaduje sa detekcia obsahu. |
| Interné ID generované na strane servera | Izolujte súbory s rovnakým názvom, cestu riadi systém | Stále je potrebné spolupracovať s politikou „bez prepisovania"a kontrolou povolení adresára |
Ukladanie objektov má tiež rovnaké hranice
R2 alebo iné úložiská objektov nemajú plnú sémantiku tradičného prechodu cez adresár, ale kľúče objektu stále ovplyvňujú izoláciu, prepisy a odhalené adresy URL.
- Nepíšte priamo reťazec poskytnutý nájomcom do zdieľanej predpony.
- Sťahovač nemôže odvodiť autorizáciu len na základe názvu kľúča.
Súbor by mal mať pred zadaním prekladu identitu
Keď sa pripájate k pracovnému postupu OmniDoc (produktový portál), môžete používateľom naďalej zobrazovať známe názvy súborov a interne používať nezávislé ID úloh a ID súborov.
Jasná dokumentárna identita prináša tieto výhody:
- Keď opakovaný pokus zlyhá, môže presne zodpovedať pôvodnej úlohe.
- Stiahnutie rukopisu prekladu a následná kontrola môže zodpovedať správnemu súboru.
- Znížte riziko zaobchádzania so súborom niekoho iného s rovnakým názvom, ako má aktuálny výsledok.
🎯 Ktorá metóda je pre vás vhodná?
Ak potrebujete zobraziť názov súboru
Pôvodné zobrazované meno používateľa sa zachová, ale používa sa len pre rozhranie, nie pre cestu k disku.
Ak potrebujete uložiť nahraný súbor
Interné ID vygeneruje server, prevezme príponu zo zoznamu povolených a riadi pokrytie a oprávnenia adresára podľa aktuálnej politiky.
Ak používate ukladanie objektov
Nepíšte reťazec nájomníka priamo do zdieľanej predpony a pri sťahovaní urobte samostatné rozhodnutia o autorizácii.
❓ Často kladené otázky (FAQ)
1. Ak sa lomka odstráni, bude názov súboru bezpečný?
nestačí. Iba odstraňovanie lomítok môže spracovať iba časť vstupu a konštrukciu cesty, prepisovanie a určenie typu súboru je stále potrebné spracovávať samostatne.
2. Len preto, že rozšírenie je PDF, znamená to, že je to PDF?
nemôže. Rozšírenia môžu byť sfalšované a vyžadujú detekciu a analýzu obsahu.
3. Čo mám robiť, ak zobrazovaný názov obsahuje HTML?
Únik počas výstupu rozhrania nie je možné vyriešiť úpravou názvu súboru na disku.
4. Musím aj po použití jedinečného ID zakázať prepisovanie?
potrebu. Jedinečné ID neznamená, že zásadu „bez prepísania"možno ignorovať.
📝 Zhrnutie
S nahraným názvom súboru by sa malo zaobchádzať oddelene od cesty úložiska: zobrazovaný názov sa používa na zobrazenie a cestu k úložisku generuje server na základe interného ID. Cesta, pokrytie, typ a autorizácia sú nezávisle overené.
Skúste to teraz: Odovzdajte dokument a spustite preklad, pričom sa zachová pôvodné rozloženie
Zdroje: Python pathlib


