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 situacija | Preporučene prakse | razlog |
|---|---|---|
| Izvorni naziv korisničke datoteke mora biti prikazan na sučelju | Ime za prikaz rezervirano samo za prikaz | Ime za prikaz odvojeno od putanje diska kako bi se izbjeglo križanje putanje |
| Potrebno je spremiti učitane datoteke | Poslužitelj generira interni ID i spaja put pohrane | Izbjegavajte prepisivanje dvostrukim imenima i ne podliježite utjecaju korisničkog unosa |
| Ekstenzija datoteke treba sudjelovati u pohrani | Uzmi sufiks s popisa dopuštenih poslužitelja | Nemojte kopirati ekstenzije koje su dali korisnici |
| Potrebno je utvrditi pravi tip datoteke | Provedite otkrivanje i analizu sadržaja | Ekstenzije 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 fenomen | Na kojoj razini bi se to trebalo rješavati? | Nedostaci |
|---|---|---|
| Uključuje separatore putanja | Ne koristi se kao putanja za pohranu | Samo uklanjanje dijagonalne linije nije dovoljno |
| Ekstenzija datoteke je PDF | Otkrivanje i analiza sadržaja | Produžeci se mogu kovati |
| Prikazni naziv koji sadrži HTML | Bijeg izlaza sučelja | Ne može se riješiti preimenovanjem diska |
| Isti prikazni naziv | Interna izolacija ID-a | Prethodna učitavanja ne smiju se prepisivati |
📊 Usporedba jezgri
| Metoda | Što se može riješiti? | i nedostaci |
|---|---|---|
| Koristite korisničko ime datoteke izravno | Implementacija je najjednostavnija | Može doći do prelaska putem i preklapanja dupliciranih imena |
| Uklonite samo separator putanja | Obrađeni neki ulazni podaci | Samo uklanjanje dijagonalne linije nije dovoljno |
| Odredite vrstu na temelju ekstenzije | Prethodna diferencijacija dokumenata | Proširenja se mogu krivotvoriti i moraju biti usklađena s detekcijom sadržaja |
| Poslužitelj generira interni ID | Izolirajte duplicirane datoteke, a putanje kontrolira sustav | I 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.
Izvori: Python pathlib


