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

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

- 주소: https://copyandrun.com/blog/github-dependabot-alerts-security-updates/
- 분야: DevSecOps
- 발행일: 2026-11-18
- 태그: GitHub, Dependabot, 의존성 취약점, requirements.txt, 공급망 보안

내가 작성한 코드에 문제가 없어도 가져다 쓴 라이브러리에 취약점이 있으면 서비스가 영향을 받습니다. GitHub의 Dependabot은 저장소의 의존성 파일을 읽어 알려진 취약점을 알리고, 고칠 수 있는 경우 버전을 올리는 풀 리퀘스트를 대신 만들어 줍니다. 이 글에서는 일부러 오래된 버전을 고정한 저장소에서 설정을 켜고 결과를 확인합니다.

## 한 문장 답

저장소 Settings의 Advanced Security에서 Dependency graph, Dependabot alerts, Dependabot security updates를 켭니다. 의존성 파일에 취약한 버전이 있으면 Security 탭에 알림이 생기고, 패치 버전이 있는 항목은 Dependabot이 풀 리퀘스트를 올립니다.

## 준비물

| 항목 | 내용 |
| --- | --- |
| GitHub 계정 | 저장소 관리자 권한 |
| 시험 저장소 | 공개 저장소 하나. 이 글에서는 `cr-lab-secret-scanning` |
| 의존성 파일 | 오래된 버전을 고정한 `requirements.txt` |

공개 저장소에서는 세 기능을 무료로 쓸 수 있습니다.

## 시험용 의존성 파일

저장소에 아래 `requirements.txt`를 넣습니다. 모두 몇 년 전 버전입니다.

```text
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으로 표시된 것을 확인합니다.](https://copyandrun.com/img/github-dependabot-alerts-security-updates/02-after-enabled.png)

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

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

## 알림 확인

저장소의 Security 탭을 엽니다.

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

![Dependabot alerts 목록에 열린 알림 47건이 있고 맨 위에 Critical 등급의 Django와 PyYAML 알림이 표시된 것을 확인합니다.](https://copyandrun.com/img/github-dependabot-alerts-security-updates/03-alerts-list.png)

열린 알림이 47건입니다. 여섯 줄짜리 파일에서 나온 수입니다. 알림마다 등급, 패키지, 발견된 파일이 표시되고, 수정 풀 리퀘스트가 있으면 오른쪽에 번호가 붙습니다.

이 시험에서는 설정을 켠 뒤 15분쯤 알림이 0건이었고, `requirements.txt`를 바꾸는 커밋이 main에 들어간 뒤에 알림이 나타났습니다. 설정을 켰는데 알림이 없으면 조금 기다리거나 의존성 파일이 기본 브랜치에 있는지 확인합니다.

명령으로 패키지별 개수를 볼 수도 있습니다.

```bash
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이 있는 것을 확인합니다.](https://copyandrun.com/img/github-dependabot-alerts-security-updates/04-pull-requests.png)

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 알림이 해결된다는 안내가 표시된 것을 확인합니다.](https://copyandrun.com/img/github-dependabot-alerts-security-updates/05-fix-pull-request.png)

화면 위쪽에 이 풀 리퀘스트를 병합하면 어떤 알림이 해결되는지 나옵니다. 바뀌는 것은 `requirements.txt`의 버전 한 줄입니다.

두 풀 리퀘스트 모두 주 버전이 올라갑니다. Django는 3에서 5로, urllib3는 1에서 2로 바뀌므로 병합 전에 애플리케이션이 그 버전에서 동작하는지 시험해야 합니다. 자동으로 올라온다고 그대로 병합하면 서비스가 깨질 수 있습니다.

## 병합하고 알림 수 확인

`#5`를 병합합니다.

```bash
gh pr merge 5 --repo <계정>/cr-lab-secret-scanning --squash --delete-branch
```

조금 뒤 열린 알림 수를 다시 셉니다.

```bash
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](/blog/github-ruleset-protect-main-branch/)을 걸어 두었어도 Dependabot은 풀 리퀘스트로 올리기 때문에 규칙과 충돌하지 않습니다.
- 취약점 수정이 아닌 일반 버전 올리기는 별도 기능입니다. `dependabot.yml` 파일을 만들어 주기와 대상을 정합니다.
- 컨테이너 이미지 안의 패키지는 이 기능의 대상이 아닙니다. 이미지 검사는 [Trivy 게이트 글](/blog/trivy-image-scan-gate/)에서 다룹니다.

## 정리

시험이 끝나면 저장소를 지우거나, 남은 Dependabot 풀 리퀘스트를 닫습니다.

- [ ] Dependency graph, Dependabot alerts, Dependabot security updates를 켰습니다.
- [ ] Security 탭에서 알림 목록과 등급을 확인했습니다.
- [ ] Dependabot이 올린 풀 리퀘스트의 버전 변화를 확인했습니다.
- [ ] 시험을 거친 뒤 병합하고 열린 알림 수가 줄어드는 것을 확인했습니다.
