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áciaOdporúčané postupydôvod
Na rozhraní musí byť zobrazený pôvodný názov súboru používateľaZobrazovaný názov vyhradený len na zobrazenieZobrazovaný názov oddelený od cesty disku, aby sa zabránilo kríženiu cesty
Je potrebné uložiť nahrané súboryServer vygeneruje interné ID a spojí cestu úložného priestoruVyhnite 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 serverovNekopírujte rozšírenia poskytnuté používateľmi
Je potrebné určiť skutočný typ súboruVykonajte detekciu a analýzu obsahuRozší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ý javNa akej úrovni by mal byť spracovaný?nedostatky
Obsahuje oddeľovač cestyNepoužíva sa ako úložná cestaJednoduché odstránenie lomky nestačí
rozšírenie PDFDetekcia a analýza obsahuNástavce je možné kovať
Zobrazovaný názov obsahuje HTMLVýstup rozhrania unikáNedá sa to vyriešiť zmenou názvu disku.
Rovnaký zobrazovaný názovVnútorná izolácia IDPredchá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úboruNajjednoduchšia implementáciaMôže sa vyskytnúť kríženie cesty a pokrytie duplicitných mien
Stačí odstrániť oddeľovače cestySpracovaná časť vstupuJednoduché odstránenie lomky nestačí
Určte typ na základe rozšíreniapredbežný diferenciačný súborRozšírenia je možné sfalšovať a vyžaduje sa detekcia obsahu.
Interné ID generované na strane serveraIzolujte súbory s rovnakým názvom, cestu riadi systémStá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

Aktualizované 2026-11-16