저장 및 서빙¶

보안 고려 사항¶

FileSystemStorage 를 사용할 때, 문서는 사이트의 MEDIA_ROOT 내 documents 하위 디렉터리에 저장됩니다. 이 경우 WAGTAILDOCS_SERVE_METHOD 는 기본적으로 serve_view 로 설정되며, Wagtail은 개인정보 보호 검사를 시행하는 Django 뷰를 통해 문서를 서빙합니다.

serve_view 메서드를 사용할 때:

• 웹 서버 설정에서 MEDIA_ROOT 의 documents 하위 디렉터리에 대한 직접 접근을 차단해야 합니다. 이를 통해 사용자가 직접 URL로 문서에 접근하여 컬렉션 개인정보 보호 설정을 우회하는 것을 방지할 수 있습니다.

• 문서는 브라우저에 표시되는 대신 다운로드로 제공됩니다(WAGTAILDOCS_INLINE_CONTENT_TYPES를 통해 명시적으로 지정하지 않는 한). 이는 문서가 스크립트(예: HTML 또는 SVG)를 포함할 수 있는 유형인 경우 브라우저가 이를 실행하는 것을 방지합니다.

• 그러나 문서는 Django 애플리케이션 서버를 통해 제공되므로 웹 서버에서 직접 문서를 제공하는 것보다 더 많은 서버 리소스를 소비할 수 있습니다.

대안적인 서빙 메서드인 'direct' 와 'redirect' 는 MEDIA_ROOT 에서 직접 문서를 서빙하는 방식으로 작동합니다. 이는 documents 하위 디렉터리에 대한 직접 접근을 차단할 수 없음을 의미하며, 따라서 사용자는 직접 URL에 접근하여 권한 확인을 우회할 수 있습니다. 또한, Wagtail 관리자에 접근할 수 있는 사용자를 완전히 신뢰할 수 없는 경우, 문서 내 스크립트 실행을 방지하기 위해 추가적인 조치를 취해야 합니다:

• WAGTAILDOCS_EXTENSIONS 설정을 사용하여 업로드된 문서를 안전한 유형의 “허용 목록”으로 제한할 수 있습니다.

• 웹 서버를 설정하여 documents 하위 디렉터리 내 파일에 대해 Content-Security-Policy: default-src 'none' 헤더를 반환하도록 할 수 있습니다. 이는 해당 파일 내의 스크립트 실행을 방지합니다.

• 웹 서버를 설정하여 documents 하위 디렉터리 내 파일에 대해 Content-Disposition: attachment 헤더를 반환하도록 할 수 있습니다. 이는 브라우저가 파일을 인라인으로 표시하는 대신 다운로드하도록 강제합니다.

원격(“클라우드”) 스토리지 백엔드를 사용하는 경우, 서빙 메서드는 기본적으로 'redirect' 로 설정되며 문서는 클라우드 스토리지 파일 URL에서 직접 제공됩니다. 이 경우(‘direct’와 마찬가지로) Wagtail은 파일이 제공되는 방식에 대한 제어력이 적으며, 사용자는 권한 확인을 우회할 수 있고 문서 내의 스크립트가 실행될 수 있습니다(클라우드 스토리지 서비스의 설정에 따라 다름). 그러나 교차 사이트 스크립팅 공격은 여전히 가능하지만, 문서는 일반적으로 메인 사이트와 다른 도메인에서 제공되므로 그 영향은 줄어듭니다.

이러한 제한 사항을 수용할 수 없는 경우, WAGTAILDOCS_SERVE_METHOD 를 serve_view 로 설정하고 클라우드 서비스의 파일 URL을 사용하여 문서에 공개적으로 접근할 수 없도록 해야 합니다.

특정 응답에 대해 헤더를 설정하는 데 필요한 단계는 Wagtail 애플리케이션이 배포된 방식과 사용되는 스토리지 백엔드에 따라 달라집니다. serve_view 메서드의 경우, 문서에 포함된 스크립트 실행을 방지하기 위해 Content-Security-Policy 헤더가 자동으로 설정됩니다(WAGTAILDOCS_BLOCK_EMBEDDED_CONTENT를 통해 비활성화하지 않는 한).