의존성 공급망 보안은 지난 몇 년간 CI/CD 환경에서 가장 뜨거운 주제였다. 특히 GitHub Actions는 외부 저장소의 코드를 Git에서 그대로 가져와 실행하는 구조이기 때문에, 신뢰할 수 없는 서드파티 액션이 파이프라인 권한을 그대로 넘겨받는 통로가 되곤 했다. 그동안 통용되던 모범 사례는 간단했지만 불편했다. actions/checkout@v4 같은 태그 대신 전체 커밋 SHA로 고정하라는 것이다. 이제 GitHub Actions가 워크플로 락파일(lockfile)을 공식 지원하면서, 이 번거로운 관행을 대체할 선택지가 생겼다.
왜 태그가 아니라 SHA였나
태그와 SHA의 차이를 이해하면 락파일의 의미가 분명해진다. Git 태그는 변경 가능(mutable)한 포인터다. 어제까지 안전했던 v4 태그를 공격자가 악성 커밋으로 몰래 옮겨 놓으면, 아무것도 바꾸지 않은 당신의 워크플로가 다음 실행에서 조용히 악성 코드를 실행하게 된다. 반면 커밋 SHA는 특정 코드 상태를 불변으로 가리키므로 이런 태그 재지정(tag-moving) 공격이 통하지 않는다. 문제는 가독성이다. 40자리 해시가 늘어선 워크플로는 사람이 읽기 어렵고, 어떤 버전을 쓰는지 한눈에 알 수 없다. 보안과 가독성이 맞바꿔지는 전형적인 트레이드오프였다.
락파일은 이 둘을 분리한다. 워크플로 파일에서는 사람이 읽기 쉬운 vX.Y.Z 형태의 버전 태그를 그대로 쓰되, 실제로 어떤 커밋이 그 태그에 대응하는지는 별도의 .github/workflows/actions.lock 파일에 고정해 기록하는 방식이다. 패키지 생태계의 package-lock.json이나 poetry.lock과 같은 발상을, 뒤늦게나마 CI 액션에도 적용한 셈이다. 도입 절차는 gh CLI에 gh-actions-lock 확장을 설치한 뒤 gh actions-lock을 실행하는 것으로 시작한다. 그러면 워크플로의 각 액션에 대응하는 락파일이 생성되고, 수정된 워크플로와 새 락파일을 함께 커밋하면 된다.
자동 업데이트와 CI 검증
실무에서 중요한 것은 이 체계가 기존 자동화 도구와 맞물려 돌아가는지다. 의존성 자동 업데이트 도구들은 이미 락파일을 인식하므로, 주기적 업데이트가 워크플로뿐 아니라 락파일까지 함께 갱신한다. 다만 원 저자는 쿨다운(cooldown) 설정을 잊지 말라고 당부한다. 새 버전이 올라오자마자 즉시 당겨오는 대신 일정 기간 묵혀 두면, 악성 릴리스가 끼어드는 시간 창을 줄일 수 있기 때문이다.
GitHub은 여기에 더해 락파일이 최신 상태이며 손상되지 않았는지를 CI에서 검증할 것을 권한다. 이를 위한 verify-lockfile.yml을 그대로 복사해 넣는 방식이 제안되지만, 원 저자는 이를 기존 린트 워크플로 안에 별도 잡(job)으로 넣어 독립적으로 병렬 실행되게 구성했다. 이때 경량 러너인 ubuntu-slim을 사용했다는 점도 참고할 만하다. 한 가지 유의점은, 검증 액션 자체도 v0.4.1처럼 특정 버전에 고정되어 있어 언젠가는 수동으로 올려 주거나 자동화 방안을 마련해야 한다는 것이다. 그리고 워크플로의 액션을 건드렸다면, 설령 새 파일 하나를 추가한 것뿐이라도 다시 gh actions-lock으로 재잠금(relock)해야 한다. 빠뜨리면 CI가 알려 준다.
zizmor와 함께 쓰기
이 전환에서 함께 챙겨야 할 도구가 GitHub Actions 전용 보안 린터 zizmor다. 원 저자는 쓰지 않고 있다면 꼭 도입하라고 강하게 권한다. 다만 버전에 주의해야 한다. v1.32.0 이전 버전은 여전히 해시 고정(hash-pinning)을 권고하므로, 락파일 기반으로 넘어왔다면 린터와 정책이 충돌할 수 있다. 락파일을 처음으로 지원하는 버전이 바로 v1.32.0이다. 원 저자는 prek을 통해 zizmor를 사용하므로 .pre-commit-config.yaml에서 버전을 추가하거나 갱신하는 방식으로 맞춰 둔다.
정리하면, 워크플로 락파일은 보안상 새로운 방어선을 추가한다기보다 SHA 고정이 주던 불변성 보장을 유지하면서 가독성과 유지보수성을 되찾아 주는 장치에 가깝다. 한국의 개발팀이 당장 고려할 포인트는 세 가지다. 자동 업데이트 도구에 쿨다운을 걸어 두었는지, 락파일 검증을 CI에 포함했는지, 그리고 린터 버전이 새 방식과 보조를 맞추는지다. 공급망 공격이 CI 파이프라인을 노리는 현실에서, 이 작은 파일 하나를 커밋 흐름에 얹는 것은 비용 대비 효과가 분명한 조치다.