CI/CD 보안
GitHub Actions 보안: 워크플로를 강화하는 체크리스트
GitHub Actions 워크플로는 리포지토리의 토큰과 시크릿을 가진 채, 프로덕션으로 이어지는 경로 위에서 여러 작성자의 코드를 실행합니다. 이를 안전하게 지키는 통제 수단 대부분은 GitHub에 내장되어 있지만, 기본 상태에서는 꺼져 있거나 느슨하거나 잘못 설정하기 쉽습니다. 이 체크리스트는 각 항목에 대해 무엇을 설정해야 하는지, 왜 중요한지, 그리고 설정하지 않았을 때 어떤 일이 일어나는지 보여 주는 사고를 다룹니다.
업데이트
체크리스트 한눈에 보기
| 항목 | 막아 주는 것 |
|---|---|
최소 권한 GITHUB_TOKEN |
탈취된 단계가 코드를 푸시하거나 릴리스를 게시하거나 다른 워크플로를 트리거하는 것 |
| 서드파티 액션 고정 또는 잠금 | 옮겨진 태그가 작업에서 공격자의 코드를 실행하는 것 |
pull_request_target과 workflow_run을 특권 워크플로로 취급 |
Pwn 리퀘스트: 포크의 코드가 시크릿을 가진 채 실행되는 것 |
이벤트 데이터를 run 스크립트에 넣지 않기 |
제목, 브랜치 이름, 댓글을 통한 스크립트 인젝션 |
| 저장된 클라우드 키 대신 OIDC | 유출된 뒤에도 몇 년 동안 작동하는 장기 자격 증명 |
| 필수 검토자를 둔 환경 | 아무 브랜치나 워크플로가 프로덕션 시크릿을 읽는 것 |
.github/workflows의 코드 소유자 |
파이프라인이 실행하는 내용에 대한 검토 없는 변경 |
| 허용 액션 정책 | 조직 어디에서든 알 수 없거나 고정되지 않은 액션 |
| 공개 리포지토리에 셀프 호스팅 러너 사용 금지 | 낯선 사람이 내 머신에서 코드를 실행하는 것 |
| 캐시와 아티팩트 위생 | 오염된 캐시와 업로드를 통한 토큰 유출 |
| 러너의 이그레스 통제 | 탈취된 시크릿이 공격자의 서버로 전송되는 것 |
| 각 실행의 기록 | 어떤 빌드가 침해된 액션이나 패키지를 실행했는지 모르는 것 |
워크플로 코드
1. GITHUB_TOKEN에 최소 권한을 부여하세요
모든 작업은 GITHUB_TOKEN을 받고, 작업의 어느 단계든 이를 사용할 수 있습니다. 2023년 2월 이전에 만든
리포지토리와 조직은 여전히 모든 권한에 대해 읽기 및 쓰기가 기본값일 수 있습니다.
Settings → Actions → General → Workflow permissions에서 기본값을 읽기 전용으로 설정한 다음, 작업별로
쓰기 권한을 부여하세요.
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
나열하지 않은 권한은 모두 none이 됩니다. 각 권한과 일반적인 작업에 필요한 권한은
GITHUB_TOKEN 권한: 모든 워크플로의 최소 권한을 참조하세요.
2. 서드파티 액션을 커밋에 고정하거나 잠그세요
@v4 같은 태그는 액션 소유자, 또는 소유자의 접근 권한을 탈취한 누구든 옮길 수 있는 포인터입니다. 두
사고가 그 의미를 보여 줍니다.
- tj-actions/changed-files, 2025년 3월. 공격자가 기존 버전 태그를 변경해 악성 커밋을 가리키게 했습니다(CVE-2025-30066). 이 액션은 23,000개가 넘는 리포지토리에서 사용되었으며, 페이로드는 러너 메모리의 시크릿을 워크플로 로그에 출력했습니다. 공개 리포지토리에서는 누구나 이 로그를 읽을 수 있습니다.
- aquasecurity/trivy-action, 2026년 3월. Aqua Security의 보안 권고 (CVE-2026-33634)에 따르면 이 액션의 버전 태그 77개 중 76개가 악성 커밋으로 강제 푸시되었습니다. 주입된 코드는 실제 스캔보다 먼저 실행되어 러너 메모리에서 시크릿을 읽고, 이를 암호화해 공격자의 인프라로 보냈습니다.
전체 커밋 SHA를 참조한 워크플로는 이전과 같은 코드를 계속 실행했습니다. 버전은 주석으로 남겨 두세요.
steps:
# Mutable: whoever controls the tag decides what runs
- uses: tj-actions/changed-files@v45
# Immutable: a full commit SHA, with the version as a comment
- uses: tj-actions/changed-files@<full-commit-sha> # v46.0.1
SHA가 포크가 아니라 액션 자체 리포지토리에서 나온 것인지 확인하세요. GitHub는 이제 더 강력한 방법을 제공합니다.
2026년 10월 28일부터 정식 제공되는
워크플로
종속성 잠금 파일입니다. gh actions-lock CLI 확장은 .github/workflows/actions.lock을
작성하며, 이 파일에는 워크플로가 사용하는 모든 액션의 정확한 커밋이 그 액션들이 호출하는 액션까지 포함해 기록됩니다.
GitHub는 실행 시점에 각 소스 리포지토리가 잠근 당시의 리포지토리와 여전히 같은지 확인합니다. 재사용 가능한 워크플로
호출은 대상이 아니므로 SHA로 고정하세요. 관리자는 정책으로 잠금 파일을 필수로 지정할 수 있습니다. 고정도 잠금 파일도
액션을 안전하게 만들지는 않습니다. 잠그는 대상을 검토하세요.
고정된 액션은 스스로 업데이트되지 않습니다. Dependabot이 업데이트를 제안하도록 하되, 새 릴리스가 여러분에게 도달하기 전에 문제가 발견될 수 있도록 며칠의 쿨다운을 두세요.
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. pull_request_target과 workflow_run을 특권 워크플로로 취급하세요
포크에서 온 pull_request 워크플로는 읽기 전용 토큰을 받고 시크릿은 받지 않습니다.
pull_request_target 워크플로는 풀 리퀘스트가 포크에서 왔더라도 베이스 리포지토리의 컨텍스트에서, 그
시크릿과 쓰기가 가능한 토큰을 가진 채 실행됩니다. 이는 워크플로가 풀 리퀘스트의 코드를 절대 실행하지 않는 동안에만
안전합니다. 풀 리퀘스트의 head를 체크아웃해 빌드하면, 그 풀 리퀘스트의 모든 설치 스크립트와 테스트가 시크릿을 가진
채 실행됩니다. GitHub Security Lab은 이를
pwn
리퀘스트라고 부릅니다.
- 기여된 코드를 빌드하거나 테스트하는 작업에는
pull_request를 사용하세요. -
풀 리퀘스트에 댓글을 다는 것처럼 특권 단계가 뒤따라야 한다면 분리하세요. 특권이 없는
pull_request워크플로가 결과를 아티팩트로 업로드하고,workflow_run워크플로가 그 결과를 처리합니다. 이 아티팩트는 신뢰할 수 없는 입력으로 취급하고, 실행할 코드로 취급하지 마세요. -
이벤트 정책이 없는 공개 리포지토리에서 GitHub는 2026년 12월 2일부터
pull_request_target을 기본적으로 차단합니다. 다시 허용한다면 필요한 워크플로에만 허용하세요.
2026년 5월의 TanStack 침해도 이렇게 시작되었습니다. pull_request_target 워크플로가 포크의 코드를
실행했고, 그 코드가 나중에 릴리스 워크플로가 복원하는 캐시를 오염시켰으며, 러너 메모리에서 읽은 OIDC 토큰으로
42개 패키지의 악성 버전
84개가 게시되었습니다.
4. 이벤트 데이터를 run 스크립트에 넣지 마세요
표현식은 셸이 실행되기 전에 전개되므로, run 안의 풀 리퀘스트 제목, 브랜치 이름, 이슈 본문, 커밋 메시지는
스크립트의 일부가 됩니다. 그러면 풀 리퀘스트나 이슈를 열 수 있는 누구나 작업에서 명령을 실행할 수 있습니다. 값을 환경
변수로 전달해 셸이 이를 데이터로 취급하게 하세요.
# Vulnerable: the title is pasted into the script before the shell runs
- run: echo "Checking ${{ github.event.pull_request.title }}"
# Safe: the shell reads the title as data
- env:
PR_TITLE: ${{ github.event.pull_request.title }}
run: echo "Checking $PR_TITLE"
actions/github-script와 GITHUB_ENV에 쓰는 값에도 똑같이 적용됩니다. 워크플로 안의 AI
에이전트는 같은 문제의 새로운 형태를 더합니다. 이슈의 텍스트가 셸 대신 에이전트를 조종할 수 있습니다.
프롬프트 인젝션을 참조하세요.
시크릿과 배포
5. 장기 클라우드 키 대신 OIDC를 사용하세요
시크릿으로 저장된 클라우드 액세스 키는 누군가 교체할 때까지 작동하며, 유출된 뒤라면 그때는 이미 늦은 경우가 많습니다. OpenID Connect를 사용하면 작업이 GitHub에 단기 토큰을 요청하고 이를 AWS, Azure 또는 Google Cloud와 교환합니다. 어떤 리포지토리, 브랜치, 환경이 역할을 맡을 수 있는지는 클라우드 측의 신뢰 정책이 결정합니다.
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
steps:
- uses: aws-actions/configure-aws-credentials@<full-commit-sha>
with:
role-to-assume: arn:aws:iam::123456789012:role/deploy
aws-region: us-east-1
TanStack 사례가 보여 주듯 단기 토큰도 실행 중인 작업에서 탈취될 수 있지만, 만료되지 않는 키보다 가치가 훨씬 낮습니다. 계속 보관하는 시크릿은 작업 전체가 아니라 필요한 단계에만 전달해, 작업의 다른 액션이 읽을 수 없게 하세요. 시크릿이 유출되는 경로와 나머지 통제 수단은 GitHub Actions 시크릿: 유출 경로와 보호 방법에서 다룹니다.
6. 프로덕션을 필수 검토자가 있는 환경 뒤에 두세요
환경은 자체 시크릿을 보관하며, 환경을 지정한 작업은 필수 검토자가 실행을 승인할 때까지 그 시크릿을 읽을 수 없습니다. 배포 브랜치 규칙은 어떤 브랜치가 그 환경을 사용할 수 있는지 자체를 제한합니다. 그러면 기능 브랜치의 워크플로나 풀 리퀘스트로 트리거된 워크플로는 프로덕션 자격 증명에 접근할 경로가 없습니다.
거버넌스
7. 워크플로 파일에 코드 소유자 검토를 필수로 지정하세요
워크플로 파일은 시크릿을 가지고 무엇이 실행될지를 결정하므로, 그 변경은 프로덕션 접근 권한 변경과 같은 수준의 검토를
받아야 합니다. 폴더를 CODEOWNERS에 추가하고 브랜치 규칙 세트에서 코드 소유자 검토를 필수로 지정하세요.
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. 실행할 수 있는 액션을 제한하세요
엔터프라이즈, 조직 또는 리포지토리 수준에서 허용 액션 정책으로 GitHub, 인증된 제작자 또는 직접 관리하는 목록의
액션만 허용할 수 있습니다.
2025년
8월부터는 SHA 고정을 필수로 지정해 고정되지 않은 액션을 사용하는 워크플로를 실패시킬 수 있고, !
항목으로 특정 액션이나 버전을 차단할 수도 있습니다. 사용 중인 액션이 침해되었다고 보고된 날 유용합니다.
러너, 캐시, 아티팩트
9. 공개 리포지토리에서는 셀프 호스팅 러너를 사용하지 마세요
GitHub의 보안 사용 참조 문서는 누구나 풀 리퀘스트를 열어 셀프 호스팅 러너에서 코드를 실행할 수 있으므로, 공개 리포지토리에는 셀프 호스팅 러너를 거의 사용해서는 안 된다고 말합니다. 비공개 리포지토리에서는 작업마다 새로 시작하는 러너를 사용하세요. 오래 유지되는 러너는 한 작업이 남긴 것을 백도어까지 포함해 다음 작업에 그대로 넘깁니다. Shai-Hulud npm 웜이 감염된 머신을 셀프 호스팅 러너로 등록한 것도 바로 그 이유 때문입니다. 관리형 러너와 셀프 호스팅 러너 비교를 참조하세요.
10. 캐시를 오염으로부터 보호하세요
캐시는 브랜치 단위로 범위가 정해지며, 기본 브랜치에서 저장된 캐시는 다른 모든 브랜치에서 복원할 수 있습니다. 따라서 기본 브랜치의 어떤 워크플로에서든 실행되는 코드는 쓰기 토큰 없이도 나중에 릴리스 워크플로가 복원할 캐시 항목을 쓸 수 있습니다. 기본 브랜치 워크플로에서 신뢰할 수 없는 코드를 실행하지 말고, 릴리스 및 게시 작업에서는 캐시 복원을 피하고 대신 잠금 파일로부터 다시 빌드하세요. GitHub Actions 캐시의 작동 방식을 참조하세요.
11. 아티팩트를 신뢰할 수 없는 것으로 다루세요
actions/checkout은 끄지 않는 한 이후의 git 명령을 위해 토큰을 디스크에 보관합니다. 워크스페이스를
아티팩트로 업로드해 그 토큰이 유출된 사례가 있습니다. 푸시하지 않는 체크아웃에는
persist-credentials: false를 설정하고, 필요한 경로만 업로드하며, 풀 리퀘스트에서 나온 아티팩트를 특권
워크플로에서 절대 실행하지 마세요.
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
네트워크와 기록
12. 작업이 연결할 수 있는 곳을 통제하세요
GitHub 호스팅 러너는 아웃바운드 트래픽을 제한하지 않으므로, 작업 안의 코드는 읽은 것을 어디로든 보낼 수 있습니다. 대부분의 작업에 필요한 목적지는 패키지 레지스트리, 컨테이너 레지스트리, 소스 호스트, 몇 가지 API 정도로 짧습니다. 이것만 허용하고 나머지를 차단하면, 아무도 본 적 없는 공격이라도 탈취된 시크릿은 갈 곳이 없습니다. tj-actions 사례처럼 로그에 출력된 시크릿은 이그레스 정책으로 막을 수 없으므로, 이그레스 정책은 고정을 대신하는 것이 아니라 고정과 함께 사용해야 합니다. 이그레스 정책이 GitHub Actions에서의 데이터 유출을 막는 방법을 참조하세요.
13. 각 실행이 사용한 액션과 패키지를 기록하세요
다음 침해된 액션이나 패키지가 발표되면 가장 먼저 묻게 되는 것은 어떤 실행이 그것을 사용했는가입니다. 워크플로 파일은 실행이 무엇을 사용하도록 되어 있었는지를 말해 줍니다. 태그, 버전 범위, 캐시 적중 때문에 실제 답은 달라질 수 있으며, 이를 판가름하는 기록은 작업이 실행되는 동안 남긴 기록입니다. 각 액션의 커밋, 가져오거나 캐시에서 복원한 모든 패키지, 작업이 맺은 연결이 그것입니다. GitHub Actions의 SBOM을 참조하세요.
워크플로를 감사하는 무료 도구
위의 워크플로 항목 대부분은 자동으로 검사할 수 있습니다. 이 도구들은 워크플로 파일을 읽으며, 실행 중인 작업을 지켜보지는 않습니다.
| 도구 | 검사 내용 |
|---|---|
| zizmor | GitHub Actions, Dependabot, pre-commit 구성에 대한 정적 분석: 템플릿 인젝션, 위험한 트리거, 과도한 권한, 고정되지 않은 액션, 사칭 커밋, 캐시 오염, 체크아웃이 남긴 자격 증명 |
| actionlint |
워크플로 구문과 표현식을 위한 린터로, 인라인 스크립트에 사용된 신뢰할 수 없는 값도 표시하고 run
단계에 shellcheck를 실행합니다
|
| OpenSSF Scorecard | Dangerous-Workflow(신뢰할 수 없는 체크아웃과 스크립트 인젝션), Token-Permissions, Pinned-Dependencies를 포함한 리포지토리 검사 |
| poutine | BoostSecurity의 빌드 파이프라인용 오픈 소스 스캐너로, GitHub Actions, GitLab, Azure DevOps, Tekton을 다루며 조직의 모든 리포지토리를 스캔할 수 있습니다 |
| CodeQL | GitHub의 코드 스캔으로, 2025년부터 워크플로의 인젝션 및 pwn 리퀘스트 패턴을 분석해 왔습니다 |
.github/를 변경하는 풀 리퀘스트에서 이 중 하나를 실행하세요. 이 도구들이 러너 통제 및 보안 태세 도구와
어떻게 맞물리는지는 CI/CD 보안 도구 비교와
CI/CD 보안을 참조하세요. GitHub Actions 설정이 아니라 파이프라인 전체를 다루는
체크리스트는 CI/CD 파이프라인 보안 체크리스트를 참조하세요.
CRACI가 돕는 방법
CRACI는 GitHub Actions가 아니라 러너를 대체합니다. runs-on을 craci로 바꾸면 워크플로,
시크릿, 토큰 권한, 실행 내역은 GitHub에 그대로 남습니다. CRACI는 이 목록의 마지막 항목들, 즉 작업이 실행되는 동안
일어나는 일을 다룹니다.
- 이그레스 통제. 이그레스 정책은 작업이 어떤 패키지 소스, 레지스트리, 호스트에 접근할 수 있는지 결정합니다. 정책은 작업이 시작되기 전에 검증되고, 러너에서 적용되며, 실패 시 차단(fail closed)됩니다. 차단된 연결은 알림을 발생시킵니다.
-
각 실행의 기록. 작업의 SBOM은 작업이 실행한 GitHub Actions를 사용된 커밋에 고정된
pkg:github구성 요소로 나열하고, 캐시에서 복원된 패키지를 포함해 작업이 가져온 모든 패키지를 네트워크 연결 추적과 함께 기록합니다. 액션의 태그가 옮겨졌을 때 각 실행이 실제로 어떤 커밋을 실행했는지 확인할 수 있습니다. - 정책 게이트. 특정 CVE를 포함해, 알려진 취약점이 있는 패키지를 끌어오는 빌드를 중단할 수 있습니다.
- 격리. 각 작업은 자체 가상 머신에서 실행되므로 다음 작업으로 넘어가는 것이 없습니다.
CRACI는 워크플로 파일을 감사하거나 소스 코드를 스캔하거나 시크릿을 스캔하지 않으므로, 이를 위해서는 zizmor 같은 워크플로 린터, GitHub의 시크릿 스캔, 사용 중인 SAST 도구를 유지하세요. CRACI는 Linux에서 GitHub Actions 작업을 실행하며, 다른 CI 시스템은 로드맵에 있습니다.
GitHub Actions 보안: 자주 묻는 질문
GitHub Actions를 어떻게 보호합니까?
GITHUB_TOKEN을 읽기 전용으로 설정하고 작업별로 쓰기 권한을 부여하세요. 서드파티 액션을 고정하거나 잠그고, pull_request_target 워크플로에서 풀 리퀘스트 코드를 실행하지 말고, 이벤트 데이터는 환경 변수를 통해 스크립트에 전달하세요. 저장된 클라우드 키 대신 OIDC를 사용하고, 프로덕션 시크릿을 환경 뒤에 두고, 워크플로 파일 검토를 필수로 지정하고, 작업이 연결할 수 있는 곳을 통제하세요.
GitHub Actions를 커밋 SHA에 고정해야 합니까?
서드파티 액션이라면 그렇습니다. 2025년 tj-actions/changed-files와 2026년 trivy-action에서 일어난 것처럼 태그는 다른 코드로 옮겨질 수 있지만, 전체 커밋 SHA는 옮겨질 수 없습니다. GitHub의 워크플로 잠금 파일은 한 걸음 더 나아가, 액션이 호출하는 액션까지 잠급니다.
pull_request_target은 위험합니까?
워크플로가 풀 리퀘스트의 코드를 절대 실행하지 않을 때만 안전합니다. 포크에서 온 경우에도 베이스 리포지토리의 시크릿과 쓰기 토큰을 가진 채 실행되므로, 그 안에서 포크의 코드를 빌드하면 둘 다 풀 리퀘스트를 연 사람에게 넘어갑니다. GitHub는 2026년 12월 2일부터 이벤트 정책이 없는 공개 리포지토리에서 이를 기본적으로 차단합니다.
pwn 리퀘스트란 무엇입니까?
GitHub Security Lab이 붙인 이름으로, 주로 pull_request_target으로 트리거되는 특권 워크플로가 풀 리퀘스트의 신뢰할 수 없는 코드를 체크아웃해 실행함으로써 작성자에게 워크플로의 시크릿과 토큰에 대한 접근을 주는 경우를 말합니다.
워크플로 잠금 파일이 SHA 고정보다 낫습니까?
더 강력합니다. 잠금 파일은 워크플로가 사용하는 모든 액션의 커밋을 전이적인 것까지 포함해 기록하고, GitHub는 실행 시점에 소스 리포지토리의 신원을 확인합니다. 재사용 가능한 워크플로 호출은 대상이 아니므로 SHA로 고정하세요.
GitHub Actions 워크플로의 보안 문제를 검사하는 무료 도구는 무엇입니까?
zizmor, actionlint, OpenSSF Scorecard, poutine은 무료이며, CodeQL은 GitHub 코드 스캔의 일부로 워크플로를 분석할 수 있습니다. 이 도구들은 워크플로 파일을 읽으며, 작업이 실행되는 동안 하는 일을 통제하지는 않습니다.
워크플로가 실제로 무엇을 실행했는지 확인하세요
GitHub Actions 작업을 CRACI에서 실행하고, 모든 액션의 커밋과 가져온 모든 패키지, 실패 시 차단되는 이그레스 정책을 확인하세요.
데모 예약