테스트 증거의 관리 이력이란 무엇인가요?
테스트 증거의 관리 이력은 실행 후 테스트 결과와 관련 파일이 변경되지 않았음을 입증하는 기록입니다. Verdict System LLC의 Nexus StudioQA는 사용자가 선택하면 이를 추가만 가능한 원장으로 관리합니다: 증거 폴더의 모든 파일을 SHA-256으로 해시하고 이전 기록과 연결하므로, 검사 시 처음 변경된 기록을 식별할 수 있습니다.
최종 업데이트:
작성: Verdict System LLC의 Nexus StudioQA 팀.
팀에 관리 이력이 필요한 이유는 무엇인가요?
실패한 테스트는 버그 보고서, 출시 결정 또는 감사 항목으로 이어지며, 몇 주 뒤 누군가 스크린샷과 보고서가 실제 실행에서 생성된 것인지 물을 수 있습니다. 디스크에 있는 폴더만으로는 아무것도 입증할 수 없습니다: 안에 있는 파일은 무엇이든 수정할 수 있기 때문입니다. 관리 이력이 있으면 누구나 명령 하나로 변경 여부와 변경된 기록을 확인할 수 있습니다.
어떻게 작동하나요?
- 기록은 metadata.json이 들어 있는 증거 폴더입니다. 예를 들어 BREACHED 상태로 끝난 실행이 남기는 보고서, 스크린샷, 로그가 담긴 폴더가 이에 해당합니다.
- 폴더의 각 파일은 SHA-256으로 해시되며, 기록의 해시에는 이전 기록의 해시도 포함됩니다. 파일 하나의 1바이트만 변경해도 해당 기록과 그 이후 모든 기록의 무결성이 깨집니다.
- 기록은 증거 옆에 있는 추가 전용 원장 하나,
evidence/chain-of-custody/ledger.jsonl에 저장되며 절대 잘라내지 않습니다. Node.js의 내장 crypto만 사용하며 사용자 컴퓨터에서 실행됩니다. - 봉인은 선택 사항입니다. Studio에서 처음으로 실제 버그 또는 오탐으로 판정하면 그 사유와 함께 체인에 추가되면서 시작됩니다. 또는
nexus verify --seal로 시작할 수 있습니다. - 원장이 없으면 검사는 UNVERIFIED를 보고하고 실패합니다. 증거가 없다는 것은 입증이 아니므로, 아무 설명 없이 OK를 보고하는 일은 없습니다.
실제 실행에서는 어떻게 표시되나요?
다음은 엔진 자체 명령으로 증거 폴더 두 개를 검사한 출력이며, 2026-11-06에 기록되었습니다. 하나는 Chromium에서 BREACHED 상태로 끝난 실행이고, 다른 하나는 Firefox에서 TIMEOUT 상태로 끝난 실행입니다. 세 번째와 네 번째 명령 사이에 TC101의 report.md 한 줄을 수동으로 수정했습니다.
> nexus verify
🔗 Nexus StudioQA — Evidence Chain of Custody (SHA-256, on-prem)
⚠️ UNVERIFIED — no ledger — run `nexus verify --seal` first (UNVERIFIED, not OK)
> nexus verify --seal
✅ SEALED 2 record(s) → evidence\chain-of-custody\ledger.jsonl
tip: bcc9f551e102aa6b0593bbab23e794d2da62934d58dcd27464fa322962338571
> nexus verify
✅ VERIFIED — verified 2 record(s), all artifacts intact
(report.md of TC101 edited by hand)
> nexus verify
❌ TAMPER DETECTED — evidence altered after sealing at record 0: TC101_chromium_2026-11-06_10-15-02 [BREACHED]
record: TC101 / chromium [BREACHED] — TC101_chromium_2026-11-06_10-15-02 [BREACHED]
검사는 미검증 상태일 때 종료 코드 2, 검증되었을 때 0, 수정 사항을 발견했을 때 1로 종료되므로, 변조 시 CI 작업이 실패하도록 할 수 있습니다.
네 가지 상태는 무엇인가요?
| 상태 | 의미 | 필요한 조치 |
|---|---|---|
| UNVERIFIED | 아직 원장이 없어 아무것도 입증할 수 없음 | 봉인하거나 처음으로 실제 버그 또는 오탐으로 판정 |
| VERIFIED | 봉인된 모든 기록과 파일이 해당 해시와 일치함 | 없음 |
| TAMPER DETECTED | 봉인 후 파일이나 원장의 한 줄이 변경됨; 무결성이 처음 깨진 기록이 표시됨 | 해당 폴더를 신뢰할 수 있는 사본과 비교 |
| PURGED | 봉인된 폴더가 의도적으로 삭제되었으며, 삭제한 사람과 시점이 원장에 기록됨 | 없음; 원장은 여전히 해당 폴더의 해시값을 입증함 |
오래된 증거를 정리하면 어떻게 되나요?
디스크 사용 한도, 보관 정책 또는 디스크 공간 확보 기능이 봉인된 폴더를 삭제하기 전에, 엔진은 삭제한 사람과 시점을 명시한 PURGE 항목을 원장에 추가합니다. 그러면 검사는 해당 기록을 변조된 것으로 보지 않고 PURGED로 보고합니다. 원장에 PURGE를 기록할 수 없으면 폴더는 그대로 유지됩니다. 사용 한도에 대한 설명은 저장 공간 및 자체 유지 관리를 참조하세요.
어떤 한계가 있나요?
- 봉인 후 파일이 변경되지 않았음을 입증합니다. 봉인 전부터 올바른 파일이었다는 뜻은 아닙니다: 수정 후 기록을 봉인하면 수정된 내용이 봉인됩니다.
- 봉인된 기록만 보호 대상입니다. 최초 봉인 전에 작성된 증거는 봉인할 때까지 UNVERIFIED 상태로 유지됩니다.
- 원장은 증거와 같은 디스크에 있습니다. 양쪽 모두에 쓰기 권한이 있는 사람은 전체 체인을 다시 만들 수 있으므로, 봉인 시 출력되는 마지막 해시를 티켓이나 출시 안내 등 다른 곳에 보관하고 나중에 비교하세요.
어디에서 볼 수 있나요?
증거 페이지에서는 실패한 테스트 하나가 남기는 모든 파일을 살펴보며, 용어집에서는 UNVERIFIED와 실제 버그 또는 오탐 판정을 정의합니다. 무료 체험판에서는 동일한 엔진으로 직접 만든 테스트를 실행할 수 있습니다.