내가 작성한 코드에 문제가 없어도 가져다 쓴 라이브러리에 취약점이 있으면 서비스가 영향을 받습니다. GitHub의 Dependabot은 저장소의 의존성 파일을 읽어 알려진 취약점을 알리고, 고칠 수 있는 경우 버전을 올리는 풀 리퀘스트를 대신 만들어 줍니다. 이 글에서는 일부러 오래된 버전을 고정한 저장소에서 설정을 켜고 결과를 확인합니다.
한 문장 답
저장소 Settings의 Advanced Security에서 Dependency graph, Dependabot alerts, Dependabot security updates를 켭니다. 의존성 파일에 취약한 버전이 있으면 Security 탭에 알림이 생기고, 패치 버전이 있는 항목은 Dependabot이 풀 리퀘스트를 올립니다.
준비물
| 항목 | 내용 |
|---|---|
| GitHub 계정 | 저장소 관리자 권한 |
| 시험 저장소 | 공개 저장소 하나. 이 글에서는 cr-lab-secret-scanning |
| 의존성 파일 | 오래된 버전을 고정한 requirements.txt |
공개 저장소에서는 세 기능을 무료로 쓸 수 있습니다.
시험용 의존성 파일
저장소에 아래 requirements.txt를 넣습니다. 모두 몇 년 전 버전입니다.
flask==2.0.1
jinja2==2.11.2
requests==2.25.0
urllib3==1.26.4
pyyaml==5.3.1
django==3.1.0
설정 켜기
저장소의 Settings를 엽니다.
왼쪽 메뉴의 Security and quality 아래에서 Advanced Security를 누릅니다.
Dependency Scanning의 Dependency graph를 켭니다.
Dependabot의 Dependabot alerts를 켭니다.
Dependabot security updates를 켭니다.

| 항목 | 하는 일 |
|---|---|
| Dependency graph | 의존성 파일을 읽어 저장소가 쓰는 패키지 목록을 만듭니다 |
| Dependabot alerts | 그 목록을 취약점 데이터베이스와 대조해 알림을 만듭니다 |
| Dependabot security updates | 패치 버전이 있는 알림에 대해 풀 리퀘스트를 자동으로 올립니다 |
아래 두 개는 Dependency graph가 켜져 있어야 동작합니다.
알림 확인
저장소의 Security 탭을 엽니다.
왼쪽 메뉴에서 Dependabot을 누릅니다.

열린 알림이 47건입니다. 여섯 줄짜리 파일에서 나온 수입니다. 알림마다 등급, 패키지, 발견된 파일이 표시되고, 수정 풀 리퀘스트가 있으면 오른쪽에 번호가 붙습니다.
이 시험에서는 설정을 켠 뒤 15분쯤 알림이 0건이었고, requirements.txt를 바꾸는 커밋이 main에 들어간 뒤에 알림이 나타났습니다. 설정을 켰는데 알림이 없으면 조금 기다리거나 의존성 파일이 기본 브랜치에 있는지 확인합니다.
명령으로 패키지별 개수를 볼 수도 있습니다.
gh api "repos/<계정>/cr-lab-secret-scanning/dependabot/alerts?state=open&per_page=100" \
--jq '.[] | "\(.security_vulnerability.severity) \(.dependency.package.name)"' | sort | uniq -c
자동 수정 풀 리퀘스트
Pull requests 탭을 엽니다.

Dependabot이 풀 리퀘스트 두 개를 올렸습니다.
| 번호 | 제목 |
|---|---|
| #4 | Bump django from 3.1.0 to 5.2.17 |
| #5 | Bump urllib3 from 1.26.4 to 2.8.0 |
하나를 열어 봅니다.

화면 위쪽에 이 풀 리퀘스트를 병합하면 어떤 알림이 해결되는지 나옵니다. 바뀌는 것은 requirements.txt의 버전 한 줄입니다.
두 풀 리퀘스트 모두 주 버전이 올라갑니다. Django는 3에서 5로, urllib3는 1에서 2로 바뀌므로 병합 전에 애플리케이션이 그 버전에서 동작하는지 시험해야 합니다. 자동으로 올라온다고 그대로 병합하면 서비스가 깨질 수 있습니다.
병합하고 알림 수 확인
#5를 병합합니다.
gh pr merge 5 --repo <계정>/cr-lab-secret-scanning --squash --delete-branch
조금 뒤 열린 알림 수를 다시 셉니다.
gh api "repos/<계정>/cr-lab-secret-scanning/dependabot/alerts?state=open&per_page=100" --jq 'length'
| 시점 | 열린 알림 |
|---|---|
| 병합 전 | 47 |
#5 병합 뒤 |
36 |
urllib3 알림 11건이 한 번에 닫혔습니다. 닫힌 알림은 지워지지 않고 Closed 목록에 fixed 상태로 남습니다.
알아 둘 점
- 풀 리퀘스트가 모든 알림에 생기지는 않습니다. 이 시험에서도 알림은 여섯 패키지에서 나왔지만 처음 올라온 풀 리퀘스트는 둘이었습니다. 나머지는 알림 화면에서 하나씩 확인합니다.
- main에 ruleset을 걸어 두었어도 Dependabot은 풀 리퀘스트로 올리기 때문에 규칙과 충돌하지 않습니다.
- 취약점 수정이 아닌 일반 버전 올리기는 별도 기능입니다.
dependabot.yml파일을 만들어 주기와 대상을 정합니다. - 컨테이너 이미지 안의 패키지는 이 기능의 대상이 아닙니다. 이미지 검사는 Trivy 게이트 글에서 다룹니다.
정리
시험이 끝나면 저장소를 지우거나, 남은 Dependabot 풀 리퀘스트를 닫습니다.
- Dependency graph, Dependabot alerts, Dependabot security updates를 켰습니다.
- Security 탭에서 알림 목록과 등급을 확인했습니다.
- Dependabot이 올린 풀 리퀘스트의 버전 변화를 확인했습니다.
- 시험을 거친 뒤 병합하고 열린 알림 수가 줄어드는 것을 확인했습니다.
이 글의 다음 단계
- GitHub ruleset으로 main 보호: 직접 푸시와 강제 푸시 막기GitHub 저장소에 ruleset을 만들어 main 브랜치의 삭제, 직접 푸시, 강제 푸시를 막습니다. 규칙을 켠 뒤 직접 푸시와 강제 푸시가 GH013 오류로 거부되는 것을 확인하고, 풀 리퀘스트로는 같은 변경이 들어가는 것까지 시험합니다.
- GitHub push protection 확인: 비밀값이 든 푸시가 막히는지 시험하기GitHub 공개 저장소에서 secret scanning과 push protection 설정을 확인하고, 무작위로 만든 가짜 AWS 키를 커밋해 푸시가 GH013 오류로 거부되는 것을 시험합니다. 차단된 뒤 커밋에서 값을 빼고 다시 푸시하는 방법과 허용 화면의 세 가지 선택지를 정리합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com