Naziv datoteke koji je učitao kupac ne može se izravno koristiti kao staza za pohranu: kako bi se spriječilo prolaženje staze i dvostruka pokrivenost naziva

Učitana datoteka se zove `../../report.pdf`, što ne znači da je poslužitelj treba spremiti pod tim imenom. Naziv datoteke dolazi od korisnika i pripada ulaznim podacima; put diska pripada granici dopuštenja sustava. Brkanje to dvoje može lako dovesti do problema kao što su prolaz kroz stazu, dvostruka pokrivenost imena i različito ponašanje između Windowsa i Linuxa.

Samo zato što je učitana datoteka nazvana ../../report.pdf ne znači da bi je poslužitelj trebao spremiti pod tim imenom. Programeri koji pišu funkcije za učitavanje na strani poslužitelja, kao i timovi koji se moraju baviti korisničkim datotekama i brinuti o prolasku putanje i pokrivenosti dvostrukim imenima, naići će na ovaj problem. Nakon čitanja ovog članka, moći ćete razlikovati imena za prikaz i imena za pohranu, znati koje provjere treba učiniti na svakom sloju i pregledati vlastitu implementaciju prema stavkama prihvaćanja.

Naziv datoteke dolazi od korisnika i pripada ulaznim podacima; put diska pripada granici dopuštenja sustava. Brkanje to dvoje može lako dovesti do problema kao što su prolaz kroz stazu, dvostruka pokrivenost imena i različito ponašanje između Windowsa i Linuxa.

Ovaj članak koristi sintetičke uzorke za demonstraciju metode obrade. Kôd je provjeren na uzorku u izoliranom okruženju i nije jamstvo svih stvarnih datoteka ili performansi proizvoda. Prije obrade važnih dokumenata, molimo vas da sačuvate izvornike i pregledate ih prema granicama i stavkama prihvaćanja u tekstu.

Može li se naziv prenesene datoteke izravno koristiti kao put za pohranu? Zaključak jedne rečenice

Ne može se koristiti izravno. Ime za prikaz koristi se za prikaz sučelja, a stazu za pohranu generira poslužitelj na temelju internog ID-a.

vaša situacijaPreporučene prakserazlog
Izvorni naziv korisničke datoteke mora biti prikazan na sučeljuIme za prikaz rezervirano samo za prikazIme za prikaz odvojeno od putanje diska kako bi se izbjeglo križanje putanje
Potrebno je spremiti učitane datotekePoslužitelj generira interni ID i spaja put pohraneIzbjegavajte prepisivanje dvostrukim imenima i ne podliježite utjecaju korisničkog unosa
Ekstenzija datoteke treba sudjelovati u pohraniUzmi sufiks s popisa dopuštenih poslužiteljaNemojte kopirati ekstenzije koje su dali korisnici
Potrebno je utvrditi pravi tip datotekeProvedite otkrivanje i analizu sadržajaEkstenzije se mogu lažirati

Naziv za prikaz i naziv za pohranu su odvojeni

Izvorni naziv zadržava se za prikaz sučelja, ali internu identifikaciju generira poslužitelj. Sufiks za pohranu također bi trebao dolaziti s popisa dopuštenih na strani poslužitelja, umjesto kopiranja proširenja koje je dao korisnik.

Sljedeći primjer samo konstruira stazu, a ne stvara direktorij ili datoteku.

Konstruktor minimalne staze

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)

Ovaj primjer pretpostavlja da je interni ID generirao poslužitelj. To nije sigurna implementacija datoteke za pisanje za proizvoljna okruženja napada na disk:

  • Još uvijek se može dogoditi utrka između provjere i stvarnog otvaranja.
  • Dozvole nadređenog direktorija i pravila simboličke veze moraju se kontrolirati odvojeno.
  • Jedinstveni ID također ne znači da se pravilo "no override" može zanemariti.

Čišćenje naziva datoteke nije provjera autentičnosti datoteke

Čišćenje imena datoteka može riješiti samo dio problema; različiti fenomeni moraju se obrađivati na različitim slojevima:

Ulazni fenomenNa kojoj razini bi se to trebalo rješavati?Nedostaci
Uključuje separatore putanjaNe koristi se kao putanja za pohranuSamo uklanjanje dijagonalne linije nije dovoljno
Ekstenzija datoteke je PDFOtkrivanje i analiza sadržajaProdužeci se mogu kovati
Prikazni naziv koji sadrži HTMLBijeg izlaza sučeljaNe može se riješiti preimenovanjem diska
Isti prikazni nazivInterna izolacija ID-aPrethodna učitavanja ne smiju se prepisivati

📊 Usporedba jezgri

MetodaŠto se može riješiti?i nedostaci
Koristite korisničko ime datoteke izravnoImplementacija je najjednostavnijaMože doći do prelaska putem i preklapanja dupliciranih imena
Uklonite samo separator putanjaObrađeni neki ulazni podaciSamo uklanjanje dijagonalne linije nije dovoljno
Odredite vrstu na temelju ekstenzijePrethodna diferencijacija dokumenataProširenja se mogu krivotvoriti i moraju biti usklađena s detekcijom sadržaja
Poslužitelj generira interni IDIzolirajte duplicirane datoteke, a putanje kontrolira sustavI dalje zahtijeva suradnju s politikom "No Override" i kontrolom dozvola direktorija

Pohrana objekata ima iste granice

R2 ili druge objektne pohrane nemaju punu semantiku tradicionalnog pretraživanja direktorija, ali objektni ključevi i dalje utječu na izolaciju, nadjačavanje i izlaganje URL-ova.

  • Nemojte izravno slati nizove koje je dao zakupac u zajedničke prefikse.
  • Downloader ne može zaključiti autorizaciju isključivo na temelju imena ključeva.

Dokumenti trebaju imati identitet prije nego što uđu u prijevod

Prilikom pristupa OmniDoc (Portal proizvoda) tijeku rada, poznata imena datoteka mogu se i dalje prikazivati korisnicima, koristeći zasebne ID-ove zadataka i ID-ove datoteka interno.

Jasan identitet dokumenta donosi ove prednosti:

  • Prilikom neuspjeha i ponovnog pokušaja, može točno odgovarati izvornom zadatku.
  • Preuzimanje prijevoda i naknadna lektura osiguravaju da se ispravna datoteka podudara.
  • Smanjuje rizik od zamjene tuđe datoteke s istim imenom kao trenutni rezultat.

🎯 Koja ti metoda najviše odgovara?

Ako trebate prikazati naziv datoteke

Zadržite izvorno korisničko prikazno ime, ali samo za sučelje, ne i za putanju diska.

Ako trebate spremiti datoteku za prijenos

Poslužitelj generira interne ID-ove, uzima sufikse s popisa dopuštenih i kontrolira dopuštenja i dozvole direktorija prema stvarnim pravilima.

Ako koristite objektnu pohranu

Nemojte izravno pisati stringove zakupca u prefiks dijeljenja; prilikom preuzimanja napravite zasebne provjere autorizacije.

❓ Često postavljana pitanja (FAQ)

1. Ako uklonite kosu crtu, postaje li naziv datoteke sigurniji?

Nije dovoljno. Samo uklanjanje kose crte može obraditi samo dio unosa; konstrukcija puta, preklapanja i određivanje vrste datoteke i dalje se moraju zasebno obrađivati.

2. Ako je ekstenzija datoteke PDF, može li se potvrditi da je to PDF?

Ne. Ekstenzije se mogu krivotvoriti, što zahtijeva detekciju i parsiranje sadržaja.

3. Što da radim ako prikazno ime sadrži HTML?

Escape tijekom izlaza sučelja ne može se riješiti promjenom imena datoteke na disku.

4. Trebam li i dalje onemogućiti nadjačavanja nakon korištenja jedinstvenog ID-a?

Da. Jedinstveni ID ne znači da se politika "Bez nadjačavanja" može zanemariti.

📝 Sažetak

Naziv datoteke za prijenos treba obrađivati odvojeno od puta pohrane: prikaz se koristi za prikaz, a putanju za pohranu generira poslužitelj na temelju internog ID-a. Putovi, pokrivenost, vrste i ovlaštenja moraju se provjeravati zasebno.

Iskustvo sada: Učitajte svoj dokument kako biste započeli prijevod, zadržavajući izvorno formatiranje

Izvori: Python pathlib

Ažurirano 2026-11-16