본문으로 건너뛰기
← Systems Notebook / SEC
배포 이미지 검증SECURITY NOTES

서명된 이미지라면 바로 배포해도 될까요?

이미지의 digest, 서명, 빌드 정보를 확인하고 실제로 배포하는 이미지도 검증한 것과 같은지 살펴봅니다.

홍범개념 설명 · 움직이는 예제

문서 서비스 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의 서명을 확인한 다음에는 어디에서 어떻게 만든 이미지인지 살펴봐야 합니다.

서명 확인이 끝난 뒤 이미지의 대상을 비교합니다

단계 설명과 조건별 결과
  1. payload에 digest A를 담고 서명했습니다. 검사 대상은 이미지 A입니다.
  2. 신뢰할 수 있는 검증 정보로 payload의 서명을 검사합니다. 검사 결과는 아직 표시하지 않습니다.
  3. 서명된 내용은 바뀌지 않았습니다. 이제 서명한 digest와 검사 대상 이미지를 비교할 수 있습니다.
  4. 서명된 digest를 검사 대상 이미지와 대조합니다. 서명 성공을 곧바로 대상 일치라고 표시하지 않습니다.
  5. 서명된 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와 검사 이미지를 정적으로 대조합니다

단계 설명과 조건별 결과
  1. 대상 이미지 고정 검사할 이미지는 A입니다. 저장소 docs-api, commit c1, approved-builder의 생성 경위를 확인합니다.
  2. 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일치
builderapproved-builder=approved-builder일치
저장소docs-api=docs-api일치
commitc1=c1일치
단계 설명과 조건별 결과
  1. 비교할 근거 이미지 A의 서명과 provenance의 대상 연결을 확인했습니다. 허용한 빌드 환경의 기록을 신뢰할 수 있다고 가정합니다.
  2. 배포 정책의 결과 서명자·builder·저장소·commit이 모두 기대값과 같습니다. 배포 요청에도 검증한 A를 지정해야 합니다.

모든 조건 일치 — 서명자·builder·저장소·commit이 모두 기대값과 같습니다. 배포 요청에도 검증한 A를 지정해야 합니다.

다른 서명자 — 서명자가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.

다른 builder — builder가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.

다른 저장소 — 저장소가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.

다른 commit — commit가 기대값과 달라 배포를 거부합니다. 그 뒤 조건은 검사하지 않은 상태입니다.

필수 기록 누락 — 값을 확인할 수 없어 배포를 보류합니다. 자료 누락과 정책 불일치는 다른 상태입니다.

검증한 이미지를 배포 요청에도 지정합니다

A가 배포 기준을 통과했어도 마지막에 다른 이미지를 지정하면 앞의 검증은 소용이 없습니다. 배포 단계에서 docs-api:release를 다시 조회하는 사이 tag가 B를 가리키도록 바뀔 수 있기 때문입니다. 검사한 것은 A이며, B는 아직 검증하지 않았습니다.

Docker의 digest 설명에서 다루는 방식대로 배포 요청에도 확인한 digest를 사용하고, 실행할 이미지가 검증한 이미지와 같은지 확인합니다. 이 예에서는 동일한 실행 플랫폼의 이미지를 비교합니다.

tag의 대상이 바뀌어도 배포에 검증한 digest를 유지합니다

단계 설명과 조건별 결과
  1. release와 digest A가 같은 이미지 A를 가리킬 때 A의 서명·생성 경위·배포 조건을 확인했습니다.
  2. 새 이미지 B를 게시해 release만 B로 옮깁니다. digest A와 A의 검증 기록은 그대로입니다.
  3. 검증한 digest A를 배포 요청에 넣어 전달합니다. 아직 대상 확인 결과는 없습니다.
  4. 요청에 도착한 digest A는 검사했던 이미지 A와 같습니다.

검증한 digest 유지 — 요청에 도착한 digest A는 검사했던 이미지 A와 같습니다.

배포 때 tag 재조회 — 검증한 이미지는 A인데 도착한 배포 요청은 B를 지정합니다. B는 이번 검증으로 허용되지 않았습니다.

이 예에서 배포할 수 있다고 판단한 대상은 서명과 생성 경위가 유효하고, 빌드 주체와 소스가 정해 둔 조건에 맞는 이미지 A입니다. 배포 요청에도 같은 digest를 지정해야 그 판단이 실제 배포 대상으로 이어집니다.

그림과 애니메이션은 본문의 조건을 단순화한 설명용 예시입니다.