Copy & Run

GitHub Actions 워크플로 하드닝: 위험 패턴 찾고 고치기

일부러 취약하게 만든 워크플로를 zizmor로 점검해 여섯 건을 찾고, 커밋 SHA 고정과 권한 최소화 등으로 고쳐 0건이 되는지 확인합니다. act로 수정본이 로컬에서 도는지도 시험합니다.

실습 노트 · 2026-10-25 발행 · 19분 · 2026-10 확인

워크플로 파일도 코드라서 취약점이 생깁니다. 이 글에서는 위험 패턴을 일부러 넣은 ci.yml 하나를 만들어 zizmor로 점검하고, 고친 뒤 다시 점검해 결과가 어떻게 달라지는지 봅니다. 점검 결과는 작은 Flask 화면으로 읽고, 수정본은 act로 로컬 Docker에서 실행해 봅니다. 코드 검사 자체를 CI에 붙이는 방법은 Semgrep과 Bandit 게이트 글에 있어서 여기서는 다루지 않습니다. 실제 GitHub 저장소와 토큰은 쓰지 않으며, 취약한 워크플로는 점검만 하고 실행하지 않습니다.

준비물

항목 내용
Python 3.12
zizmor 1.31.1
Flask 3.1.3
act 0.2.89 (nektos/act)
Docker 로컬에서 컨테이너를 실행할 수 있는 상태 (act가 사용)
네트워크 act가 액션을 내려받을 때 필요
예상 소요 시간 약 30분 (act 이미지 내려받기 제외)

작업 폴더와 가상환경을 만들고 zizmor와 Flask를 설치합니다. Windows에서는 Git Bash를 쓰고 가상환경 활성화는 .venv\Scripts\activate로 바꿉니다.

mkdir -p ~/actions-lab && cd ~/actions-lab
python -m venv .venv
source .venv/bin/activate
pip install zizmor flask
zizmor --version

기대 출력입니다.

zizmor 1.31.1

act는 릴리스 페이지에서 운영체제에 맞는 파일을 받아 PATH에 둡니다. 이 글은 Windows용 0.2.89 실행 파일로 확인했습니다. 실행에 쓸 이미지는 미리 받아 둡니다. 용량이 약 2.3GB입니다.

act --version
docker pull catthehacker/ubuntu:act-latest
act version 0.2.89

이 글에 나오는 코드 파일은 모두 본문에 전체를 실었고, 같은 파일을 글 맨 위의 실습 코드 내려받기에서도 받을 수 있습니다. 내려받은 파일 이름은 폴더 구분 없이 평평해서 sample-ci.yml은 sample/.github/workflows/ci.yml에, fixed-ci.yml은 fixed/.github/workflows/ci.yml에 해당합니다.

이 단계의 파일 내려받기:fixed-ci.ymlsample-ci.yml

1. 취약한 샘플 저장소 만들기

테스트할 코드는 두 줄짜리 함수 하나입니다. 워크플로가 이 테스트를 실행합니다.

mkdir -p sample/.github/workflows sample/tests
cat > sample/calc.py <<'PY'
def add(a, b):
    return a + b
PY
cat > sample/tests/test_calc.py <<'PY'
import unittest

from calc import add


class AddTest(unittest.TestCase):
    def test_add(self):
        self.assertEqual(add(2, 3), 5)


if __name__ == "__main__":
    unittest.main()
PY

이제 취약한 워크플로입니다. 실무에서 자주 나오는 실수를 한 파일에 모았습니다. 액션을 태그와 브랜치 이름으로 참조하고, permissions를 쓰지 않고, pull_request_target에서 PR의 코드를 체크아웃하고, PR 제목을 run 스크립트에 직접 끼워 넣고, 시크릿을 로그에 찍습니다.

cat > sample/.github/workflows/ci.yml <<'YML'
name: ci
on:
  pull_request_target:
    types: [opened, synchronize]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha }}
      - uses: actions/setup-python@main
        with:
          python-version: "3.12"
      - name: Show PR title
        run: echo "Testing PR ${{ github.event.pull_request.title }}"
      - name: Run tests
        run: python -m unittest discover -s tests
        env:
          API_TOKEN: ${{ secrets.API_TOKEN }}
      - name: Debug token
        run: echo "token=${{ secrets.API_TOKEN }}"
YML

pull_request_target은 포크에서 온 PR에도 저장소의 시크릿과 쓰기 권한 토큰을 줍니다. 그 상태에서 PR 작성자가 낸 코드(head.sha)를 받아 실행하면, 외부 사람이 만든 코드가 시크릿 옆에서 돕니다. 이 글에서는 점검만 하고 실행하지 않습니다.

이 단계의 파일 내려받기:calc.pysample-ci.ymltest_calc.py

2. zizmor로 점검하기

--offline을 주면 GitHub API를 부르지 않고 파일만 읽어서, 토큰 없이도 같은 결과가 나옵니다. 발견 사항이 있으면 종료 코드가 0이 아닌 값으로 나옵니다. 먼저 규칙 이름만 추려 보고, 종료 코드를 따로 확인합니다.

zizmor --offline sample 2>&1 | grep -E "^(error|warning)\[|findings"
zizmor --offline sample > /dev/null; echo "exit=$?"

기대 출력입니다.

warning[artipacked]: credential persistence through GitHub Actions artifacts
warning[excessive-permissions]: overly broad permissions
error[dangerous-triggers]: use of fundamentally insecure workflow trigger
error[template-injection]: code injection via template expansion
error[unpinned-uses]: unpinned action reference
error[unpinned-uses]: unpinned action reference
12 findings (6 suppressed, 2 unsafe fixes): 0 informational, 0 low, 2 medium, 4 high
exit=14

요약 줄의 12 findings (6 suppressed ...)는 기본 설정에서 보이지 않게 가려진 항목이 여섯 건 더 있다는 뜻입니다. 화면에 나온 것은 기본 페르소나(regular)가 보여 주는 여섯 건이고, 종료 코드는 14였습니다.

zizmor가 규칙 이름과 함께 여섯 건을 보고하고, 수정본에서는 No findings와 exit=0이 찍히는 것을 확인합니다.
zizmor가 규칙 이름과 함께 여섯 건을 보고하고, 수정본에서는 No findings와 exit=0이 찍히는 것을 확인합니다.

3. 발견 항목 읽기

실제 출력에 나온 여섯 건을 표로 정리합니다. 줄 번호는 ci.yml 기준입니다.

규칙 심각도 위치 무엇이 문제인가
dangerous-triggers High 3줄 pull_request_target 트리거 자체를 위험으로 판단
excessive-permissions Medium 6줄 permissions가 없어 잡이 기본 토큰 권한을 그대로 받음
artipacked Medium 9줄 체크아웃이 토큰을 .git 설정에 남김 (persist-credentials: false 없음)
unpinned-uses High 9줄 actions/checkout@v4가 커밋 해시가 아닌 태그
unpinned-uses High 12줄 actions/setup-python@main이 움직이는 브랜치
template-injection High 16줄 ${{ github.event.pull_request.title }}가 셸 스크립트 안으로 펼쳐짐

기본 출력은 dangerous-triggers를 3줄, template-injection을 16줄 35번째 칸으로 가리킵니다. 7절의 뷰어는 JSON에 담긴 시작 위치를 쓰기 때문에 각각 on: 블록이 시작하는 2줄과 단계가 시작하는 15줄로 보입니다. 같은 항목이라도 두 화면의 줄 번호가 다를 수 있습니다.

시크릿을 로그에 찍는 22줄(echo "token=${{ secrets.API_TOKEN }}")은 기본 설정에서는 보고되지 않았습니다. --persona auditor를 주면 같은 줄이 template-injection(help 등급)과 secrets-outside-env로 더 나오고, 전체가 12건으로 늘어납니다. 시크릿 값은 Actions 로그에서 ***로 가려지지만, 가려지는 것에 기대는 방식은 줄이는 편이 안전합니다. 이 글의 수정본은 시크릿 사용 자체를 없앴습니다.

4. 스크립트 인젝션을 act로 확인하기

template-injection이 실제로 어떤 일을 일으키는지 act로 확인합니다. 취약한 ci.yml은 체크아웃이 github.com에 있는 PR 커밋을 받으려 해서 로컬에서 돌지 않으므로(뒤의 확인 범위에 적었습니다), 제목을 쓰는 단계만 뽑아 두 가지 방식으로 비교하는 작은 워크플로를 따로 만듭니다.

mkdir -p demo/.github/workflows
cat > demo/.github/workflows/inject-demo.yml <<'YML'
name: inject-demo
on: pull_request
permissions: {}
jobs:
  before:
    runs-on: ubuntu-latest
    steps:
      - name: Show PR title (직접 삽입)
        run: echo "Testing PR ${{ github.event.pull_request.title }}"
  after:
    runs-on: ubuntu-latest
    steps:
      - name: Show PR title (env 로 전달)
        env:
          PR_TITLE: ${{ github.event.pull_request.title }}
        run: echo "Testing PR $PR_TITLE"
YML

PR 이벤트 파일의 제목은 fix typo $(id)입니다. 셸에서 $(id)는 명령 치환이라, 제목에 이런 문자열을 넣은 사람이 러너에서 명령을 실행하게 됩니다. 여기서는 무해한 id로만 시연합니다.

cat > event.json <<'JSON'
{"action":"opened","pull_request":{"title":"fix typo $(id)","head":{"sha":"0000000"}}}
JSON

act는 이 이벤트를 pull_request 이벤트로 받아 실행합니다. 폴더가 git 저장소가 아니면 unable to get git revision 경고가 나오지만 실행은 됩니다.

cd demo
act pull_request -e ../event.json -P ubuntu-latest=catthehacker/ubuntu:act-latest --container-architecture linux/amd64 2>&1 | grep -E 'Testing PR|Job '
cd ..

기대 출력입니다. act가 줄 앞에 붙이는 아이콘은 뺐습니다. 실행 순서에 따라 before와 after 줄의 순서는 바뀔 수 있습니다.

[inject-demo/after ]   | Testing PR fix typo $(id)
[inject-demo/before]   | Testing PR fix typo uid=0(root) gid=0(root) groups=0(root)
[inject-demo/before] Job succeeded
[inject-demo/after ] Job succeeded

직접 삽입한 before에서는 $(id)가 실행되어 uid=0(root) ...가 찍혔고, 환경 변수로 넘긴 after에서는 제목이 글자 그대로 출력됐습니다. 같은 입력인데 넘기는 방식에 따라 값이 코드가 되느냐 데이터로 남느냐가 갈립니다.

before 잡에서는 $(id)가 uid=0(root) 출력으로 바뀌고 after 잡에서는 $(id)가 그대로 출력되는 것을 확인합니다.
before 잡에서는 $(id)가 uid=0(root) 출력으로 바뀌고 after 잡에서는 $(id)가 그대로 출력되는 것을 확인합니다.

이 단계의 파일 내려받기:event.jsoninject-demo.yml

5. 워크플로 고치기

이제 fixed 폴더를 만들어 고친 워크플로를 둡니다. 코드 파일은 그대로 복사하고, 고치는 곳은 ci.yml 하나입니다.

mkdir -p fixed/.github/workflows fixed/tests
cp sample/calc.py fixed/
cp sample/tests/test_calc.py fixed/tests/
cat > fixed/.github/workflows/ci.yml <<'YML'
name: ci
on:
  pull_request:
    types: [opened, synchronize]
permissions: {}
jobs:
  test:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
        with:
          persist-credentials: false
      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
        with:
          python-version: "3.12"
      - name: Show PR title
        env:
          PR_TITLE: ${{ github.event.pull_request.title }}
        run: echo "Testing PR $PR_TITLE"
      - name: Run tests
        run: python -m unittest discover -s tests
YML

고친 내용은 다음과 같습니다.

발견 항목 수정
dangerous-triggers pull_request_target을 pull_request로 바꿨습니다. GitHub 문서 기준으로 포크 PR에서는 시크릿이 전달되지 않고 토큰도 읽기 전용입니다. 이 글에서 재현하지는 않았습니다.
excessive-permissions 워크플로 전체에는 permissions: {}를 두고, 잡에는 contents: read만 줬습니다.
artipacked 체크아웃에 persist-credentials: false를 줬습니다.
unpinned-uses 두 액션을 공식 저장소의 커밋 SHA로 고정하고 주석에 태그를 남겼습니다.
template-injection 제목을 env의 PR_TITLE로 넘기고 스크립트에서는 $PR_TITLE로 읽습니다.
시크릿 출력 테스트에 시크릿이 필요하지 않아 API_TOKEN 사용과 출력 단계를 모두 지웠습니다.

예시 SHA는 git ls-remote https://github.com/actions/checkout.git refs/tags/v4.2.2처럼 공식 저장소에서 직접 조회한 값입니다. 조회 결과 actions/checkout의 v4.2.2는 11bd71901bbe5b1630ceea73d27597364c9af683, actions/setup-python의 v5.6.0은 a26af69be951a213d495a4c3e4e4022e16d87065였습니다. 실제로 쓸 때는 같은 명령으로 다시 확인하고, 업데이트는 Dependabot 같은 도구에 맡기는 편이 편합니다.

이 단계의 파일 내려받기:calc.pyfixed-ci.ymltest_calc.py

6. 다시 점검하기

수정본을 같은 방법으로 점검합니다.

zizmor --offline fixed; echo "exit=$?"
No findings to report. Good job! (2 suppressed)
exit=0

기본 설정에서는 0건이고 종료 코드가 0입니다. 가려진 두 건은 --persona auditor로 볼 수 있습니다.

zizmor --offline --persona auditor fixed 2>&1 | grep -E "^[a-z]+\[|findings"
info[anonymous-definition]: workflow or action definition without a name
help[concurrency-limits]: insufficient job-level concurrency limits
2 findings: 1 informational, 1 low, 0 medium, 0 high

남은 두 건은 test 잡에 name:이 없다는 것과 concurrency 설정이 없다는 것으로, 보안 결함이 아니라 정리 수준의 제안입니다. 이 글에서는 그대로 두었습니다.

7. 보고서를 웹 화면으로 보기

터미널 출력이 길어지면 읽기 어렵습니다. zizmor의 JSON 출력을 읽어 목록과 항목 상세를 보여 주는 Flask 뷰어를 만듭니다. JSON에서 규칙 이름, 심각도, 위치, 문제 코드 조각, 자동 수정 가능 여부를 꺼냅니다.

cat > viewer.py <<'PY'
import json
import sys
from html import escape
from pathlib import Path

from flask import Flask, abort

app = Flask(__name__)
REPORTS = {}  # 이름 -> 발견 항목 목록

CSS = """
body{font:15px 'Malgun Gothic',sans-serif;margin:0;color:#1f2933;background:#f6f8fa}
header{background:#24292f;color:#fff;padding:14px 32px}
header a{color:#9ecbff;margin-right:18px;text-decoration:none}
main{padding:24px 32px}
.banner{padding:14px 18px;border-radius:8px;font-weight:700;font-size:18px;color:#fff}
.fail{background:#c62828}.pass{background:#2e7d32}
table{border-collapse:collapse;width:100%;margin-top:20px;background:#fff}
th,td{border:1px solid #d5dbe1;padding:8px 10px;text-align:left;vertical-align:top}
th{background:#f1f4f7}
.sev{padding:2px 8px;border-radius:4px;color:#fff;font-weight:700;font-size:13px}
.high{background:#c62828}.medium{background:#ef6c00}.low{background:#6b7280}.informational{background:#6b7280}
pre{background:#0d1117;color:#e6edf3;padding:14px;border-radius:6px;overflow:auto;font-size:14px;line-height:1.5}
.note{background:#fff8e1;border-left:4px solid #f9a825;padding:10px 14px;margin:14px 0}
dl{display:grid;grid-template-columns:120px 1fr;gap:6px 12px;background:#fff;padding:14px;border:1px solid #d5dbe1}
dt{font-weight:700}dd{margin:0}
"""


def load(path):
    out = []
    for f in json.loads(Path(path).read_text(encoding="utf-8")):
        loc = f["locations"][0]
        out.append({
            "rule": f["ident"],
            "desc": f["desc"],
            "url": f["url"],
            "severity": f["determinations"]["severity"],
            "confidence": f["determinations"]["confidence"],
            "persona": f["determinations"]["persona"],
            "file": loc["symbolic"]["key"]["Local"]["verbatim_path"].replace("\\", "/"),
            "line": loc["concrete"]["location"]["start_point"]["row"] + 1,
            "note": loc["symbolic"].get("annotation", ""),
            "snippet": loc["concrete"]["feature"],
            "fixes": [x["title"] for x in f.get("fixes", [])],
        })
    out.sort(key=lambda x: (x["file"], x["line"]))
    return out


def page(title, body):
    nav = "".join(f'<a href="/r/{n}">{escape(n)}</a>' for n in REPORTS)
    return (f'<!doctype html><meta charset="utf-8"><title>{escape(title)}</title><style>{CSS}</style>'
            f'<header><b>zizmor 보고서 뷰어</b> &nbsp; {nav}</header><main>{body}</main>')


@app.route("/")
def index():
    rows = "".join(
        f'<tr><td><a href="/r/{n}">{escape(n)}</a></td><td>{len(items)}</td></tr>'
        for n, items in REPORTS.items()
    )
    return page("보고서 목록", f"<h2>보고서 목록</h2><table><tr><th>이름</th><th>발견 항목</th></tr>{rows}</table>")


@app.route("/r/<name>")
def report(name):
    items = REPORTS.get(name)
    if items is None:
        abort(404)
    ok = not items
    banner = "발견 항목 0건: 점검 통과" if ok else f"발견 항목 {len(items)}건: 수정 필요"
    rows = "".join(
        f'<tr><td><span class="sev {x["severity"].lower()}">{x["severity"]}</span></td>'
        f'<td><a href="/r/{name}/{i}">{escape(x["rule"])}</a></td>'
        f'<td><code>{escape(x["file"])}:{x["line"]}</code></td><td>{escape(x["desc"])}</td></tr>'
        for i, x in enumerate(items)
    )
    table = "" if ok else f"<table><tr><th>심각도</th><th>규칙</th><th>위치</th><th>설명</th></tr>{rows}</table>"
    body = f'<div class="banner {"pass" if ok else "fail"}">{banner}</div>{table}'
    return page(f"{name} 보고서", body)


@app.route("/r/<name>/<int:i>")
def detail(name, i):
    items = REPORTS.get(name)
    if items is None or i >= len(items):
        abort(404)
    x = items[i]
    fixes = ", ".join(x["fixes"]) or "자동 수정 없음"
    body = (
        f'<h2>{escape(x["rule"])}</h2>'
        f'<dl><dt>설명</dt><dd>{escape(x["desc"])}</dd>'
        f'<dt>심각도</dt><dd><span class="sev {x["severity"].lower()}">{x["severity"]}</span> (확신도 {x["confidence"]})</dd>'
        f'<dt>위치</dt><dd><code>{escape(x["file"])}:{x["line"]}</code></dd>'
        f'<dt>자동 수정</dt><dd>{escape(fixes)}</dd>'
        f'<dt>문서</dt><dd>{escape(x["url"])}</dd></dl>'
        f'<div class="note">{escape(x["note"])}</div>'
        f'<pre>{escape(x["snippet"])}</pre>'
        f'<p><a href="/r/{name}">목록으로</a></p>'
    )
    return page(x["rule"], body)


if __name__ == "__main__":
    # 사용법: python viewer.py 이름=보고서.json [이름=보고서.json ...] [--port 5311]
    args = sys.argv[1:]
    port = 5311
    if "--port" in args:
        k = args.index("--port")
        port = int(args[k + 1])
        del args[k:k + 2]
    for a in args:
        n, p = a.split("=", 1)
        REPORTS[n] = load(p)
    app.run(host="127.0.0.1", port=port)
PY

수정 전과 수정 후 보고서를 JSON으로 저장합니다. 발견 사항이 있어 종료 코드가 14로 끝나도 파일은 정상적으로 만들어집니다.

mkdir -p reports
zizmor --offline --format json sample > reports/before.json
zizmor --offline --format json fixed > reports/after.json
python viewer.py before=reports/before.json after=reports/after.json --port 5311

브라우저에서 http://127.0.0.1:5311/r/before를 엽니다. 여섯 건이 심각도와 위치별로 표에 나오고 상단에 빨간 띠가 표시됩니다.

수정 전 보고서에서 High 네 건과 Medium 두 건이 규칙 이름과 위치별로 나열되고 상단이 발견 항목 6건으로 표시되는 것을 확인합니다.
수정 전 보고서에서 High 네 건과 Medium 두 건이 규칙 이름과 위치별로 나열되고 상단이 발견 항목 6건으로 표시되는 것을 확인합니다.

규칙 이름을 누르면 항목 상세가 열립니다. template-injection에서는 문제의 run 줄과 자동 수정 방법(replace expression with environment variable)이 보입니다.

template-injection 상세에서 심각도 High와 문제가 된 echo 줄, 자동 수정 안내가 함께 보이는 것을 확인합니다.
template-injection 상세에서 심각도 High와 문제가 된 echo 줄, 자동 수정 안내가 함께 보이는 것을 확인합니다.

http://127.0.0.1:5311/r/after에서는 표가 비고 띠가 초록색으로 바뀝니다.

수정 후 보고서에서 발견 항목 0건으로 점검을 통과한 초록 띠가 표시되는 것을 확인합니다.
수정 후 보고서에서 발견 항목 0건으로 점검을 통과한 초록 띠가 표시되는 것을 확인합니다.

확인이 끝나면 뷰어를 Ctrl+C로 종료합니다.

이 단계의 파일 내려받기:viewer.py

8. act로 수정본 실행하기

수정한 워크플로가 실제로 도는지 act로 봅니다. 위의 event.json을 그대로 씁니다.

cd fixed
act pull_request -e ../event.json -P ubuntu-latest=catthehacker/ubuntu:act-latest --container-architecture linux/amd64 2>&1 | grep -E 'Success - Main|Ran |Testing PR|Job |^\[ci/test\]   \| OK'
cd ..

기대 출력입니다. act가 줄 앞에 붙이는 아이콘은 뺐고, 소요 시간 숫자는 달라집니다. 처음 실행할 때는 setup-python이 파이썬을 내려받느라 훨씬 오래 걸립니다.

[ci/test]   Success - Main actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 [46.0344ms]
[ci/test]   Success - Main actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 [3.3363792s]
[ci/test]   | Testing PR fix typo $(id)
[ci/test]   Success - Main Show PR title [159.8303ms]
[ci/test]   | Ran 1 test in 0.000s
[ci/test]   | OK
[ci/test]   Success - Main Run tests [214.3638ms]
[ci/test] Job succeeded

SHA로 고정한 두 액션이 내려받아져 실행됐고, PR 제목은 $(id)가 실행되지 않고 글자 그대로 출력됐으며, 단위 테스트가 통과했습니다.

SHA로 고정한 액션 두 개와 제목 출력, 테스트 실행 단계가 모두 Success로 끝나고 Job succeeded가 나오는 것을 확인합니다.
SHA로 고정한 액션 두 개와 제목 출력, 테스트 실행 단계가 모두 Success로 끝나고 Job succeeded가 나오는 것을 확인합니다.

실습이 끝나면 만든 폴더를 지우고, act 이미지가 필요 없으면 docker rmi catthehacker/ubuntu:act-latest로 지웁니다.

이 단계의 파일 내려받기:event.json

자주 막히는 곳

Windows에서 zizmor가 경로를 sample\.github\...처럼 역슬래시로 보여 줍니다. 경로 표기만 다를 뿐 결과는 같습니다. 뷰어는 역슬래시를 슬래시로 바꿔 보여 줍니다.

--offline 없이 돌리니 일부 점검이 토큰을 요구합니다. 액션이 알려진 취약 버전인지, 커밋이 저장소에 실제로 있는지 같은 점검은 GitHub API를 부릅니다. 이 글은 --offline으로만 확인했고 온라인 점검은 실행하지 않았습니다.

act가 unable to get git revision 경고를 냅니다. 폴더가 git 저장소가 아닐 때 나옵니다. 이 글에서는 경고만 나오고 실행은 성공했습니다. 이 경고가 거슬리면 폴더에서 git init을 해 둡니다.

act의 체크아웃 단계가 not our ref로 실패합니다. 이벤트 파일의 head.sha가 github.com의 실제 저장소에 없는 커밋이기 때문입니다. 취약한 ci.yml처럼 ref를 지정한 체크아웃은 로컬 실험용 이벤트로는 돌지 않습니다.

Apple Silicon 등에서 이미지 아키텍처 오류가 납니다. --container-architecture linux/amd64를 붙입니다. 이 글의 명령은 Windows의 amd64 환경에서만 확인했습니다.

이어서 해 볼 것

  • CI에 zizmor 붙이기: 워크플로가 바뀔 때 zizmor --offline .github/workflows를 실행하고 종료 코드로 실패시킵니다. 파이프라인 구성은 CI 게이트 글을 참고합니다.
  • 자동 수정 써 보기: template-injection처럼 자동 수정이 가능한 항목은 zizmor의 --fix 옵션으로 고칠 수 있습니다. 바뀐 파일을 git diff로 직접 검토한 뒤 받아들입니다.
  • 환경(environment)에 시크릿 묶기: auditor 페르소나가 보고한 secrets-outside-env를 없애려면 시크릿을 보호된 environment에 두고 잡에서 지정합니다.

확인 범위

  • 해 본 것: zizmor 1.31.1의 --offline 점검(수정 전 6건, 수정 후 0건), --persona auditor 결과, JSON 보고서와 Flask 뷰어, act 0.2.89로 돌린 인젝션 비교 워크플로와 수정본 ci.yml을 실행했습니다. 환경은 Windows 11, Python 3.12.10, Docker, catthehacker/ubuntu:act-latest 이미지입니다. 두 SHA는 공식 저장소에서 git ls-remote로 조회했습니다.
  • 해 보지 않은 것: 취약한 ci.yml 자체는 act로 실행하지 않았습니다. 체크아웃이 github.com에서 PR 커밋을 찾는데 샘플에는 그런 커밋이 없어서 not our ref로 실패하기 때문입니다. pull_request_target이 시크릿과 쓰기 토큰을 주는 동작, permissions 제한의 효과, 시크릿 마스킹은 act가 GitHub와 똑같이 재현하지 않으므로 확인하지 못했습니다. 실제 GitHub 저장소에서도 실행하지 않았습니다. 온라인 모드의 점검과 --fix 옵션도 실행하지 않았습니다.
  • 읽을 때 주의: 적용하기 전에 직접 돌려 확인하시기 바랍니다.

이 글은 스타트업·소규모 조직 보안 구축 로드맵의 한 단계입니다.

이 글의 다음 단계

  • CI에 Semgrep과 Bandit 보안 게이트 붙이기Bandit과 Semgrep을 GitHub Actions에서 돌려 심각도 기준으로 빌드를 실패시키는 설정을 만듭니다. 같은 검사를 로컬에서 먼저 돌려 종료 코드로 통과와 실패를 확인합니다.
  • npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.

DevSecOps 실무 과정의 일부입니다

이 실습은 교육에서 참가자마다 독립된 환경으로 진행합니다. 원하는 일정을 고르면 문의 양식에 미리 채워집니다.

과정 보기

팀이나 교육 담당자에게 이 글 제안하기

교육 진행 순서와 자주 묻는 질문 보기

같은 카테고리의 글