문서 서비스 docs-api의 새 버전을 배포하려고 합니다. CI에서는 이미지 빌드가 끝났고 서명 검사도 통과했다고 표시하는데, 이제 배포 버튼을 눌러도 될까요?
서명이 유효한 이미지라도 다른 저장소의 코드로 만들었거나 허용하지 않은 빌드 환경을 거쳤을 수 있습니다. 이 가상의 docs-api를 배포하려면 서명이 어떤 이미지를 가리키는지부터 시작해, 그 이미지의 출처와 빌드 과정까지 확인해야 합니다.
검사할 이미지부터 고정합니다
이미지 이름 docs-api:release에서 release는 tag입니다. 오늘은 이미지 A를 가리키더라도 새 이미지가 게시되면 B를 가리킬 수 있으므로, 이름이 같다고 내용까지 같지는 않습니다.
검사할 이미지를 고정하려면 Docker의 image digest 설명에서 안내하듯 이미지 내용을 식별하는 digest를 사용합니다. 여기서는 긴 digest를 각각 A와 B로 줄여 부르겠습니다. A를 지정하면 나중에 tag가 바뀌어도 같은 이미지를 검사합니다. 다만 digest는 이미지 내용을 구분할 뿐, 그 내용이 안전한지까지 알려주지는 않습니다.
이제 A에 연결된 서명을 검사합니다. 예를 들어 Cosign의 이미지 서명에는 대상 이미지의 digest가 포함됩니다. Sigstore의 서명 검증 설명에서 안내하는 기본 검증 과정에서는 서명된 내용의 무결성을 검사하고, 그 안의 digest가 검사 중인 이미지와 맞는지도 대조합니다. 다른 이미지의 유효한 서명을 가져온 경우를 여기서 구별합니다.
서명 검사는 프로그램을 실행해 보거나 모든 취약점을 찾아내지는 않습니다. 잘못된 코드로 만든 이미지에도 서명을 붙일 수 있으므로, A의 서명을 확인한 다음에는 어디에서 어떻게 만든 이미지인지 살펴봐야 합니다.
서명 확인이 끝난 뒤 이미지의 대상을 비교합니다
단계 설명과 조건별 결과
- payload에 digest A를 담고 서명했습니다. 검사 대상은 이미지 A입니다.
- 신뢰할 수 있는 검증 정보로 payload의 서명을 검사합니다. 검사 결과는 아직 표시하지 않습니다.
- 서명된 내용은 바뀌지 않았습니다. 이제 서명한 digest와 검사 대상 이미지를 비교할 수 있습니다.
- 서명된 digest를 검사 대상 이미지와 대조합니다. 서명 성공을 곧바로 대상 일치라고 표시하지 않습니다.
- 서명된 digest A와 검사 이미지 A가 일치합니다. 이 확인이 코드의 안전성을 보장하지는 않습니다.
서명과 대상 일치 — 서명된 digest A와 검사 이미지 A가 일치합니다. 이 확인이 코드의 안전성을 보장하지는 않습니다.
서명 후 payload 변경 — payload가 바뀌어 서명 검사가 실패했습니다. 이미지 대상은 비교하지 않습니다.
다른 이미지 제출 — 서명 자체는 유효하지만 payload의 A와 검사 이미지 B가 다릅니다. 이 서명으로 B를 검증할 수 없습니다.
빌드 기록을 미리 정한 조건과 비교합니다
빌드 과정에서 남긴 생성 경위를 provenance라고 합니다. docs-api의 경우 어떤 저장소의 어느 commit을 입력으로 삼았고, 어떤 빌드 환경이 이미지를 만들었는지 확인할 자료입니다. 이런 주장을 정해진 구조로 전달하는 문서를 attestation이라고 부릅니다. SLSA의 빌드 provenance는 이 구조 안에서 생성 과정과 빌드 주체를 설명합니다.
기록에는 어떤 산출물을 만들었는지도 명시해야 합니다. subject의 digest가 A를 가리켜야 A의 생성 경위를 확인할 수 있고, 정상적인 빌드 기록이라도 B에 관한 내용이라면 A를 배포할 근거로 쓸 수 없습니다. 그래서 이미지의 서명과 별개로 provenance 기록 자체의 서명과 대상도 검증합니다.
기록의 subject와 검사 이미지를 정적으로 대조합니다
단계 설명과 조건별 결과
- 대상 이미지 고정 검사할 이미지는 A입니다. 저장소 docs-api, commit c1, approved-builder의 생성 경위를 확인합니다.
- subject 비교 결과 서명 검사에 통과한 기록의 subject도 A이므로 A의 생성 경위입니다.
A의 생성 경위 — 서명 검사에 통과한 기록의 subject도 A이므로 A의 생성 경위입니다.
B의 생성 경위 — 서명 검사에 통과했어도 subject가 B이면 다른 이미지의 기록입니다.
기록 없음 — 기록이 없어서 subject를 비교할 수 없습니다. 미확인을 일치로 처리하지 않습니다.
A의 빌드 기록을 찾았다면 이제 배포 기준과 맞춰 볼 차례입니다. 여기서는 우리 CI의 허용된 서명자, 승인한 builder, docs-api 저장소의 배포 대상 commit을 기준으로 삼겠습니다. builder는 빌드를 수행하고 그 경위를 기록하는 플랫폼입니다.
먼저 서명자가 예상한 주체인지, 그가 보증한 builder가 우리가 허용한 빌드 환경인지 확인합니다. 이어서 기록된 저장소와 commit, 빌드 조건을 비교합니다. 같은 CI가 서명했더라도 다른 저장소의 코드를 빌드했다면 docs-api의 배포 기준에는 맞지 않습니다. SLSA의 산출물 검증 지침도 서명과 산출물의 연결을 확인한 뒤 생성 경위를 기대값과 대조하도록 설명합니다.
이 판단은 허용한 빌드 환경이 생성 경위를 올바르게 기록한다는 신뢰를 전제로 합니다. 필요한 기록이 없으면 배포 조건에 맞는지 확인할 수 없습니다. 기록은 있지만 값이 다르다면, 정해 둔 조건을 충족하지 못한 것입니다. 서명이 유효하다는 사실만으로 이 빈칸이나 불일치가 해결되지는 않습니다.
검증한 생성 경위를 배포 조건과 비교합니다
이미지 A · 서명과 subject 확인 완료 배포 허용
release-ci=release-ci일치approved-builder=approved-builder일치docs-api=docs-api일치c1=c1일치단계 설명과 조건별 결과
- 비교할 근거 이미지 A의 서명과 provenance의 대상 연결을 확인했습니다. 허용한 빌드 환경의 기록을 신뢰할 수 있다고 가정합니다.
- 배포 정책의 결과 서명자·builder·저장소·commit이 모두 기대값과 같습니다. 배포 요청에도 검증한 A를 지정해야 합니다.
모든 조건 일치 — 서명자·builder·저장소·commit이 모두 기대값과 같습니다. 배포 요청에도 검증한 A를 지정해야 합니다.
다른 서명자 — 서명자가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.
다른 builder — builder가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.
다른 저장소 — 저장소가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.
다른 commit — commit가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.
필수 기록 누락 — 값을 확인할 수 없어 배포를 보류합니다. 자료 누락과 정책 불일치는 다른 상태입니다.
검증한 이미지를 배포 요청에도 지정합니다
A가 배포 기준을 통과했어도 마지막에 다른 이미지를 지정하면 앞의 검증은 소용이 없습니다. 배포 단계에서 docs-api:release를 다시 조회하는 사이 tag가 B를 가리키도록 바뀔 수 있기 때문입니다. 검사한 것은 A이며, B는 아직 검증하지 않았습니다.
Docker의 digest 설명에서 다루는 방식대로 배포 요청에도 확인한 digest를 사용하고, 실행할 이미지가 검증한 이미지와 같은지 확인합니다. 이 예에서는 동일한 실행 플랫폼의 이미지를 비교합니다.
tag의 대상이 바뀌어도 배포에 검증한 digest를 유지합니다
단계 설명과 조건별 결과
- release와 digest A가 같은 이미지 A를 가리킬 때 A의 서명·생성 경위·배포 조건을 확인했습니다.
- 새 이미지 B를 게시해 release만 B로 옮깁니다. digest A와 A의 검증 기록은 그대로입니다.
- 검증한 digest A를 배포 요청에 넣어 전달합니다. 아직 대상 확인 결과는 없습니다.
- 요청에 도착한 digest A는 검사했던 이미지 A와 같습니다.
검증한 digest 유지 — 요청에 도착한 digest A는 검사했던 이미지 A와 같습니다.
배포 때 tag 재조회 — 검증한 이미지는 A인데 도착한 배포 요청은 B를 지정합니다. B는 이번 검증으로 허용되지 않았습니다.
이 예에서 배포할 수 있다고 판단한 대상은 서명과 생성 경위가 유효하고, 빌드 주체와 소스가 정해 둔 조건에 맞는 이미지 A입니다. 배포 요청에도 같은 digest를 지정해야 그 판단이 실제 배포 대상으로 이어집니다.