Тұтынушы жүктеп салған файл атауын тікелей сақтау жолы ретінде пайдалану мүмкін емес: жолдың өтуін және қайталанатын атауды қамтуды болдырмау үшін
Жүктеп салынған файл `../../report.pdf` деп аталады, бұл сервер оны осы атпен сақтауы керек дегенді білдірмейді. Файл атауы пайдаланушыдан келеді және енгізілген деректерге жатады; диск жолы жүйе рұқсатының шекарасына жатады. Бұл екеуін шатастыру жолды ауыстыру, қайталанатын атауды қамту және Windows пен Linux арасындағы әртүрлі әрекеттер сияқты мәселелерге оңай әкелуі мүмкін.
Жүктеп салынған файлдың атауы ../../report.pdf болғандықтан сервер оны осы атпен сақтауы керек дегенді білдірмейді. Сервер тарапынан жүктеп салу функцияларын жазатын әзірлеушілер, сондай-ақ пайдаланушы файлдарымен жұмыс істеу керек және жолды ауыстыру және қайталанатын атауларды қамту туралы алаңдайтын топтар бұл мәселеге тап болады. Осы мақаланы оқығаннан кейін сіз дисплей атаулары мен сақтау атауларын ажырата аласыз, әр қабатта қандай тексерулер жасау керектігін білесіз және қабылдау элементтеріне сәйкес өзіңіздің іске асыруыңызды қарап шығыңыз.
Файл атауы пайдаланушыдан келеді және енгізілген деректерге жатады; диск жолы жүйе рұқсатының шекарасына жатады. Бұл екеуін шатастыру жолды ауыстыру, қайталанатын атауды қамту және Windows пен Linux арасындағы әртүрлі әрекеттер сияқты мәселелерге оңай әкелуі мүмкін.
Бұл мақалада өңдеу әдісін көрсету үшін синтетикалық үлгілер пайдаланылады. Код оқшауланған ортада үлгі тексерілді және барлық нақты файлдардың немесе өнім өнімділігінің кепілі емес. Маңызды құжаттарды өңдеуден бұрын түпнұсқаларды сақтап, мәтіндегі шекаралар мен қабылдау элементтеріне сәйкес қарап шығыңыз.
Жүктеп салынған файл атауын тікелей сақтау жолы ретінде пайдалануға бола ма? Бір сөйлемнен қорытынды
Оны тікелей қолдануға болмайды. Көрсетілетін атау интерфейсті көрсету үшін пайдаланылады, ал сақтау жолы ішкі идентификатор негізінде сервер арқылы жасалады.
| сіздің жағдайыңыз | Ұсынылатын тәжірибелер | себебі |
|---|---|---|
| Пайдаланушының бастапқы файл атауы интерфейсте көрсетілуі керек | Дисплей атауы тек көрсету үшін сақталған | Жолды кесіп өтуді болдырмау үшін диск жолынан бөлінген атауды көрсету |
| Жүктеп салынған файлдарды сақтау керек | Сервер ішкі идентификаторды жасайды және сақтау жолын қосады | Қайталанатын атаулармен қайта жазудан аулақ болыңыз және пайдаланушы енгізуіне әсер етпеңіз |
| Файл кеңейтімі жадқа қатысуы керек | Сервердің рұқсат етілген тізімінен жұрнақ алыңыз | Пайдаланушылар берген кеңейтімдерді көшірмеңіз |
| Файлдың нақты түрін анықтау керек | Мазмұнды анықтау және талдау | Кеңейтімдер жалған болуы мүмкін |
Көрсетілетін атау мен сақтау атауы бөлінген
Бастапқы атау интерфейсті көрсету үшін сақталады, бірақ ішкі сәйкестендіру сервер арқылы жасалады. Сақтау жұрнағы пайдаланушы берген кеңейтімді көшірудің орнына сервер тарапынан рұқсат етілген тізімнен келуі керек.
Келесі мысал тек жолды құрастырады және каталогты немесе файлды жасамайды.
Минималды жол конструкторы
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)
Бұл мысал ішкі идентификатор сервер арқылы жасалғанын болжайды. Бұл еркін диск шабуыл орталары үшін қауіпсіз жазу файлын іске асыру емес:
- Тексеру мен нақты ашу арасында жарыс әлі де болуы мүмкін.
- Негізгі каталог рұқсаттары мен символдық сілтеме саясаттары бөлек басқарылуы керек.
- Бірегей идентификатор сонымен қатар «қайта анықтауға болмайды» саясатын елемеу мүмкін емес дегенді білдірмейді.
Файл атауын тазарту файлдың аутентификациясы емес
Файл атауын тазалау мәселенің бір бөлігін ғана шеше алады және әртүрлі құбылыстарды әртүрлі деңгейде өңдеу қажет:
| енгізу құбылысы | Оны қай деңгейде өңдеу керек? | кемшіліктер |
|---|---|---|
| Жолды бөлгішті қамтиды | Сақтау жолы ретінде пайдаланылмайды | Тек қиғаш сызықты алып тастау жеткіліксіз |
| кеңейтім PDF | Мазмұнды анықтау және талдау | Кеңейтімдер жалған болуы мүмкін |
| Көрсетілетін атау HTML қамтиды | Интерфейс шығысы | Диск атауын өзгерту арқылы оны шешу мүмкін емес. |
| Көрсетілетін атау бірдей | Ішкі идентификаторды оқшаулау | Алдыңғы жүктеп салуды қайта жазуға болмайды |
📊 Негізгі салыстыру
| тәжірибе | Не шешуге болады | кемшіліктер |
|---|---|---|
| Пайдаланушы файлының атын тікелей пайдаланыңыз | Ең қарапайым іске асыру | Жолдың қиылысуы және қайталанатын атауды қамту орын алуы мүмкін |
| Тек жол бөлгіштерін алып тастаңыз | Кірістің өңделген бөлігі | Тек қиғаш сызықты алып тастау жеткіліксіз |
| Кеңейтім негізінде түрін анықтаңыз | алдын ала саралау файлы | Кеңейтімдер жалған болуы мүмкін және мазмұнды анықтау қажет. |
| Сервер тарапынан жасалған ішкі идентификатор | Бірдей атпен файлдарды оқшаулаңыз, жолды жүйе басқарады | Әлі де "қайта жазуға болмайды" саясатымен және каталог рұқсаттарын басқарумен ынтымақтасу қажет |
Нысанды сақтаудың да шекаралары бірдей
R2 немесе басқа нысандар қоймаларында дәстүрлі каталогтарды ауыстырудың толық семантикасы жоқ, бірақ нысан пернелері әлі де оқшаулауға, қайта анықтауға және ашық URL мекенжайларына әсер етеді.
- Жалға алушы ұсынған жолды ортақ префикске тікелей емлемеңіз.
- Жүктеп алушы тек кілт атауына негізделген авторизацияны шығара алмайды.
Аудармаға кіріспес бұрын файлда сәйкестік болуы керек
OmniDoc (өнім порталы) жұмыс процесіне қосылған кезде пайдаланушыларға таныс файл атауларын көрсетуді жалғастыруға және тәуелсіз тапсырма идентификаторлары мен файл идентификаторларын ішкі пайдалануға болады.
Айқын құжаттық сәйкестік келесі артықшылықтарды береді:
- Қайталау әрекеті сәтсіз болғанда, ол бастапқы тапсырмаға дәл сәйкес келуі мүмкін.
- Аударма қолжазбасын жүктеп алу және одан кейінгі шолу дұрыс файлға сәйкес келуі мүмкін.
- Ағымдағы нәтиже сияқты атпен басқа біреудің файлын өңдеу қаупін азайтыңыз.
🎯 Сізге қай әдіс қолайлы?
Файл атауын көрсету қажет болса
Пайдаланушының бастапқы дисплей атауы сақталады, бірақ ол диск жолы үшін емес, интерфейс үшін ғана пайдаланылады.
Жүктеп салынған файлды сақтау қажет болса
Ішкі идентификатор сервер арқылы жасалады, рұқсат етілген тізімнен жұрнақты алады және нақты саясатқа сәйкес қамту мен каталог рұқсаттарын басқарады.
Нысан жадын пайдалансаңыз
Жалға алушы жолын ортақ префикске тікелей емлемеңіз және жүктеп алу кезінде бөлек авторизация шешімдерін жасаңыз.
❓ Жиі қойылатын сұрақтар (ЖҚС)
1. Егер қиғаш сызық жойылса, файл атауы қауіпсіз бола ма?
жеткіліксіз. Тек қиғаш сызықтарды жою кірістің бір бөлігін ғана өңдей алады, ал жол құрылысы, қайта жазу және файл түрін анықтау әлі де бөлек өңделуі керек.
2. Кеңейтім PDF болғандықтан, бұл оның PDF екенін білдіре ме?
мүмкін емес. Кеңейтімдер жалған болуы мүмкін және мазмұнды анықтау мен талдауды қажет етеді.
3. Көрсетілетін атауда HTML болса, не істеуім керек?
Интерфейс шығысы кезінде Escape дискідегі файл атауын өзгерту арқылы шешілмейді.
4. Бірегей идентификаторды пайдаланғаннан кейін қайта жазуды өшіруім керек пе?
қажет. Бірегей идентификатор «алдын ала анықтауға болмайды» саясатын елемеу мүмкін емес дегенді білдірмейді.
📝 Түйіндеме
Жүктеп салынған файл атауы сақтау жолынан бөлек өңделуі керек: дисплей атауы дисплей үшін пайдаланылады, ал сақтау жолы ішкі идентификатор негізінде сервер арқылы жасалады. Жол, қамту, түрі және авторизациясының барлығы тәуелсіз тексеріледі.
Дереккөздер: Python pathlib


