문제: docs/runbooks, docs/security, docs/styling/design-tokens.md, docs/accessibility, docs/contracts, docs/testing/taxonomy.md와 src/adapters/browser-transfer/image-cdn/README.md는 본문이 영어다. PRODUCT.md는 「~합니다」 체라 한 문서 안 문체 규칙(「~한다」)과 다르다. 고른 방법: 뜻을 바꾸지 않고 옮긴다. runbook 제목의 ID와 오류 code, 기록 양식의 영어 키(`Status:`, `M1 Keyboard:` 등, 코드 블록 안)는 그대로 둔다. PRODUCT.md는 디자인 도구가 읽는 제목(`## Users` 등)을 두고 문장 끝만 바꾼다. 위험: 이 커밋으로 문서 검사의 예외 목록이 빈다. 앞으로 영어 문서나 높임 문체를 더하면 verify:documentation이 실패한다. 검증: 백틱 span·링크 대상·코드 블록을 옮기기 전과 python으로 비교해 같다. 문서 검사 여섯이 모두 0건이고 예외 목록과 FROZEN이 비었다.
359 lines
28 KiB
Markdown
359 lines
28 KiB
Markdown
# 빌드·공급망 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. 대상은 source, 선택해서 켜는(opt-in) recipe, script, 테스트,
|
|
추적되는 config/schema, public 폴더, 빌드된 asset, 생성된 release metadata다
|
|
- 두 번 빌드해 비교하는 `SOURCE_DATE_EPOCH` 재현성 검사
|
|
|
|
기준 명령은 다음과 같다.
|
|
|
|
```bash
|
|
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를 하드코딩하면 거부한다.
|
|
|
|
## 무엇을 증명하고 무엇을 증명하지 않는가
|
|
|
|
리뷰 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`) 이 문서에 알려진 차이로 남긴다.
|
|
|
|
## 최소 구성과 전체 구성
|
|
|
|
리뷰 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와 다른 리뷰어, 이유,
|
|
만료일이 있어야 한다. 만료됐거나 스스로 승인한 예외는 차단한다.
|