Az ügyfél által feltöltött fájlnév nem használható közvetlenül tárolási útvonalként: az útvonal bejárásának és a duplikált névlefedettség megakadályozására

A feltöltött fájl neve `../../report.pdf`, ami nem jelenti azt, hogy a szervernek ezen a néven kell mentenie. A fájlnév a felhasználótól származik, és a bemeneti adatokhoz tartozik; a lemez elérési útja a rendszerengedély-határhoz tartozik. A kettő összekeverése könnyen olyan problémákhoz vezethet, mint az útvonal bejárása, a névlefedettség duplikáltsága, valamint a Windows és a Linux közötti eltérő viselkedés.

Az, hogy a feltöltött fájl neve ../../report.pdf, nem jelenti azt, hogy a szervernek ezen a néven kell mentenie. A szerveroldali feltöltési funkciókat író fejlesztők, valamint a felhasználói fájlokkal foglalkozó csapatok, akiknek aggódniuk kell az útvonal bejárása és a duplikált névlefedettség miatt, szembesülnek ezzel a problémával. A cikk elolvasása után képes lesz megkülönböztetni a megjelenített neveket és a tárhelyneveket, tudni fogja, milyen ellenőrzéseket kell elvégezni az egyes rétegeknél, és áttekintheti saját megvalósítását az elfogadási tételek szerint.

A fájlnév a felhasználótól származik, és a bemeneti adatokhoz tartozik; a lemez elérési útja a rendszerengedély-határhoz tartozik. A kettő összekeverése könnyen olyan problémákhoz vezethet, mint az útvonal bejárása, a névlefedettség duplikáltsága, valamint a Windows és a Linux közötti eltérő viselkedés.

Ez a cikk szintetikus mintákat használ a feldolgozási módszer bemutatására. A kód mintaellenőrzésen esett át elszigetelt környezetben, és nem garantálja az összes valós fájlt vagy a termék teljesítményét. A fontos dokumentumok feldolgozása előtt kérjük, őrizze meg az eredeti példányokat és nézze át a szövegben szereplő határok és átvételi tételek szerint.

A feltöltött fájlnév közvetlenül használható tárolási útvonalként? Egy mondatos következtetés

Közvetlenül nem használható. A megjelenített név az interfész megjelenítésére szolgál, a tárolási útvonalat pedig a szerver hozza létre a belső azonosító alapján.

a helyzetedAjánlott gyakorlatokok
A felhasználó eredeti fájlnevét meg kell jeleníteni a felületenA megjelenített név csak megjelenítésre van fenntartvaA megjelenített név elválasztva a lemez elérési útjától az útvonal keresztezésének elkerülése érdekében
A feltöltött fájlokat menteni kellA szerver létrehoz egy belső azonosítót, és összekapcsolja a tárolási útvonalatKerülje a duplikált nevekkel történő felülírást, és ne befolyásolja a felhasználói bevitel
A fájlkiterjesztésnek részt kell vennie a tárolásbanVegye ki az utótagot a szerver engedélyezett listájábólNe másolja le a felhasználók által megadott kiterjesztéseket
Meg kell határozni a fájl valódi típusátVégezzen tartalomfelismerést és elemzéstA bővítmények hamisíthatók

A megjelenített név és a tárhely neve el van választva

Az eredeti név megmarad az interfész megjelenítésénél, de a belső azonosítást a szerver generálja. A tárolási utótagnak is a szerveroldali engedélyezett listából kell származnia, nem pedig a felhasználó által megadott kiterjesztést másolni.

A következő példa csak elérési utat hoz létre, könyvtárat vagy fájlt nem hoz létre.

Minimális útvonal-konstruktor

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)

Ez a példa feltételezi, hogy a belső azonosítót a szerver hozta létre. Ez nem egy biztonságos írási fájl megvalósítás tetszőleges lemeztámadási környezetekhez:

  • Verseny még előfordulhat az ellenőrzés és a tényleges nyitás között.
  • A szülőkönyvtár-engedélyeket és a szimbolikus hivatkozási házirendeket külön kell szabályozni.
  • Az egyedi azonosító nem jelenti azt sem, hogy figyelmen kívül hagyható a „nem felülbírálás"szabály.

A fájlnév-megtisztítás nem fájlhitelesítés

A fájlnév-tisztítás csak a probléma egy részét tudja megoldani, és a különböző jelenségeket különböző szinteken kell kezelni:

bemeneti jelenségMilyen szinten kell feldolgozni?hiányosságait
Útleválasztót tartalmazTárolási útvonalként nem használjákA perjel egyszerű eltávolítása nem elég
kiterjesztés PDFTartalomfelismerés és elemzésA bővítmények hamisíthatók
A megjelenített név HTML-t tartalmazAz interfész kimenet kilépA lemeznév megváltoztatásával nem lehet megoldani.
Ugyanaz a megjelenített névBelső azonosító szigetelésA korábbi feltöltést nem szabad felülírni

📊 Alapvető összehasonlítás

gyakorlatMit lehet megoldanihiányosságait
Használja közvetlenül a felhasználói fájl nevétA legegyszerűbb megvalósításElőfordulhat útkereszteződés és duplikált névlefedettség
Csak távolítsa el az útelválasztókatA bemenet feldolgozott részeA perjel egyszerű eltávolítása nem elég
A típus meghatározása kiterjesztés alapjánelőzetes megkülönböztetési fájlA bővítmények hamisíthatók, és tartalomészlelés szükséges.
Szerveroldali generált belső azonosítóAz azonos nevű fájlokat izolálja, az elérési utat a rendszer vezérliTovábbra is együtt kell működnie a „nem felülírható"házirenddel és a címtárengedély-vezérléssel

Az objektumtárolásnak is ugyanazok a határai

Az R2 vagy más objektumtárolók nem rendelkeznek a hagyományos címtárbejárás teljes szemantikájával, de az objektumkulcsok továbbra is hatással vannak az elkülönítésre, a felülírásokra és a szabadon elérhető URL-ekre.

  • Ne írja be közvetlenül a bérlő által megadott karakterláncot megosztott előtagba.
  • A letöltő csak a kulcsnév alapján nem tud jogosultságra következtetni.

A fájlnak azonosítóval kell rendelkeznie a fordítás bevitele előtt

Amikor csatlakozik a OmniDoc (termékportál) munkafolyamathoz, továbbra is ismerős fájlneveket jeleníthet meg a felhasználók számára, és belsőleg használhat független feladat- és fájlazonosítókat.

A tiszta dokumentumazonosság a következő előnyökkel jár:

  • Ha az újrapróbálkozás sikertelen, pontosan megfelelhet az eredeti feladatnak.
  • A fordítási kézirat letöltése és az azt követő felülvizsgálat megfelelhet a megfelelő fájlnak.
  • Csökkentse annak kockázatát, hogy valaki más fájlját az aktuális eredménnyel azonos néven kezelje.

🎯 Melyik módszer illik hozzád?

Ha meg kell jelenítenie a fájl nevét

A felhasználó eredeti megjelenített neve megmarad, de csak az interfészhez használható, a lemez elérési útjához nem.

Ha el kell mentenie a feltöltött fájlt

A belső azonosítót a szerver állítja elő, az utótagot az engedélyezett listából veszi, és a lefedettséget és a címtárengedélyeket a tényleges házirendnek megfelelően szabályozza.

Ha objektumtárolást használ

Ne írja be közvetlenül a bérlői karakterláncot egy megosztott előtagba, és a letöltés során hozzon külön engedélyezési döntéseket.

❓ Gyakran Ismételt Kérdések (GYIK)

1. Ha eltávolítja a perjelet, biztonságos lesz a fájlnév?

nem elég. Csak a perjelek eltávolítása csak a bemenet egy részét tudja feldolgozni, és az elérési út-építést, a felülírást és a fájltípus meghatározását továbbra is külön kell feldolgozni.

2. Csak azért, mert a kiterjesztés PDF, az azt jelenti, hogy PDF?

nem lehet. A bővítmények hamisíthatók, és tartalomfelismerést és elemzést igényelnek.

3. Mi a teendő, ha a megjelenített név HTML-t tartalmaz?

Escape interfész kimenet közben nem oldható meg a lemezen lévő fájlnév módosításával.

4. Egyedi azonosító használata után továbbra is le kell tiltanom a felülírást?

igény. Az egyedi azonosító nem jelenti azt, hogy a „nincs felülbírálás"irányelv figyelmen kívül hagyható.

📝 Összefoglaló

A feltöltött fájl nevét a tárolási útvonaltól elkülönítve kell kezelni: a megjelenített név a megjelenítésre szolgál, a tárolási útvonalat pedig a szerver generálja a belső azonosító alapján. Az elérési út, a lefedettség, a típus és a jogosultság mindegyike függetlenül ellenőrzött.

Próbálja ki most: Töltse fel a dokumentumot a fordítás megkezdéséhez, megtartva az eredeti elrendezést

Források: Python pathlib

Frissítve: 2026-11-16