파이썬 파일입출력으로 배우는 manifest.json 해시 목록 생성과 검증 자동화

📂 파이썬 파일입출력 기본 이해

파이썬에서 파일을 다루는 방법은 매우 직관적이면서도 강력합니다.
파일을 읽거나 쓰기 위해서는 open() 함수를 활용하며, 모드(mode)에 따라 읽기 전용, 쓰기 전용, 추가 모드 등을 지정할 수 있습니다.
텍스트 파일과 바이너리 파일 모두 지원하기 때문에 단순한 로그 저장부터 이미지, 동영상 같은 데이터 처리까지 폭넓게 활용할 수 있습니다.

파일을 열고 나면 read(), readline(), write(), writelines() 같은 메서드를 이용하여 데이터를 조작할 수 있습니다.
또한 파일 처리가 끝나면 반드시 close()를 호출하여 리소스를 해제하는 습관이 필요합니다.
다만 파이썬에서는 with 구문을 이용하면 자동으로 파일을 닫아주기 때문에 더 안전하고 깔끔한 코드를 작성할 수 있습니다.

📝 파일 읽기와 쓰기 예제

# 텍스트 파일 쓰기
with open("example.txt", "w", encoding="utf-8") as f:
    f.write("Hello Python File I/O")

# 텍스트 파일 읽기
with open("example.txt", "r", encoding="utf-8") as f:
    content = f.read()
    print(content)

위 코드는 간단히 파일에 문자열을 저장한 뒤 다시 불러와 출력하는 예제입니다.
이처럼 파이썬의 파일입출력은 단 몇 줄의 코드만으로도 구현이 가능하다는 장점이 있습니다.
이 기초 개념을 이해하면 manifest.json 같은 구조화된 파일을 생성하고 검증하는 작업도 훨씬 쉽게 접근할 수 있습니다.

🔑 해시(Hash)와 무결성 검증 원리

해시(hash)는 임의의 데이터를 고정된 길이의 문자열로 변환하는 알고리즘을 말합니다.
파일 무결성을 확인하는 대표적인 방법으로 많이 쓰이며, 원본과 동일한 해시값이 나오는지 비교함으로써 파일이 손상되었는지 여부를 쉽게 알 수 있습니다.
즉, 파일이 수정되거나 일부만 바뀌어도 해시값은 완전히 달라지기 때문에 작은 변조도 즉시 탐지할 수 있습니다.

대표적인 해시 알고리즘으로는 MD5, SHA-1, SHA-256 등이 있으며, 최근에는 보안성을 강화하기 위해 SHA-256 이상의 알고리즘이 주로 사용됩니다.
파이썬에서는 hashlib 라이브러리를 활용해 손쉽게 해시값을 계산할 수 있습니다.

🔍 파이썬에서 SHA-256 해시 계산

import hashlib

def get_file_hash(path):
    sha256 = hashlib.sha256()
    with open(path, "rb") as f:
        while chunk := f.read(8192):
            sha256.update(chunk)
    return sha256.hexdigest()

print(get_file_hash("example.txt"))

위 함수는 지정된 파일을 읽으면서 SHA-256 해시를 계산하여 16진수 문자열로 반환합니다.
8192 바이트 단위로 데이터를 읽는 이유는 대용량 파일 처리 시 메모리를 효율적으로 사용하기 위함입니다.

이처럼 해시 알고리즘을 이용하면 단순 비교가 아닌, 암호학적 안정성을 기반으로 한 무결성 검증을 수행할 수 있습니다.
이제 이런 해시값을 모아서 manifest.json 파일로 관리하면 대규모 프로젝트에서도 파일 무결성을 효율적으로 관리할 수 있습니다.

⚙️ manifest.json 생성 파이썬 코드 예제

이제 본격적으로 파일들의 해시값을 계산하고 이를 manifest.json 형태로 저장하는 방법을 살펴보겠습니다.
이 JSON 파일은 각 파일의 경로와 해시값을 한눈에 관리할 수 있는 일종의 ‘파일 무결성 목록표’ 역할을 합니다.
프로젝트 내 파일이 수십, 수백 개로 늘어나더라도 자동으로 정리해 두면 이후 검증 과정이 훨씬 간단해집니다.

🛠️ manifest.json 생성 코드

import os
import json
import hashlib

def get_file_hash(path):
    sha256 = hashlib.sha256()
    with open(path, "rb") as f:
        while chunk := f.read(8192):
            sha256.update(chunk)
    return sha256.hexdigest()

def create_manifest(directory, output="manifest.json"):
    manifest = {}
    for root, _, files in os.walk(directory):
        for file in files:
            path = os.path.join(root, file)
            manifest[path] = get_file_hash(path)
    with open(output, "w", encoding="utf-8") as f:
        json.dump(manifest, f, indent=4, ensure_ascii=False)

create_manifest("./data")

위 코드는 ./data 폴더 내 모든 파일의 SHA-256 해시값을 계산해 manifest.json에 저장합니다.
실행 후 생성된 JSON 파일에는 파일 경로와 해시값이 키-값 형태로 정리됩니다.

이처럼 manifest.json은 단순한 텍스트 파일이지만, 프로젝트 전반의 파일 무결성을 관리하는 강력한 도구로 활용됩니다.
이제 다음 단계에서는 이렇게 생성된 파일을 활용하여 실제 검증 작업을 자동화하는 방법을 살펴보겠습니다.

🛠️ manifest.json 검증 배치 스크립트

manifest.json 파일을 생성했다면 이제 중요한 단계는 실제 파일이 원본 그대로인지 확인하는 과정입니다.
이를 위해 검증 스크립트를 작성하여 현재 파일들의 해시값을 계산하고 manifest.json에 기록된 값과 비교할 수 있습니다.
만약 불일치가 발생한다면 해당 파일이 손상되었거나 수정되었음을 즉시 확인할 수 있습니다.

🔎 manifest.json 검증 코드

import os
import json
import hashlib

def get_file_hash(path):
    sha256 = hashlib.sha256()
    with open(path, "rb") as f:
        while chunk := f.read(8192):
            sha256.update(chunk)
    return sha256.hexdigest()

def verify_manifest(directory, manifest_file="manifest.json"):
    with open(manifest_file, "r", encoding="utf-8") as f:
        manifest = json.load(f)

    for path, expected_hash in manifest.items():
        if not os.path.exists(path):
            print(f"❌ 누락된 파일: {path}")
            continue
        current_hash = get_file_hash(path)
        if current_hash != expected_hash:
            print(f"⚠️ 해시 불일치: {path}")
        else:
            print(f"✅ 검증 완료: {path}")

위 코드를 실행하면 manifest.json에 기록된 파일 목록과 현재 파일 상태를 비교하여 문제가 있는 경우 경고를 표시합니다.
이를 통해 손상, 변조, 누락 여부를 신속하게 파악할 수 있습니다.

• 📌누락된 파일을 즉시 확인할 수 있습니다.
• ⚠️해시값 불일치로 수정 여부를 알 수 있습니다.
• ✅원본과 동일한 경우 정상 파일임을 보장합니다.

💡 실무에서의 활용 사례와 응용

manifest.json을 통한 파일 무결성 검증은 단순한 연습용 프로젝트를 넘어 다양한 실무 환경에서 널리 활용됩니다.
특히 데이터가 대량으로 오가는 시스템이나, 보안이 중요한 서버 환경에서는 파일 변조 여부를 빠르게 확인하는 것이 필수적입니다.
이러한 자동화 검증 체계는 업무 효율성과 안정성을 동시에 확보해 줍니다.

🏢 기업 및 서버 운영 환경에서의 활용

기업 서버에서는 정기적으로 수천 개 이상의 파일이 업데이트됩니다.
이때 배포 과정에서 누락이나 변조가 발생하면 서비스 장애로 이어질 수 있습니다.
따라서 manifest.json을 활용한 검증 배치 스크립트는 배포 전 무결성 점검 절차에 포함되어 장애 예방에 큰 역할을 합니다.

📦 백업 및 데이터 관리

대용량 데이터를 다루는 경우 백업 파일의 무결성 확인은 매우 중요합니다.
해시 검증을 통해 원본과 백업 파일이 동일함을 보장할 수 있으며, 재해 복구(DR) 시스템에서도 핵심적인 역할을 합니다.

🔐 보안 및 디지털 포렌식

파일 무결성 검증은 사이버 보안 분야에서도 중요한 역할을 합니다.
예를 들어, 로그 파일이나 증거 자료가 변조되지 않았음을 보장해야 하는 디지털 포렌식 환경에서는 해시값 비교가 필수적입니다.
이 과정에서 manifest.json은 디지털 증거의 신뢰성을 보강하는 도구로 활용됩니다.

💬 manifest.json은 단순한 텍스트 파일이지만, 신뢰할 수 있는 데이터 관리 체계를 구축하는 데 있어 핵심적인 역할을 수행합니다.

이처럼 manifest.json은 개발자뿐만 아니라 서버 관리자, 보안 담당자에게도 매우 유용한 도구입니다.
파일의 무결성을 관리하는 체계를 확립하면 서비스 품질은 물론 신뢰도까지 높일 수 있습니다.

❓ 자주 묻는 질문 (FAQ)