Files
clean-architecture-frontend…/docs/security/supply-chain.md
T
DongHyeonka 06ffafa25e docs: 살아 있는 문서의 낡은 문장을 지금 코드와 정본에 맞춘다
2026-11-07~08의 정리(문서 이동, 참조 기능 삭제, CI 재편) 뒤 살아 있는
문서가 지금 코드와 다른 말을 한다.

- 현재 계약 문서 둘과 스타터 문서가 기록(docs/design/)을 정본으로
  가리킨다. 정본을 frontend-application-foundation.md·src/bootstrap/,
  패턴 표·계층 규칙으로 바꾸고 설계서는 배경으로 둔다(1112/02-06).
- 실시간 대응표 둘(짝 백엔드 출구, poll attempt 결과)이 기록에만 있었다.
  optional-adapter-recipes.md로 옮기고 코드 주석·매뉴얼 03·설계서 머리
  블록이 옮긴 곳을 가리킨다(1112/09-02).
- 실행 격리 변수 목록을 설계 기록이 아니라 scripts/lib/run-isolation.ts로
  가리킨다(1112/08-17).
- 계약 소유 절 이름(「판단 규칙」), pin 대조 시험의 게이트(005·007),
  drift 검사 범위(1112/02-07). INVENTORY 머리의 손 숫자와 지킬 수 없는
  꼬리 문장(1112/02-08).
- 검증 안내: 검사기를 바꾸면 FE-GATE-029, 문서면 desktop
  verify:documentation(1112/08-05, 08-04). FE-GATE-012는 merge 단계다
  (08-16). N6이 알리는 파일을 좁혀 적는다(08-10). 한 파일 시험은
  verify.sh exec(08-11). 문서 검사 범위의 손 사본을 정본 한 곳으로(08-07).
- create:feature 참조의 Next: 3과 되돌리기(08-08), 손으로 옮긴 숫자
  (08-19), 라운드 없는 리뷰 ID 17곳에 0925를 붙인다(08-15).
- secret scan 범위 설명(1112/07-03), lab이 기능 라우트를 읽는 문장
  (1103/16-06), README 동기화 기준점·제품 소유 파일·선택 기능 결함 몫
  (0929/14-02, 14-03, 13-10), 커밋을 다시 지은 모든 통합의 해시 대조
  (1106/14-02).

고른 방법: 문장을 코드에 맞춘다. 표는 옮기고 숫자는 정본을 가리킨다.
버린 대안: 기록 문서 본문 고치기(기록은 머리 블록만 고친다).

위험·한계: 문서 검사 범위 목록을 지운 ci-quality-gates.md는 이제
docs/README.md 5절과 gates.md 7절을 읽어야 한다. 매뉴얼 02 7절 업로드
예의 declare module 문제(1112/09-01)는 고치는 방향이 check:architecture
규칙과 부딪쳐 결정 대기로 남긴다.

검증: scripts/verify.sh docs(노트북) 통과. desktop verify:documentation과
FE-GATE-005(문서를 읽는 시험)는 PR 본문에 적는다.

Refs: 1112/02-06, 1112/02-07, 1112/02-08, 1112/07-03, 1112/08-04,
 1112/08-05, 1112/08-07, 1112/08-08, 1112/08-10, 1112/08-11, 1112/08-15,
 1112/08-16, 1112/08-17, 1112/08-19, 1112/09-02, 1103/16-06, 0929/14-02,
 0929/14-03, 0929/13-10, 1106/14-02
2026-11-12 23:36:14 +09:00

28 KiB

빌드·공급망 gate

로컬 차단 통제

  • pnpm install --frozen-lockfile --ignore-scripts, 그리고 manifest와 lock이 실제로 어긋나는 fixture. contract를 읽을 때 등록된 모든 명령에 root 전용 그래프 정책과 lifecycle 정책을 적용한다. gate runner가 명령을 띄우기 전이다. 실제로 효력이 있는 --ignore-scripts 없이 하는 중첩 설치는 거부한다. npm script를 따라갈 때는 이미 있는 pre/post hook도 따라간다. 단, 순서상 앞에 있는 --ignore-scripts가 hook을 막으면 따라가지 않는다. 값 없이 쓴(bare) 경우와 명시적으로 true를 준 경우가 그렇다. workspace·prefix 설정 권한과 간접적인 user·global 설정 권한은 다음 어디에 있어도 거부한다: npm 옵션, 직접 할당이나 동적 할당, 정확한 command/exec/env 접두 체인, segment를 넘나드는 shell 상태, 물려받은 runner 환경. 알 수 없거나 cwd를 바꾸는 env 옵션, 그리고 구분자 앞의 따옴표 없는 경로 확장은 허용하지 않고 실패한다(fail closed). 명시적으로 모델링한, scope와 무관한 env 옵션은 계속 쓸 수 있다
  • 직접·전이 의존성의 lockfile 행 전부와 각 패키지의 SHA-512 integrity
  • production/development, 직접/전이, platform 선택(platform-optional) 분류
  • 패키지 manifest license의 허용·거부 정책
  • 승인된 inventory baseline digest와 실제 추가·삭제·변경·업그레이드 diff
  • 새 직접 production 의존성에 대한 독립 리뷰
  • CycloneDX 1.6 SBOM, 그리고 inventory와의 component·edge 일치
  • source·lock·SBOM·dist를 묶은 local provenance 문서(statement)
  • secret scan. 대상은 추적되는 파일 전부(git ls-files, 문서와 .env.example 포함)와 빌드된 dist, 생성된 artifacts/release다(scripts/lib/repository-file-inventory.ts). 정책의 trackedRoots는 대상을 좁히지 않는다. 비어 있으면 안 되는 루트 목록이다
  • 두 번 빌드해 비교하는 SOURCE_DATE_EPOCH 재현성 검사

기준 명령은 다음과 같다.

corepack pnpm verify:lockfile
corepack pnpm verify:reproducible-build
corepack pnpm build:release-candidate
corepack pnpm verify:local-evidence
corepack pnpm check:supply-chain:fixtures

승인된 로컬 baseline은 config/security/dependency-baseline.json이다. 이것을 바꾸려면 DEPENDENCY_BASELINE_OWNER와 DEPENDENCY_BASELINE_REASON이 있어야 한다. digest를 직접 고치거나 빈 diff를 하드코딩하면 거부한다.

무엇을 증명하고 무엇을 증명하지 않는가

리뷰 0925/13-12. 산출물마다 증명 범위가 다르다. 아래 "증명하지 못하는 것"을 증명된 것으로 읽지 않는다.

산출물 증명하는 것 증명하지 못하는 것
SBOM(artifacts/release/sbom.cdx.json) lockfile에 고정된 설치 그래프(pnpm list --depth Infinity, scripts/generate-supply-chain.ts)와 각 패키지의 sha512 integrity, license 배포물에 실제로 들어간 부분 집합, 취약점 없음
번들 패키지 목록(artifacts/quality/vite-module-inventory.json의 packages) 배포 번들에 모듈이 하나 이상 들어간 패키지의 name@version. Vite가 번들에 넣은 모듈에서 바로 만든다(scripts/lib/vite-module-inventory.ts) 패키지 안의 어떤 코드가 실행되는지, 취약점 없음
local provenance(artifacts/release/provenance.json) dist digest, lockfile, source set, SBOM digest가 서로 맞음 빌드 과정이 변조되지 않았음, 빌드한 주체. 서명이 없는 자기 보고다(builder.id가 local:, invocationId가 LOCAL_UNSIGNED). predicateType이 SLSA provenance v1이어도 SLSA 수준을 뜻하지 않는다
외부 provenance 서명 지정 키 보유자가 이 run, source revision, 후보 digest를 보고 서명함 빌드 job 자체의 격리, provider가 성실히 검사했음
외부 vulnerability 서명 provider가 이 lockfile·dist에 대해 결과를 주장함 오프라인 DB의 최신성, 누락 없음

번들 패키지 목록은 SBOM의 production 항목에 모두 들어 있어야 한다. 2026-09-25 기준으로 한 건이 어긋난다. scheduler@0.27.0은 react-dom의 의존성이라 번들에 들어가지만, SBOM과 config/security/dependency-baseline.json은 이것을 development로 분류한다. pnpm list JSON이 production 트리 아래에서 이 패키지를 다시 보여 주지 않고, 그래서 scripts/lib/supply-chain.ts의 순회가 development 경로에서만 이것을 만난다. 분류를 고치면 dependency baseline을 다시 승인해야 하므로 (update:dependency-baseline) 이 문서에 알려진 차이로 남긴다.

최소 구성과 전체 구성

리뷰 0925/13-13. 승격 단계까지 쓰려면 이 문서 아래의 runner 조건(bwrap, prlimit, systemd-run, systemd user manager 254 이상, cgroup v2 위임)과 오프라인 데이터로 Ed25519 서명 보고서를 내는 provider 두 개가 필요하다. 이 repo는 그 환경에서 workflow 전체를 한 번도 돌리지 않았다. 그래서 두 구성을 나눠 적는다.

구성 켜는 것 보장하는 것 보장하지 않는 것
최소 구성(provider 없음) merge·release stage 게이트, immutable_build(FE-GATE-015·027). provider 변수는 비워 둔다 lockfile 무결성과 설치 스크립트 차단, SBOM과 local provenance의 digest 정합, secret scan, 재현 빌드, 후보 archive의 exact member와 digest, release 대상 환경 승인(FE-GATE-027) 외부 취약점 검사, 서명된 provenance. provider job은 명령과 키가 없어 실패하고, promotion job은 두 provider job의 성공을 요구하므로 돌지 않는다. 승격은 사람이 결정한다
전체 구성 위 전부와 vulnerability_provider·provenance_provider·promotion job, 아래 runner 조건과 provider 키 위 전부와, 지정 키 보유자가 이 후보 digest·run·source에 서명했다는 것, 승격된 exact-five bundle(verify:promotion) provider가 성실히 검사했는지, 빌드 job 격리(위 "무엇을 증명하고" 표 참고)

최소 구성으로 운영할 때 승격은 수동 승인이다. 승인자는 immutable_build가 올린 후보 archive의 SHA-256(job output archive_sha256)과 local evidence를 기록하고, 그 archive를 그대로 배포한다. 다시 빌드하지 않는다. production_gate는 promotion 뒤에만 돌므로 이 구성의 workflow에서는 실행되지 않는다. 운영 게이트(FE-GATE-019, 021~025)는 배포한 release를 대상으로 corepack pnpm ci:gate -- FE-GATE-0xx로 따로 돌려 기록한다.

provider 신뢰 키 교체와 폐기

신뢰 키는 repo 변수 VULNERABILITY_PUBLIC_KEY_PATH·VULNERABILITY_KEY_ID, PROVENANCE_PUBLIC_KEY_PATH·PROVENANCE_KEY_ID가 가리키는 공개 키 파일이다 (scripts/lib/provider-trust.ts). 두 provider는 서로 다른 키를 써야 한다 (assertDistinctProviderTrust). 승격 기록은 키 ID·지문과 trust policy SHA-256을 남긴다.

교체 순서:

  1. provider가 새 키 쌍을 만들고 공개 키만 넘긴다.
  2. 새 공개 키 파일을 runner가 읽을 수 있는 경로에 두고, 두 변수를 새 경로와 새 key ID로 한꺼번에 바꾼다. 키 ID는 새 값을 쓴다. 이전 ID를 재사용하면 기록만 보고 어느 키였는지 구분할 수 없다.
  3. provider 쪽 서명 키를 새 키로 바꾼 뒤 release를 한 번 돌려 promotion이 통과하는지 확인한다.
  4. 이전 공개 키 파일은 지우지 않고 보관한다. 이전 키로 승격된 release를 나중에 배포하거나 그 release로 롤백할 때 verify:promotion -- --archived가 그 키를 요구한다(docs/operations/release-cache-rollback.md).

폐기 순서(키 유출 등):

  1. 해당 변수에서 그 키를 즉시 뺀다. 그 키로 서명된 새 승격은 이때부터 실패한다.
  2. 보관 중인 이전 공개 키 파일도 지운다. 그 키로만 서명된 과거 release는 verify:promotion -- --archived를 통과하지 못한다.
  3. 그런 release를 다시 써야 하면 새 키로 provider 검증을 다시 받는다. 같은 후보 archive를 대상으로 한 새 provider 실행이 필요하고, 다시 빌드하지 않는다. 이 repo에는 이 재검증 전용 job이 없다. 필요한 프로젝트가 만든다.

외부 승격(promotion) 통제

승격은 VULNERABILITY_REPORT_PATH와 PROVENANCE_ATTESTATION_PATH가 가리키는 provider 파일을 읽는다. 취약점 보고서(vulnerability report)는 정확한 lockfile digest와 후보 distSha256을 둘 다 묶어야(bind) 한다. provenance attestation은 같은 digest로 dist를 명시해야 한다. 두 문서 모두 엄격한 schema와 Ed25519 서명을 쓴다. 서명은 따로 설정한 신뢰 공개 키와 key ID(VULNERABILITY_PUBLIC_KEY_PATH, VULNERABILITY_KEY_ID, PROVENANCE_PUBLIC_KEY_PATH, PROVENANCE_KEY_ID)로 검증한다. 다른 curve의 키는 거부한다. 문서가 알고리즘을 Ed25519라고 적어도 Ed448 키 같은 것은 거부한다. 두 역할은 서로 다른 key ID와 서로 다른 canonical DER-SPKI 키 바이트를 써야 한다. 같은 키에 ID 두 개를 붙여도 거부한다.

immutable_build는 다음을 한 번만 archive로 묶는다: 가공하지 않은 pnpm-lock.yaml, dist(숨은 .vite 파일 포함), build manifest, module inventory, release 검증 결과, secret scan 결과, 로컬 공급망 증거. 후보 manifest는 가공하지 않은 lockfile 바이트의 hash를 구하고, 그 digest가 의존성 inventory의 lockfileSha256과 같기를 요구한다. 올리기 전에 만드는 쪽(producer)은 manifest에 묶인 정확한 archive member 집합과 member마다의 digest를 검증한다. 그다음 archive SHA-256을 바뀌지 않는 job output으로 내보낸다. 두 provider job은 같은 archive를 각자 내려받아 그 output digest와 비교한다. 정확한 member 집합을 검증한 뒤 격리된 root에만 풀고, CANDIDATE_LOCKFILE_PATH와 CANDIDATE_DIST_SHA256을 받는다. 설정된 VULNERABILITY_PROVIDER_COMMAND와 PROVENANCE_PROVIDER_COMMAND는 서명된 보고서를 내야 한다. 외부 명령이 하나 끝날 때마다 provider upload 검증이 다음을 한다: archive와 풀어 둔 후보가 바뀌지 않았는지 다시 확인하고, provider JSON을 엄격한 schema로 파싱하고, 올리기 전에 그 dist digest와 lockfile digest를 묶는다.

provider 입력이 하나라도 없으면 로컬 검증은 여전히 의미가 있다. 다만 artifacts/security/supply-chain-verification.json에 promotionStatus: FAIL_UNVERIFIED가 기록된다. 그러면 finalizer와 뒤에 오는 verify:promotion exact-five 검증기가 0이 아닌 코드로 끝난다. 승격은 후보 파일 집합과 digest를 붙잡아 둔(captured) tar 바이트에서만 얻는다. 그다음 읽기 전용으로 다음을 다시 검증한다: archive에 든 실행 schema, archive에 든 policy·verifier source 바이트, 가공하지 않은 lockfile, module inventory, build 출력, release 일관성, SBOM, provenance, 공급망 일관성. 후보 내부 검사는 다시 계산한다. checkout에 따라 달라지는 secret scan은 승격이 따로 확인한다: archive에 든 policy, 정확한 rule 집합, 엄격한 SARIF, 발견 0건, manifest·assessment digest 연결 전부. 후보 member가 아닌 source 바이트를 다시 검사했다고 주장하지 않는다. 후보 증거를 다시 빌드하거나 다시 쓰지 않고, checkout tree로 대신 가지도 않는다. 승격은 이미 검증한 archive 자체를 provider 보고서 두 개, 생성된 검증 기록과 함께 올린다. 풀어 둔 파일로 대체 archive를 만들지 않는다. scanner나 서명 서비스가 멈춰도 빈 PASS로 바꾸지 않는다.

생성된 workflow도 공급망 통제다. 그 workflow의 유일한 타입 있는 원천(typed authority)은 config/ci/gates.json이다. contract를 바꾼 뒤 corepack pnpm generate:ci-workflow를 돌린다. 그리고 corepack pnpm check:ci-workflow(또는 이것을 포함하는 corepack pnpm check:ci)로 commit된 Gitea adapter의 바이트 어긋남을 거부한다.

action 해석은 따로, scripts/contracts/ci-gates.ts에 있는 타입 있는 registry 하나 안에서만 닫혀 있다. 이 registry는 runtime에 얼려 둔다(frozen). 생성된 uses: 값은 모두 전체 commit SHA로 고정한 절대 upstream URL이다.

  • https://github.com/actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 (v4.3.1)
  • https://github.com/actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 (v4.4.0)
  • https://github.com/ChristopherHX/gitea-upload-artifact@81f940d004763f986ba3582c007fd842dd5cb0d7 (패치한 v4 branch)
  • https://github.com/ChristopherHX/gitea-download-artifact@75635f32b4c1c41c4b3d64e8f85210112ed4c9c7 (패치한 v4 branch)

알 수 없는 action, 상대 repository, tag·branch, 짧은 SHA는 거부한다. Gitea 1.22 공식 Actions 문서는 v4 호환을 위해 ChristopherHX가 패치한 artifact fork를 권한다. 그래도 지원하는 배포 기준선은 Gitea 1.26.4 이상과 Gitea Runner 1.0.0 이상이다. 생성된 job을 필수 검사(required check)로 만들기 전에 staging Gitea 인스턴스에서 실제 end-to-end provider smoke를 꼭 돌려야 한다.

외부 provider 감독은 fail closed다. 다음을 갖춘 Linux runner가 필요하다: 실행할 수 있는 /usr/bin/bwrap, /usr/bin/prlimit, /usr/bin/systemd-run, /usr/bin/systemctl, --size를 지원하는 bubblewrap, 동작 중인 user bus, 254 이상인 systemd user manager, 통합(unified) cgroup v2, 위임된 memory·pids·CPU controller. runner는 권한 없는 프로세스가 bubblewrap으로 user namespace와 network namespace를 만들 수 있게도 해야 한다. sandbox는 bwrap --unshare-pid --unshare-ipc --unshare-uts --unshare-net을 실행한다. Ubuntu 23.10 이상은 kernel.apparmor_restrict_unprivileged_userns=1이면 이것을 거부한다. 단, /usr/bin/bwrap에 userns를 허용하는 AppArmor profile이 있으면 허용한다(1105/12-01). FE-GATE-013도 마찬가지다. 그 gate의 test:system이 이것을 먼저 검사한다(scripts/check-system-test-prerequisites.ts). 고치는 법은 docs/operations/ci-quality-gates.md에 있다. 실행 권한, user manager·버전, 신뢰, archive, 경로 실패는 raw 파일을 만들기 전에 거부한다. bubblewrap이 --size를 받아들이는지와 실제로 위임된 controller 값은, 새 scope 안에 자기가 소유한 raw inode가 생긴 뒤에만 검증할 수 있다. 거기서 실패하면 그 inode를 identity로 찾아 지우고 fail closed한다. 호출마다 고유한 user scope 안에서 돌고, 그 scope는 끝나면 수거된다(collected). bubblewrap이 시작하기 전에 실제 cgroup 소속과 제한을 검증한다: memory는 정확히 1 GiB, swap은 0, TasksMax는 64, CPU quota는 100 ms마다 100%다. 안쪽 프로세스에는 core 크기 0, 파일 크기 제한 8,388,607바이트, 열린 파일 64개, CPU 시간 최대 1,200초도 걸린다. 전체 PID 수의 기준 경계는 TasksMax=64다. provider마다 RLIMIT_NPROC=32가 걸린다고 주장하지 않는다. 그 제한은 runner에서 같은 UID로 도는 프로세스를 모두 함께 세기 때문이다.

bubblewrap은 전용 network namespace(--unshare-net)를 쓴다. workspace와 검증된 후보를 읽기 전용으로 mount하고, .git을 숨기고, 신뢰하는 process.execPath를 /tmp/node에 읽기 전용으로 bind한다. supervisor는 sandbox·신뢰·archive 사전 점검(preflight)이 끝난 뒤에만 설정에 적힌 바로 그 raw 보고서 inode를 만들고 고정(pin)한다. 그 inode가 읽기·쓰기로 mount되는 유일한 provider 증거 경로다. provider는 둘러싼 untrusted 디렉터리, workspace, 후보, host home·toolcache, 봉인된 증거 경로, 일반 임시 파일 시스템에 쓸 수 없다. 실행 전 실패와 provider 실패는 supervisor가 소유한 raw inode만 지운다. 그래서 같은 job이 낡은 빈 보고서 없이 다시 시도할 수 있다.

bwrap 인자·환경 벡터 전체는 provider 명령과 provider 접두 환경 변수를 포함해, 길이를 앞에 붙인 크기 제한 frame에 담겨 systemd-run stdin으로 전달된다. supervisor, systemd, bwrap wrapper의 argv에는 넣지 않는다. 그래서 자격 증명이 unit metadata와 wrapper 명령줄에 들어가지 않는다. 마지막 provider 실행 파일과 그 일반 인자는 같은 UID의 프로세스 조회로 여전히 보인다. 그러므로 명령에는 토큰이나 비밀값을 절대 넣지 않는다. 같은 stdin은 provider가 정상 종료할 때까지 부모 생존 확인 채널로 열려 있다. supervisor가 죽어서 EOF가 오면 scope 안 wrapper가 provider 프로세스 그룹을 죽이고, dev/inode가 맞는 raw 보고서만 지운다. 자격 증명은 provider 종류 접두(VULNERABILITY_PROVIDER_* 또는 PROVENANCE_PROVIDER_*, *_COMMAND 제외)로만 넘긴다.

신뢰하는 별도 guardian이 provider scope 밖에서 시작해 파일 시스템 트랜잭션을 맡는다. 띄우기(spawn) 전에 client는 canonical raw 디렉터리와 증거 디렉터리를 O_DIRECTORY|O_NOFOLLOW로 열고 identity를 확인한다. 정확한 canonical leaf와 nonce 전용 leaf를 정하고, mode 0600인 빈 raw-staging 파일과 sealed-temp 파일을 배타적으로 만든다. 띄우기 전에 두 dev/inode 쌍을 기록한다. 디렉터리 descriptor는 guardian의 fd 3/fd 4로, 전용 파일 descriptor는 fd 5/fd 6으로 물려준다. guardian의 argv에는 신뢰하는 Node 경로와 helper 경로만 있다. 크기 제한이 있는 canonical v2 요청에는 provider 종류, 절대 마감 시각, 무작위 32바이트 control nonce만 담긴다.

시작(bootstrap)할 때 guardian은 procfs link를 읽기 전에 fd 5/fd 6을 fstat한다. 각 procfs 대상은 바로 아래 자식(direct-child) alias일 때만 받아들인다. 그리고 정확한 문법, descriptor 기준 lstat, 종류, mode, 크기, link 수, dev/inode가 이미 기록한 descriptor identity와 맞아야 한다. guardian은 raw staging을 덮어쓰지 않는 hard link로 고정된 raw leaf에 게시한다. 이어서 두 alias의 link 수가 2인지 확인하고, 전용 raw alias를 지우고, raw 디렉터리를 sync하고, canonical raw alias의 link 수가 1인지 확인한다. 이 모두가 인증된 READY 전에 일어난다. READY가 받아들여지기 전에 시작이 끝나면 client는 다음만 치운다: 띄우기 전 raw identity와 맞는 raw staging·canonical, 띄우기 전 sealed identity와 맞는 sealed temp·final. 지금 있는 canonical 경로 이름을 열어서 치울 권한을 정하지 않는다. 그래서 외부 파일이나 동시에 돈 같은 종류의 승자(winner)는 보존된다. provider 실행은 돌려받은 identity와 canonical 대상이 정확히 맞는다고 supervisor가 확인한 뒤에만 시작한다.

증거 검증이 끝나면 supervisor는 schema로 검증한 바이트를 고정한 temp inode에 쓰고, 0400으로 바꾸고, fsync한 뒤, 인증된 크기·hash·identity metadata를 보낸다. guardian은 쥐고 있는 descriptor와 경로 이름을 검증하고, 같은 디렉터리 안 link로 교체 없이 게시하고, temp 이름을 지우고, 디렉터리를 fsync한 뒤, 인증된 PUBLISHED를 돌려준다. supervisor는 GITHUB_OUTPUT 덧붙이기가 성공한 뒤에만 commit을 보낸다. commit은 raw inode를 지우고 commitPending에 들어간다. 깨끗한 control EOF만이 성공 종료이고, 봉인된 final을 보존한다. 다음 경우에는 맞는 raw·temp·final identity를 모두 치우고 fail closed한다: 그 종료 없이 온 EOF, 마감 시각 초과, 형식이 틀리거나 뒤에 남는 control 데이터, 틀린 nonce, guardian의 이른 종료. provider scope가 살아 있는 동안 guardian을 잃어도 scope 전체를 죽이고 수거한다.

GITHUB_OUTPUT은 runner가 소유한 일반 파일이라고 가정한다. 이 protocol은 봉인이나 output I/O를 OS 수준에서 취소한다고 주장하지 않는다. scope를 수거한 뒤 guardian이 끝나면, scope-active latch가 lifecycle 오류를 기록하되 뒤늦은 kill은 시작하지 않는다. 게시나 마지막 commit 단계가 0이 아닌 종료를 보면, client는 identity로 고정한 raw·temp·final 잔여 파일(fallback)을 모두 지우고 fail closed 한다. lease는 provider 실제 시간(wall) 제한 30분에 고정 후처리 여유 10분을 더한 시간으로 제한된다.

전용 파일을 만든 뒤 guardian을 띄우기 전에 client가 강제로 멈추면, mode 0600인 빈 nonce 전용 leaf만 남을 수 있다. 자동 정리는 일부러 넣지 않았다. 기록되지 않은 경로 이름은 소유를 증명하지 못하기 때문이다. 이 전용 leaf는 고정된 raw 이름이나 final 이름을 차지할 수 없고, 재시도를 막지 않는다.

provider stdout과 stderr는 비밀값을 담고 있을 수 있는 믿을 수 없는 바이트다. supervisor는 이것을 보관하지도, CI 로그로 넘기지도 않는다. 합계 1 MiB 제한 하나를 지키려고 바이트 수만 센다. guardian 진단은 최선 노력(best effort)이다. 그래서 stderr나 control descriptor가 닫혀도 정리 작업이나 필수인 0이 아닌 종료를 건너뛸 수 없다. provider 실제 시간 제한은 30분이다. 실제 시간 초과, 출력 초과, 부모 생존 확인 끊김, scope가 살아 있을 때의 guardian 손실은 provider 프로세스 그룹 전체에 명시적으로 SIGKILL을 보낸다. 일반 명령 실패와 RLIMIT 실패는 systemd를 거쳐 구체적인 exit·signal로 끝난다. 어느 경로든 wrapper가 닫히기를 기다리고, 돌아오기 전에 systemd unit·cgroup이 수거되기를 요구한다. 그러므로 provider adapter는 미리 채워 둔 오프라인 데이터만으로 동작하고, 받은 후보 binding을 쓰고, 고정된 보고서 inode에 정확히 써야 한다. 다음은 모두 게시를 멈춘다: 전제 조건 누락, cgroup 어긋남(drift), 낡았거나 엉뚱한 곳에 있는 출력, 명령 뒤 후보 어긋남, scope 정리 잔여물.

provider 문서는 엄격한 schema v2다. Ed25519 서명이 덮는 범위는 다음과 같다: supervisor가 준 증거 종류, 유효 기간, run ID·attempt, 독립된 32바이트 호출 nonce, archive에 든 source identity, 후보 digest 네 개 전부. provider job마다 supervisor가 만든 nonce를 job output으로 내보낸다. 승격은 그 output을 독립된 기대값으로 쓰고, 보고서가 자기 기대 nonce를 정하게 두지 않는다. 다른 attempt, source, archive, nonce, 키 지문에서 온 보고서는 올바르게 다시 서명됐더라도 fail closed다.

바뀌지 않는(immutable) archive에는 producer 쪽의 엄격한 로컬 assessment와, archive 안 관계를 검증하는 데 필요한 policy·verifier source 바이트가 들어 있다. 승격은 격리된 압축 해제 root에서 후보 내부 검사를 다시 계산하고, 붙잡아 둔 secret scan의 policy·rule·SARIF·digest 관계를 검증한다. checkout의 policy나 source 경로를 다시 열지 않고, archive에 없는 checkout source를 다시 검사했다고 주장하지 않는다. finalizer는 archive, 보고서 두 개, 공개 키 두 개를 한 번 붙잡아 두고, 검증 v3 기록 두 개를 메모리에서 만든다. 그리고 RUNNER_TEMP 안 무작위 mode 0700 디렉터리 아래에 mode 0400 파일을 정확히 다섯 개 쓴다. runner umask가 엄격해도 이 mode는 그대로다. 다섯 개는 붙잡아 둔 archive, 붙잡아 둔 취약점 보고서, 붙잡아 둔 provenance attestation, 생성한 provider-verification v3, 생성한 promotion-verification v3다. 돌아오기 전에 finalizer는 바로 그 바이트를 현재 시각 기준의 provider 서명·신선도 검사로 다시 검증한다. 승격 기록은 다음을 묶는다: 정확한 provider 기록 hash, 로컬 assessment hash, 보고서 hash 두 개, run·source·후보 identity, nonce 두 개, key ID·지문 두 개, canonical trust policy hash, 취약점 provider가 서명한 secretScanAttestation. 그 엄격한 attestation은 PASS라고 적고, 붙잡아 둔 로컬 assessment, source 집합, secret scan policy, SARIF, 실제 scan 입력의 digest를 묶는다. supervisor는 붙잡아 둔 archive에서 기대 tuple을 얻는다. upload와 마무리(finalization) 때 그 tuple과 정확히 같은지 다시 확인한다. 그 source 집합을 독립적으로 검사하고, 위조된 빈 SARIF나 불완전한 scan 입력에는 서명을 거부할 책임은 여전히 신뢰하는 취약점 provider에게 있다. 서명은 provider가 그 주장을 했다는 것을 증명할 뿐이다. 믿을 수 없는 provider가 검사를 성실히 했다는 것은 증명하지 않는다. finalizer는 .release/promoted-staging을 만들지도 재사용하지도 않는다.

마지막 승격 검증·staging 단계는 승격된 release upload 바로 앞에 붙어 있어야 하고, 그 upload는 always()를 쓰면 안 된다. 이렇게 하면 검증 뒤 내용이 바뀔 수 있는 시간 틈이 준다. 하지만 두 action 단계에 걸쳐 경로 이름을 봉인하지는 못한다. 그래서 runner는 신뢰할 수 있고, 독점적이고, 단일 tenant여야 한다. staging에서 바로 다음 upload까지 provider 명령이나 같은 UID의 다른 프로세스가 살아남으면 안 된다. artifact 서비스와 전송 action도 후보의 암호학적 identity 밖에 있다. 그러므로 뒤에 오는 모든 소비자는 내려받은 archive, manifest member digest, 서명된 provider 증거를 다시 검증해야 한다. producer 쪽에서 단계를 붙여 둔다고 소비자 쪽 digest 재검증이 되지는 않는다. 승격 job에는 job 수준 if가 없다. 일반 needs 성공 규칙에 따라 immutable build와 provider job 두 개가 모두 성공해야 한다. 취소는 always()나 cancelled()로 덮어쓰지 않는다. 정리(cleanup) 단계만 조건 없는 always()를 쓰고, finalizer output 여섯 개 전부로 보호된다: staging 경로, token, 부모 device/inode, staging leaf device/inode. 정리 단계는 고정한 leaf를 열고, 정확히 그 다섯 이름을 요구하고, descriptor를 거쳐 그 알려진 파일만 unlink하고, 재귀하지 않는 rmdir를 쓴다. 바꿔치기된 디렉터리나 canary는 절대 재귀로 지우지 않는다. 바로 다음 upload action은 여전히 경로 이름을 다시 연다. descriptor 기준 staging·정리 코드는 원자적인 renameat2 넘겨주기를 한다고 주장하지 않는다. 악의적인 같은 UID의 Gitea upload adapter를 막는다고도 주장하지 않는다. 그 경계를 닫으려면 여전히 staging Gitea smoke와 native platform adapter가 필요하다. 그 smoke는 exact-five upload·download를 돌리고, 성공·검증 실패·upload 실패·취소 때의 정리도 실제로 돌려 봐야 한다. 지금 이 repository에는 native uploader도 renameat2 보장도 없다. 이식 가능한(portable) Node는 mkdir와 첫 경로 이름 lstat를 하나의 원자적 동작으로 만들 수도 없다. 구현은 권한을 바꾸기 전에 mkdir 직후의 identity를 그다음 O_DIRECTORY|O_NOFOLLOW descriptor와 비교한다. 그러나 첫 lstat 전에 끼어든 악의적인 같은 UID 행위자는 native·권한 경계가 맡아야 할 몫으로 남는다. 그러므로 전용 0700 runner-temp 상위 디렉터리와 단일 tenant runner 요구는 단순한 강화(hardening)가 아니라 보안 통제다. 실패 정리는 만든 device/inode가 연 descriptor와 맞은 뒤에만 켜진다. 연 descriptor가 바꿔치기된 것이면 아무것도 unlink하거나 지우지 않고 닫는다. 눈에 보이는 바꿔치기 대상도 마찬가지로 건드리지 않는다. 이식 가능한 Node는 부모 디렉터리를 훑어서 공격자가 옮긴 원래 디렉터리를 안전하게 다시 찾을 수 없다. 그래서 그 잔여물은 공격자를 배제한 뒤 격리된 test fixture나, 신뢰하는 runner·native 정리가 지워야 한다.

승인된 취약점 예외에는 취약점·패키지 identity, owner, owner와 다른 리뷰어, 이유, 만료일이 있어야 한다. 만료됐거나 스스로 승인한 예외는 차단한다.