DongHyeonkaandClaude Opus 5
b2963105a8
The keycloak project ended with four open questions that design could not
settle. A two-VM lab was built to answer them by measurement, and this is
that material: 26 experiments, 125 raw command outputs, 22 browser captures.
Follows the import procedure in README.md.
source/ the originating repository verbatim — 78 documents, 28 SVGs,
8 manifests, plus .source-revision recording the commit
final/ the SSOT
document.md 729 lines written from the 29 experiment documents, not
concatenated: what was predicted, what was measured, and
where the measurement itself was wrong
evidence/raw 125 outputs, flattened to <experiment>__<file> because
the originals collided (01-baseline.txt appeared three
times) and the audit only globs the top level
evidence/meta one per raw file; command and exitCode are null and the
README says why rather than inventing them
evidence/browser 22 captures
assets/ three diagrams through techviz
.techviz/ their VizSpecs
A separate project rather than an addition to keycloak: the B-layer answers
that project's four questions, but the A, C and D layers are about cluster
failure, SSO and operations, and one document.md should hold one subject.
The four question records there can point here through 관계.
Recorded rather than papered over: only three of the 28 diagrams were
remade. The repository forbids hand-drawn SVG and forbids titles inside the
canvas; all 28 originals carry both, so converting them is redrawing, not
reformatting. They stay in source/ and the gap is written into the document.
verify-pipeline.py passes. audit-records.py reports no issues.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
59 lines
2.4 KiB
Markdown
59 lines
2.4 KiB
Markdown
---
|
|
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가 누가와 언제만 덮고 무엇을 덮지 않아 다른 전이를 같다고 보고했다**
|
|
이 규칙을 만든 사례다.
|
|
- **서명된 커서의 구조와 검증 순서**
|
|
같은 계열의 형식 결정을 다룬다.
|
|
|