---
kind: REFERENCE
slug: digest-must-be-length-framed-and-versioned
title: digest는 길이 프레이밍하고 버전을 붙인다
topic: owner-safe-state-machines
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: reference:digest-must-be-length-framed-and-versioned
verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
---

# digest는 길이 프레이밍하고 버전을 붙인다

## 목적

다이제스트가 서로 다른 입력에 대해 같은 값을 내거나, 구성이 바뀐 뒤 옛 값과 비교되는 것을 막는다.

## 규칙

1. 무엇을 덮는지가 정책이다
   다이제스트가 빠뜨린 입력은 두 개의 다른 대상이 같은 값을 낼 수 있는 입력이다. 그 목록은 구현 세부가 아니라 정책이므로 자기 타입을 갖는다.

2. 결과를 덮는다
   누가 언제 했는지만 덮으면 무엇을 했는지가 다른 두 전이가 같아진다.

3. 길이 프레이밍한다
   구성 요소가 가변 길이 텍스트이고 그중 하나라도 이 플랫폼이 제약할 수 없는 값이면, 구분자로 이었을 때 서로 다른 목록이 한 문자열로 렌더링될 수 있다.

4. 버전을 붙이고 구성이 바뀌면 올린다
   저장된 다이제스트가 구성 경계를 넘어 비교되지 않게 한다.

5. 비교 실패를 조용히 처리하지 않는다
   버전이 다르면 같다고도 다르다고도 결론 내리지 않는다.

## 적용 조건

재생 판정이나 중복 판정에 쓰이는 모든 다이제스트

멱등성 키와 요청 지문

## 예외

캐시 키처럼 충돌이 성능 문제일 뿐 정확성 문제가 아닌 경우는 이 규칙이 과하다.

## 예시

전이 다이제스트가 전이 종류와 연산과 소유자와 시도와 리비전만 덮어, 재시도 가능한 실패와 포기한 실패가 같은 값을 냈다. 서로 다른 응답을 담은 두 완료도 마찬가지였다.

소유자 토큰은 이 플랫폼이 형식을 제약하는 값이 아니므로 길이 프레이밍이 필요하다.

## 관계

- **transition digest가 누가와 언제만 덮고 무엇을 덮지 않아 다른 전이를 같다고 보고했다**
  이 규칙을 만든 사례다.
- **서명된 커서의 구조와 검증 순서**
  같은 계열의 형식 결정을 다룬다.