작동 원리 및 구조
선택한 로컬 파일 바이트나 UTF-8 텍스트 버퍼를 `window.crypto.subtle.digest()`에 직접 전달해 `SHA-1`, `SHA-256`, `SHA-384`, `SHA-512` 다이제스트를 구합니다. 이후 `SHA256SUMS` 줄과 길이 정규화 XOR 비교를 수행하고, `crypto.subtle.sign('HMAC', ...)`으로 원시 HMAC 태그를 산출합니다.
단계별 사용 방법
로컬 파일(압축 파일, 바이너리, ISO)을 선택하거나 UTF-8 텍스트를 입력해 4가지 SHA 해시를 즉시 계산합니다.
공식 해시 문자열 또는 `sha256sum` 매니페스트 줄을 붙여넣어 MATCHED / MISMATCH 여부를 확인합니다.
Section 2에서 `HMAC-SHA256`, `HMAC-SHA512`, `HMAC-SHA1` 알고리즘과 `HEX` 또는 `BASE64` 인코딩을 고릅니다.
웹훅 시크릿 키와 원본 본문 페이로드를 입력해 API 서명을 로컬에서 재현합니다.
주요 기능 및 장점
- 하드웨어 가속 네이티브 Web Crypto 해싱으로 수백 MB 파일도 빠르게 처리
- SHA-256, SHA-512, SHA-384, SHA-1 해시값을 동시에 출력해 바로 복사 가능
- GNU `sha256sum` / `SHA256SUMS` 매니페스트 형식(`<hash> <filename>`) 깔끔하게 파싱
- HEX(GitHub/Stripe) 및 Base64(Shopify) 출력 형식을 모두 지원하는 HMAC-SHA256/512 생성기 내장
- 서버 노출 제로: 비공개 웹훅 시크릿 키와 미공개 릴리스 아티팩트 검증에 안전
계산 방식, 공식 및 기술 표준
비교 로직은 소문자 16진수 문자열에 대해 상수 시간 문자 XOR 누적을 사용하며, 표준 GNU coreutils 체크섬 형식(`hash *filename` 또는 순수 hex)과 호환됩니다.
실제 활용 사례
- 다운로드한 CLI 바이너리, 지갑 소프트웨어, OS 설치 이미지의 공식 체크섬 무결성 검증
- 서명 시크릿을 외부에 노출하지 않고 `X-Hub-Signature-256` 등 웹훅 HMAC 불일치 원인 디버깅
- 프로덕션 배포 전 S3/R2 아티팩트 무결성 매니페스트 검증
- curl / Insomnia 연동 테스트 중 빠른 API HMAC 요청 서명 생성
입출력 예시 및 엣지 케이스
SHA256SUMS Manifest Match
File digest vs `a948904f... release.tar.gz`
MATCHED — release.tar.gz
Ignores binary asterisk flags (`*filename`) and case differences.
Shopify vs GitHub HMAC Output
Secret + JSON payload -> Base64 vs Hex
Instant HMAC-SHA256 encoded to exact webhook header format
Always hash the exact un-prettified raw payload string bytes.
제한 사항 및 정확도 안내
- • 브라우저 Web Crypto(`SubtleCrypto`)는 충돌 취약점이 있는 구형 MD5를 의도적으로 제외하고 보안성이 높은 SHA-1/256/384/512를 지원합니다.
- • 수 기가바이트급 초대형 ISO 디스크 이미지(`>2 GB`)는 메모리 제한이 있는 브라우저에서 단일 `ArrayBuffer` 한도를 초과할 수 있습니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. SHA 해시 체크섬 & 웹훅 HMAC 서명 검증기 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
HMAC 서명 검증 결과가 서버 코드와 다르게 나올 때는 무엇을 확인해야 하나요?
서버가 원본 요청 바이트(`req.text()`)를 해시하는지 아니면 재직렬화한 JSON(`JSON.stringify()`)을 해시하는지 확인하고, `hex`와 `base64` 인코딩 형식이 맞는지 점검하세요.
200 MB 릴리스 파일을 선택하면 인터넷으로 파일이 전송되나요?
아니요. `file.arrayBuffer()`가 브라우저 RAM 안에서만 로컬로 읽히며 네트워크 전송은 전혀 발생하지 않습니다.
SHA-1보다 SHA-256이 권장되는 이유는 무엇인가요?
SHA-1은 실질적인 해시 충돌 취약점이 발견되었기 때문에 위변조 검증과 HMAC 서명에는 SHA-256 및 SHA-512가 업계 표준입니다.
여러 개의 체크섬 줄을 한 번에 검증할 수 있나요?
네. `SHA256SUMS` 블록 전체를 붙여넣으면 각 줄마다 MATCHED 또는 MISMATCH 결과를 개별 표시합니다.