클라우드 Mac에서 검증하는 iOS 다운로드 파일 형식

클라우드 Mac에서 검증하는 iOS 다운로드 파일 형식

클라우드 Mac에서 검증하는 iOS 다운로드 파일 형식

iOS 다운로드 API는 성공을 반환했는데 미리보기 화면에서 첨부 파일이 열리지 않는 경우가 있습니다. 로그인 만료로 반환된 오류 페이지를 받았을 수도 있고, 서버가 모든 콘텐츠를 범용 바이너리로 표시했을 수도 있으며, 파일이 절반만 다운로드되었을 수도 있습니다. 클라우드 Mac에서 이런 문제를 재현할 때 처음부터 실제 서비스에 연결할 필요는 없습니다. 먼저 ‘어떤 형식으로 선언되었는지, 실제 내용은 어떤 형식처럼 보이는지, 끝까지 파싱할 수 있는지’를 분리하고, 고정된 테스트 샘플로 세 단계의 검증 기준을 세운 뒤 다운로드 흐름에 연결하면 됩니다.

먼저 허용할 형식을 정의하기

첨부 파일을 받는 진입점에서 PNG, JPEG, PDF만 허용한다고 가정하겠습니다. 허용 규칙은 파일명으로 추측하는 것이 아니라 업무상 허용 목록을 기준으로 정해야 합니다. 파일명은 사용자에게 표시할 수 있지만, 어떤 파서로 처리할지 결정하는 근거로 삼아서는 안 됩니다. 저장 경로를 만드는 데 그대로 사용해서도 안 됩니다.

검증 순서는 다음과 같습니다. HTTP 상태가 API 계약에 맞는지 확인하고, 실제 수신 바이트 수를 제한한 다음, 응답의 MIME과 파일 헤더를 대조하고, 마지막으로 형식별 파싱을 수행합니다. Content-Length는 조기에 거부할 수 있는 근거 중 하나일 뿐입니다. 값이 없거나 실제 크기보다 작더라도 누적 수신 바이트 수의 상한을 대신할 수는 없습니다.

파일 헤더가 일치한다는 것은 ‘해당 형식처럼 보인다’는 뜻일 뿐, 완전성을 증명하지도 안전성을 보장하지도 않습니다. PNG 시그니처만 있는 파일은 여전히 표시할 수 없습니다.

API가 범용 바이너리를 반환한다고 명시적으로 정해져 있다면 해당 진입점에만 예외를 설정할 수 있습니다. 모든 다운로드에 같은 완화 규칙을 적용해서는 안 됩니다. 아래 구현은 엄격한 모드로 동작하며, MIME이 없거나 선언된 형식과 실제 내용이 충돌하면 모두 거부합니다.

순수 함수로 형식 판별 로직 분리하기

원격 macOS 터미널에서 type-check.swift를 만들고 아래 내용을 저장합니다. 이 함수는 헤더 데이터와 MIME만 입력받으며, 네트워크에 연결하거나 사용자 디렉터리에 접근하지 않습니다. 따라서 나중에 앱의 테스트 타깃으로 옮기기 쉽습니다. 코드에 포함된 샘플은 분류 규칙만 검증하며, 유효한 이미지나 문서로 간주하지 않습니다.

import Foundation

enum FileKind: String {
    case png, jpeg, pdf

    var mime: String {
        switch self {
        case .png: return "image/png"
        case .jpeg: return "image/jpeg"
        case .pdf: return "application/pdf"
        }
    }
}

enum TypeFailure: Error {
    case unknownHeader
    case missingMIME
    case conflictingMIME
}

func classify(
    prefix: Data,
    declaredMIME: String?
) throws -> FileKind {
    let bytes = Array(prefix.prefix(8))
    let kind: FileKind

    if bytes.starts(with: [137, 80, 78, 71, 13, 10, 26, 10]) {
        kind = .png
    } else if bytes.starts(with: [255, 216, 255]) {
        kind = .jpeg
    } else if bytes.starts(with: Array("%PDF-".utf8)) {
        kind = .pdf
    } else {
        throw TypeFailure.unknownHeader
    }

    guard let declaredMIME else {
        throw TypeFailure.missingMIME
    }

    let mime = declaredMIME
        .split(separator: ";", omittingEmptySubsequences: false)[0]
        .trimmingCharacters(in: .whitespacesAndNewlines)
        .lowercased()

    guard mime == kind.mime else {
        throw TypeFailure.conflictingMIME
    }
    return kind
}

struct Fixture {
    let head: [UInt8]
    let mime: String?
    let expected: FileKind?
}

let fixtures: [Fixture] = [
    .init(
        head: [137, 80, 78, 71, 13, 10, 26, 10],
        mime: "IMAGE/PNG; charset=binary",
        expected: .png
    ),
    .init(head: [255, 216, 255], mime: "image/jpeg", expected: .jpeg),
    .init(
        head: Array("%PDF-1.7".utf8),
        mime: "application/pdf",
        expected: .pdf
    ),
    .init(
        head: Array("<html>error".utf8),
        mime: "application/pdf",
        expected: nil
    ),
    .init(head: [137, 80, 78], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: nil, expected: nil)
]

for (index, fixture) in fixtures.enumerated() {
    let actual = try? classify(
        prefix: Data(fixture.head),
        declaredMIME: fixture.mime
    )
    guard actual == fixture.expected else {
        fatalError("Fixture mismatch at index \(index)")
    }
}

xcrun swift type-check.swift를 실행하면 모든 결과가 예상과 일치할 때는 별도 출력 없이 종료되고, 단언 검사가 실패하면 0이 아닌 종료 코드를 반환합니다. 여기서 헤더 문자열을 직접 사용하는 이유는 대소문자와 매개변수 처리까지 검증하기 위해서입니다. 앱이 이미 정규화된 MIME을 읽는 경우에도 문제를 추적할 수 있도록 원본 응답 헤더를 보관하되, 인증 관련 필드는 기록하지 않아야 합니다.

다운로드에 연결할 때 파일 전체를 메모리에 읽지 않기

다운로드 태스크를 사용할 때는 먼저 태스크 오류, 응답 상태, 임시 파일의 존재 여부를 확인합니다. 그런 다음 FileHandle로 최대 여덟 바이트만 읽어 판별 함수에 전달하고, 핸들은 defer로 닫습니다. 시그니처를 읽기 위해 파일 전체에 대해 Data(contentsOf:)를 실행하지 마세요. 첨부 파일이 크면 간단한 검사 한 번이 메모리 사용량 급증으로 이어질 수 있습니다.

스트리밍으로 수신할 때는 처음 여덟 바이트를 누적해야 합니다. 첫 콜백에 완전한 시그니처가 들어 있다고 가정해서는 안 됩니다. 콜백으로 전달되는 데이터 청크의 경계는 파일 형식의 경계와 무관합니다. 수신한 데이터만으로 분류하기 어렵다면 여덟 바이트가 모두 모이거나 전송이 끝날 때까지 기다린 뒤 판정합니다.

다운로드 태스크가 제공하는 임시 파일은 앱이 관리하는 임시 저장 디렉터리로 제때 옮겨야 합니다. 내부용 파일명을 생성하고, 검증을 통과한 뒤에만 정식 저장 위치로 이동합니다. 어느 단계에서든 실패하면 임시 저장 파일을 정리해야 합니다. 사용자가 지정한 이름은 적절히 처리한 뒤 표시용 필드로만 사용합니다.

전체 파싱을 검증할 두 번째 샘플 세트 준비하기

형식 판별을 통과한 이미지도 ImageIO로 이미지 소스를 만들고 실제 이미지를 생성하는 과정을 거쳐야 합니다. 크기를 읽거나 이미지 소스를 생성할 수 있다는 사실만으로 이후 디코딩까지 성공한다고 볼 수는 없습니다. 먼저 너비와 높이, 총 픽셀 수, 프레임 수를 제한한 다음 필요한 프레임을 디코딩해야 합니다. 이렇게 해야 작은 압축 파일이 거대한 메모리 객체로 풀리는 상황을 막을 수 있습니다.

PDF는 PDFKit으로 문서 생성을 시도하고, 페이지 수와 암호화 상태, 접근해야 하는 페이지를 확인할 수 있습니다. 서비스에서 미리보기를 생성해야 한다면 대상 페이지를 실제로 렌더링해야 합니다. 문서 객체가 생성되었다고 해서 모든 페이지가 올바르게 표시된다는 뜻은 아닙니다.

실제로 유효한 파일과 함께, 헤더만 남긴 사본, 뒷부분을 잘라 낸 사본, 중간 바이트를 수정한 사본을 준비합니다. 잘린 샘플이라고 해서 하위 파서가 모두 거부하는 것은 아닙니다. 일부 파서는 손상된 내용을 허용하므로, 테스트는 ‘앱이 요구하는 작업을 완료할 수 있는가’를 기준으로 단언해야 합니다. 바이트가 조금이라도 바뀌면 반드시 실패해야 한다고 가정해서는 안 됩니다.

실패 원인을 추적 가능한 결과로 남기기

프로젝트의 테스트 타깃에 연결한 뒤에는 전송 실패, 알 수 없는 형식, 선언 불일치, 허용량 초과, 파싱 실패를 각각 구분해 보고합니다. 전부 ‘파일 손상’으로 묶으면 백엔드의 MIME 설정 오류와 클라이언트의 디코딩 문제를 구분할 수 없게 됩니다.

회귀 테스트마다 샘플 식별 번호, 실제 바이트 수, 정규화된 MIME, 후보 형식, 처리 단계를 기록합니다. 샘플은 민감한 내용이 없는 인공 생성 파일을 우선 사용합니다. 실패한 첨부 파일에 업무 데이터가 들어 있다면 테스트 보고서와 함께 자동으로 업로드해서는 안 됩니다.

마지막으로 세 가지를 확인합니다. 오류 페이지가 미리보기 도구로 전달되지 않는지, 잘린 샘플이 완전성 검증을 마친 파일로 취급되지 않는지, 실패 경로에서 정식 첨부 파일이 남지 않는지 살펴봅니다. 클라우드 Mac에서는 고정된 샘플과 시뮬레이터 흐름을 실행하고, 실제 기기에서 대용량 파일을 처리할 때의 메모리 동작은 별도로 검증해야 합니다. 두 결과를 나누어 기록해야 이 검증 관문이 정확히 무엇을 입증하는지 알 수 있습니다.

자주 묻는 질문

MIME 선언과 시그니처가 다르면 형식을 자동으로 바꿔도 되나요?

기본적으로 거부하고 불일치 원인을 기록하세요. 특정 엔드포인트가 의도적으로 일반 바이너리 형식을 반환한다면 해당 경로에만 예외를 두고 시그니처 검사와 전체 파싱은 유지해야 합니다.

시그니처가 맞으면 파일이 손상되지 않았다고 볼 수 있나요?

아닙니다. 잘린 파일에도 시그니처가 남을 수 있습니다. 이미지는 전체 디코딩을 확인하고, PDF는 파싱과 앱에서 요구하는 페이지 검사를 수행해야 합니다.

프로젝트에 맞는 Mac을 선택하세요

네이티브 빌드와 시뮬레이터 테스트가 필요하다면 Apple Silicon 전용 물리 Mac을 대여해 검증해 보세요. 장기간 전업으로 개발하며 한곳에서 사용할 계획이라면 직접 구매하는 방법도 비교해 볼 만합니다. 하루 단위로 먼저 사용해 보고, 꾸준히 이용할 때 월간 또는 분기 요금제를 고려해 보세요.

원격 Mac 대여

다음 단계: 프로젝트에 맞는 요금제 선택

기종, 이용 기간, 접속 방식을 먼저 확인한 뒤 대여 여부를 결정하세요.