use tracing::debug;
use crate::http::content_disposition::parse_content_disposition;
use crate::http::header_processor::HttpResponseHead;
use crate::util::uri;
pub(crate) const DEFAULT_FILE: &str = "index.html";
pub fn determine_filename(
response_head: &HttpResponseHead,
request_url: &str,
content_disposition_default_utf8: bool,
) -> String {
if let Some(cd) = response_head.header("content-disposition")
&& let Some(filename) =
parse_content_disposition_filename(cd, content_disposition_default_utf8)
{
debug!(
filename = %filename,
source = "Content-Disposition",
"Filename determined"
);
return filename;
}
let url_filename = extract_filename_from_url(request_url);
debug!(filename = %url_filename, source = "URL", "Filename determined");
url_filename
}
pub(crate) fn extract_filename_from_url(url: &str) -> String {
let path = match url::Url::parse(url) {
Ok(parsed) => parsed.path().to_string(),
Err(_) => {
match url.find("://") {
Some(scheme_end) => {
let after_scheme = &url[scheme_end + 3..];
match after_scheme.find('/') {
Some(pos) => after_scheme[pos..].to_string(),
None => "/".to_string(),
}
}
None => url.to_string(),
}
}
};
let decoded = uri::percent_decode(&path);
let basename = match decoded.rfind('/') {
Some(pos) if pos + 1 < decoded.len() => &decoded[pos + 1..],
_ => return create_safe_path(DEFAULT_FILE),
};
if basename.is_empty() {
create_safe_path(DEFAULT_FILE)
} else {
create_safe_path(basename)
}
}
pub(crate) fn create_safe_path(name: &str) -> String {
let mut result = String::with_capacity(name.len());
for ch in name.chars() {
match ch {
'/' | '\\' => result.push('_'),
'\0' => {} _ => result.push(ch),
}
}
if result.is_empty() {
DEFAULT_FILE.to_string()
} else {
result
}
}
fn parse_content_disposition_filename(cd_value: &str, _default_utf8: bool) -> Option<String> {
let result = parse_content_disposition(cd_value);
if result.disposition_type.is_empty() {
return None;
}
let filename = result.filename?;
if filename.contains('/') || filename.contains('\\') {
debug!(
filename = %filename,
"Content-Disposition filename rejected: contains path separator"
);
return None;
}
Some(filename)
}
#[cfg(test)]
mod tests {
use super::*;
use crate::http::header_processor::HttpHeaderProcessor;
fn parse_head(raw: &[u8]) -> HttpResponseHead {
let mut proc = HttpHeaderProcessor::new();
proc.feed(raw);
proc.get_result().unwrap()
}
#[test]
fn test_filename_from_url_path() {
let head = parse_head(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(&head, "http://example.com/path/to/file.txt", false);
assert_eq!(filename, "file.txt");
}
#[test]
fn test_filename_from_url_trailing_slash() {
let head = parse_head(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(&head, "http://example.com/dir/", false);
assert_eq!(filename, "index.html");
}
#[test]
fn test_filename_from_url_percent_encoded() {
let head = parse_head(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(&head, "http://example.com/path/my%20file.txt", false);
assert_eq!(filename, "my file.txt");
}
#[test]
fn test_filename_from_url_utf8_percent_encoded() {
let head = parse_head(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(
&head,
"http://example.com/%E6%97%A5%E6%9C%AC%E8%AA%9E.txt",
false,
);
assert_eq!(filename, "\u{65e5}\u{672c}\u{8a9e}.txt");
}
#[test]
fn test_filename_from_content_disposition_quoted() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=\"my file.pdf\"\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/download", false);
assert_eq!(filename, "my file.pdf");
}
#[test]
fn test_filename_from_content_disposition_unquoted() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=report.csv\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/download", false);
assert_eq!(filename, "report.csv");
}
#[test]
fn test_filename_from_content_disposition_star() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename*=UTF-8''my%20doc.txt\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/download", false);
assert_eq!(filename, "my doc.txt");
}
#[test]
fn test_filename_content_disposition_priority_over_url() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: inline; filename=\"override.txt\"\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/original.txt", false);
assert_eq!(filename, "override.txt");
}
#[test]
fn test_filename_star_priority_over_filename() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=\"fallback.txt\"; filename*=UTF-8''preferred.txt\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/download", false);
assert_eq!(filename, "preferred.txt");
}
#[test]
fn test_filename_star_with_cjk() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename*=UTF-8''%e3%81%93%e3%82%93%e3%81%ab%e3%81%a1%e3%81%af.txt\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/download", false);
assert_eq!(filename, "\u{3053}\u{3093}\u{306b}\u{3061}\u{306f}.txt");
}
#[test]
fn test_content_disposition_path_separator_rejected() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=\"subdir/file.txt\"\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/original.txt", false);
assert_eq!(filename, "original.txt");
}
#[test]
fn test_content_disposition_backslash_rejected() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=\"dir\\\\file.txt\"\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/original.txt", false);
assert_eq!(filename, "original.txt");
}
#[test]
fn test_content_disposition_directory_traversal_rejected() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=\"../etc/passwd\"\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/original.txt", false);
assert_eq!(filename, "original.txt");
}
#[test]
fn test_duplicate_filename_rejected() {
let head = parse_head(
b"HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=first.txt; filename=second.txt\r\n\r\n",
);
let filename = determine_filename(&head, "http://example.com/original.txt", false);
assert_eq!(filename, "original.txt");
}
#[test]
fn test_create_safe_path() {
assert_eq!(create_safe_path("normal.txt"), "normal.txt");
assert_eq!(create_safe_path("path/to/file.txt"), "path_to_file.txt");
assert_eq!(create_safe_path("win\\path"), "win_path");
assert_eq!(create_safe_path("null\0byte"), "nullbyte");
}
#[test]
fn test_no_content_disposition_uses_url() {
let head = parse_head(b"HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(&head, "http://example.com/data.csv", false);
assert_eq!(filename, "data.csv");
}
#[test]
fn test_empty_content_disposition_uses_url() {
let head =
parse_head(b"HTTP/1.1 200 OK\r\nContent-Disposition: \r\nContent-Length: 100\r\n\r\n");
let filename = determine_filename(&head, "http://example.com/data.csv", false);
assert_eq!(filename, "data.csv");
}
}