Copy & Run

GitHub Dependabot 켜기: 취약한 의존성 알림과 자동 수정 PR 받기

오래된 버전을 고정한 requirements.txt를 시험 저장소에 넣고 Dependency graph, Dependabot alerts, Dependabot security updates를 켭니다. 알림 47건이 뜨는 것과 Dependabot이 올린 수정 풀 리퀘스트를 확인하고, 하나를 병합해 열린 알림이 36건으로 줄어드는 것까지 봅니다.

실습 노트 · 2026-11-18 발행 · 6분 · 2026-11 확인

내가 작성한 코드에 문제가 없어도 가져다 쓴 라이브러리에 취약점이 있으면 서비스가 영향을 받습니다. 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를 켭니다.

Advanced Security 화면에서 Dependency graph, Dependabot alerts, Dependabot security updates가 On으로 표시된 것을 확인합니다.
Advanced Security 화면에서 Dependency graph, Dependabot alerts, Dependabot security updates가 On으로 표시된 것을 확인합니다.

항목 하는 일
Dependency graph 의존성 파일을 읽어 저장소가 쓰는 패키지 목록을 만듭니다
Dependabot alerts 그 목록을 취약점 데이터베이스와 대조해 알림을 만듭니다
Dependabot security updates 패치 버전이 있는 알림에 대해 풀 리퀘스트를 자동으로 올립니다

아래 두 개는 Dependency graph가 켜져 있어야 동작합니다.

알림 확인

저장소의 Security 탭을 엽니다.

왼쪽 메뉴에서 Dependabot을 누릅니다.

Dependabot alerts 목록에 열린 알림 47건이 있고 맨 위에 Critical 등급의 Django와 PyYAML 알림이 표시된 것을 확인합니다.
Dependabot alerts 목록에 열린 알림 47건이 있고 맨 위에 Critical 등급의 Django와 PyYAML 알림이 표시된 것을 확인합니다.

열린 알림이 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 탭을 엽니다.

Pull requests 목록에 dependabot이 올린 Bump django from 3.1.0 to 5.2.17과 Bump urllib3 from 1.26.4 to 2.8.0이 있는 것을 확인합니다.
Pull requests 목록에 dependabot이 올린 Bump django from 3.1.0 to 5.2.17과 Bump urllib3 from 1.26.4 to 2.8.0이 있는 것을 확인합니다.

Dependabot이 풀 리퀘스트 두 개를 올렸습니다.

번호 제목
#4 Bump django from 3.1.0 to 5.2.17
#5 Bump urllib3 from 1.26.4 to 2.8.0

하나를 열어 봅니다.

풀 리퀘스트 화면 위쪽에 이 변경을 병합하면 critical 등급을 포함한 Django 알림이 해결된다는 안내가 표시된 것을 확인합니다.
풀 리퀘스트 화면 위쪽에 이 변경을 병합하면 critical 등급을 포함한 Django 알림이 해결된다는 안내가 표시된 것을 확인합니다.

화면 위쪽에 이 풀 리퀘스트를 병합하면 어떤 알림이 해결되는지 나옵니다. 바뀌는 것은 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

같은 카테고리의 글