고객이 업로드한 파일명은 직접 저장 경로로 사용할 수 없습니다: 경로 순회 및 중복 이름 적용 방지를 위해

업로드된 파일의 이름은 `../../report.pdf`이며 이는 서버가 이 이름으로 저장해야 한다는 의미는 아닙니다. 파일 이름은 사용자로부터 나오며 입력 데이터에 속합니다. 디스크 경로는 시스템 권한 경계에 속합니다. 두 가지를 혼동하면 경로 탐색, 중복 이름 적용, Windows와 Linux 간의 서로 다른 동작과 같은 문제가 쉽게 발생할 수 있습니다.

업로드된 파일의 이름이 ../../report.pdf라고 해서 서버가 이 이름으로 저장해야 한다는 의미는 아닙니다. 서버 측 업로드 기능을 작성하는 개발자와 사용자 파일을 처리해야 하고 경로 탐색 및 중복 이름 적용을 걱정해야 하는 팀은 이 문제에 직면하게 됩니다. 이 글을 읽고 나면 표시 이름과 저장소 이름을 구별하고, 각 계층에서 어떤 확인을 해야 하는지 알 수 있으며, 승인 항목에 따라 자체 구현을 검토할 수 있습니다.

파일 이름은 사용자로부터 나오며 입력 데이터에 속합니다. 디스크 경로는 시스템 권한 경계에 속합니다. 두 가지를 혼동하면 경로 탐색, 중복 이름 적용, Windows와 Linux 간의 서로 다른 동작과 같은 문제가 쉽게 발생할 수 있습니다.

이 기사에서는 합성 샘플을 사용하여 처리 방법을 보여줍니다. 코드는 격리된 환경에서 샘플 검사되었으며 모든 실제 파일이나 제품 성능을 보장하지는 않습니다. 중요한 서류를 처리하기 전, 원본을 보관하시고, 본문에 기재된 경계 및 허용 항목에 따라 검토하시기 바랍니다.

업로드한 파일명을 바로 저장경로로 사용할 수 있나요? 한 문장 결론

직접 사용할 수는 없습니다. 표시 이름은 인터페이스 표시에 사용되며, 저장 경로는 내부 ID를 기반으로 서버에서 생성됩니다.

당신의 상황권장 사례이유
사용자의 원래 파일 이름이 인터페이스에 표시되어야 합니다.표시 전용으로 예약된 표시 이름경로 교차를 피하기 위해 디스크 경로와 분리된 표시 이름
업로드된 파일을 저장해야 함서버는 내부 ID를 생성하고 저장 경로를 연결합니다.중복된 이름으로 덮어쓰지 않고 사용자 입력에 영향을 받지 않음
파일 확장자는 저장에 참여해야 합니다.서버 허용 목록에서 접미사 가져오기사용자가 제공한 확장자를 복사하지 마십시오.
파일의 실제 유형을 확인해야 합니다.콘텐츠 감지 및 분석 수행확장 프로그램은 위조될 수 있습니다.

표시 이름과 저장소 이름이 구분됩니다.

인터페이스 표시를 위해 원래 이름이 유지되지만 내부 식별은 서버에서 생성됩니다. 저장소 접미사는 사용자가 제공한 확장명을 복사하는 대신 서버 측 허용 목록에서도 가져와야 합니다.

다음 예제에서는 경로만 구성하고 디렉터리나 파일을 생성하지 않습니다.

최소 경로 생성자

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)

이 예에서는 내부 ID가 서버에 의해 생성되었다고 가정합니다. 임의의 디스크 공격 환경에 대한 안전한 쓰기 파일 구현이 아닙니다.

  • 확인 후 실제 오픈까지 레이스가 발생할 수 있습니다.
  • 상위 디렉터리 권한과 심볼릭 링크 정책은 별도로 제어되어야 합니다.
  • 고유 ID가 "재정의 없음" 정책을 무시할 수 있다는 의미도 아닙니다.

파일 이름 정리는 파일 인증이 아닙니다

파일 이름 정리는 문제의 일부만 해결할 수 있으며 다양한 현상을 다양한 수준에서 처리해야 합니다.

입력 현상어느 수준에서 처리해야 합니까?단점
경로 구분 기호가 포함되어 있습니다.저장 경로로 사용되지 않음단순히 슬래시를 제거하는 것만으로는 충분하지 않습니다.
확장 PDF콘텐츠 감지 및 분석확장 프로그램은 위조될 수 있습니다.
표시 이름에 HTML이 포함되어 있습니다.인터페이스 출력 이스케이프디스크 이름을 변경하여 해결할 수 없습니다.
동일한 표시 이름내부 ID 격리이전 업로드를 덮어쓰면 안 됩니다.

📊 핵심 비교

관행해결될 수 있는 것단점
사용자 파일 이름을 직접 사용가장 간단한 구현경로 교차 및 중복된 이름 적용이 발생할 수 있습니다.
경로 구분 기호만 제거하세요.입력의 처리된 부분단순히 슬래시를 제거하는 것만으로는 충분하지 않습니다.
확장에 따라 유형 결정예비 차별화 파일확장 프로그램은 위조될 수 있으며 콘텐츠 감지가 필요합니다.
서버측에서 생성된 내부 ID동일한 이름을 가진 파일을 격리합니다. 경로는 시스템에 의해 제어됩니다.여전히 "덮어쓰기 금지" 정책 및 디렉터리 권한 제어에 협조해야 합니다.

객체 스토리지에도 동일한 경계가 있습니다

R2 또는 기타 개체 저장소에는 기존 디렉터리 탐색의 전체 의미 체계가 없지만 개체 키는 여전히 격리, 재정의 및 노출된 URL에 영향을 미칩니다.

  • 테넌트가 제공한 문자열을 공유 접두사에 직접 입력하지 마세요.
  • 다운로더는 키 이름만으로는 인증을 추론할 수 없습니다.

번역을 시작하기 전에 파일에 ID가 있어야 합니다.

OmniDoc(제품 포털) 워크플로에 연결하면 계속해서 사용자에게 친숙한 파일 이름을 표시하고 내부적으로 독립적인 작업 ID와 파일 ID를 사용할 수 있습니다.

명확한 다큐멘터리 정체성은 다음과 같은 이점을 제공합니다.

  • 재시도 실패 시 원래 작업에 정확하게 대응할 수 있습니다.
  • 번역원고 다운로드 및 후속 검토를 통해 정확한 파일에 대응될 수 있습니다.
  • 다른 사람의 파일을 현재 결과와 동일한 이름으로 취급할 위험을 줄입니다.

🎯 어떤 방법이 당신에게 적합합니까?

파일 이름을 표시해야 하는 경우

사용자의 원래 표시 이름은 유지되지만 디스크 경로가 아닌 인터페이스에만 사용됩니다.

업로드한 파일을 저장해야 하는 경우

내부 ID는 서버에서 생성되며 허용 목록에서 접미사를 가져와 실제 정책에 따라 적용 범위와 디렉터리 권한을 제어합니다.

객체 스토리지를 사용하는 경우

테넌트 문자열을 공유 접두사로 직접 철자를 사용하지 말고, 다운로드할 때 별도의 인증 판단을 내리세요.

❓ 자주 묻는 질문(FAQ)

1. 슬래시를 없애면 파일명은 안전할까요?

충분하지 않습니다. 슬래시를 제거하는 것만으로 입력의 일부만 처리할 수 있으며, 경로 구성, 덮어쓰기, 파일 유형 결정은 여전히 별도로 처리해야 합니다.

2. 확장자가 PDF라고 해서 PDF라는 뜻인가요?

할 수 없습니다. 확장 프로그램은 위조될 수 있으며 콘텐츠 감지 및 분석이 필요합니다.

3. 표시 이름에 HTML이 포함되어 있으면 어떻게 해야 합니까?

인터페이스 출력 중 이스케이프는 디스크의 파일 이름을 수정하여 해결할 수 없습니다.

4. 고유 ID를 사용한 후에도 덮어쓰기를 비활성화해야 합니까?

필요. 고유 ID가 "재정의 없음" 정책을 무시할 수 있다는 의미는 아닙니다.

📝 요약

업로드된 파일명은 저장 경로와 별도로 처리되어야 합니다. 표시 이름은 표시에 사용되며, 저장 경로는 내부 ID를 기반으로 서버에서 생성됩니다. 경로, 적용 범위, 유형 및 승인은 모두 독립적으로 확인됩니다.

지금 사용해 보세요: 원본 레이아웃을 유지하면서 번역을 시작하려면 문서를 업로드하세요.

참고: Python pathlib

업데이트: 2026-11-15