깃허브 2단계 인증 설정: 45일 기한·복구코드 16개
깃허브 2단계 인증은 메일 받은 날부터 52일 안에 끝내야 한다
깃허브 2단계 인증(2FA) 의무화 메일을 받았다면 45일 안에 2FA를 등록해야 한다. 45일이 지나면 7일 유예 기간이 붙고, 그때까지도 켜지 않으면 GitHub.com 접속이 막힌다(GitHub Docs, 2026). TOTP 앱 설정 자체보다 복구코드 16개를 따로 보관하고 인증 수단을 2개 이상 등록하는 데 시간을 더 쓰는 편이 낫다.
2단계 인증(2FA)은 비밀번호에 더해 휴대폰 앱 코드나 보안키 같은 두 번째 수단으로 본인임을 확인하는 로그인 방식이다. 깃허브는 기여 활동이 있는 계정을 골라 2FA를 의무로 요구한다. 대상이 아닌 계정도 같은 메뉴에서 직접 켤 수 있다.
의무 대상은 기여 활동으로 정해진다
깃허브는 계정의 기여 활동을 보고 의무 대상을 고른다(GitHub Docs, 2026). 아래 항목 중 하나라도 해당하면 메일을 받을 수 있다. 깃허브는 이 기준이 앞으로 바뀔 수 있다고 밝혔다.
- 앱이나 액션(Action)을 게시한 적이 있다
- 저장소에서 릴리스를 만든 적이 있다
- OpenSSF(오픈소스 보안 재단)가 추적하는 저장소처럼 중요도가 높은 저장소에 기여했다
- 중요도가 높은 저장소나 패키지를 게시한 저장소의 관리자 또는 기여자다
- 저장소나 다른 사용자가 있는 조직(Organization)의 소유자다
- 엔터프라이즈 관리자다
Enterprise Managed Users 계정과 사내 설치형 GitHub Enterprise Server 사용자는 의무 대상이 아니다. 의무화는 GitHub.com에 비밀번호를 둔 사용자에게만 적용된다. 조직이나 엔터프라이즈 관리자가 따로 거는 2FA 요구는 의무화 프로그램과 별개로 움직인다.
접속 차단일은 메일 수신일에 52일을 더해 계산한다
접속 차단일은 안내 메일을 받은 날에 등록 기간 45일과 유예 기간 7일을 더해 구한다. 아래 계산은 메일 수신일에 일수를 그대로 더한 값이다. 깃허브 문서는 기간을 며칠째부터 세는지 밝히지 않는다. 그래서 하루 차이가 날 수 있으니 계산한 날보다 며칠 먼저 끝내는 것이 안전하다.
내 마감일 계산 순서
- 깃허브 안내 메일의 수신 날짜를 확인한다(예: 2026-11-16).
- 수신일에 45일을 더한다. 이 날이 등록 기간이 끝나는 날이다(2026-11-16 + 45일 = 2026-12-31).
- 그 날짜에 7일을 더한다. 이 날이 유예 기간이 끝나는 날이다(2026-12-31 + 7일 = 2027-01-07).
- 유예 종료일이 지나면 접속이 막히므로 3단계 날짜 전에 설정을 끝낸다.
아래 표는 메일 수신일별 등록 마감일과 유예 종료일을 보여준다.
| 메일 수신일 | 등록 기간 종료(+45일) | 유예 종료(+52일) | 남은 여유(일) |
|---|---|---|---|
| 2026-11-16 | 2026-12-31 | 2027-01-07 | 52 |
| 2026-12-01 | 2027-01-15 | 2027-01-22 | 52 |
| 2027-01-10 | 2027-02-24 | 2027-03-03 | 52 |
등록 기간에는 깃허브 화면에 2FA 등록을 요구하는 배너가 뜬다. 유예 기간까지 지난 뒤 GitHub.com에 들어가면 2FA를 켜라는 화면만 나온다(GitHub Docs, 2026).
차단돼도 기존 토큰은 동작하지만 새 토큰은 못 만든다
접속이 막혀도 기존 PAT(개인 액세스 토큰)와 OAuth 토큰은 계속 동작한다. 깃허브는 자동화가 끊기지 않도록 기존 토큰을 살려 둔다고 설명한다(GitHub Docs, 2026). 2FA를 켜도 기존 토큰은 취소되거나 바뀌지 않는다.
잠긴 계정은 새 PAT를 만들 수 없고 새 OAuth 앱도 승인할 수 없다. CI(지속적 통합) 파이프라인의 토큰이 만료되면 교체할 토큰을 발급하지 못해 배포가 멈출 수 있다. 토큰 만료일이 마감일 근처라면 2FA부터 켜고 토큰을 교체한다. GitHub Actions 일정 작업을 돌린다면 GitHub Actions 크론 무료 사용량 가이드와 함께 토큰 만료일도 점검해 둔다.
| 상황 | 기존 PAT·OAuth 토큰 | 새 PAT 생성 | 새 앱 승인 | 웹 로그인 |
|---|---|---|---|---|
| 등록 기간(45일) | 동작 | 가능 | 가능 | 가능(배너 표시) |
| 유예 기간 종료 후 미등록 | 동작 | 불가 | 불가 | 2FA 등록 화면만 표시 |
| 2FA 등록 완료 | 동작(변경 없음) | 가능 | 가능 | 가능 |
TOTP 앱을 주 수단으로, 패스키·보안키를 백업으로 둔다
깃허브는 TOTP 앱을 주 인증 수단으로 권장한다(GitHub Docs, 2026). TOTP(시간 기반 일회용 비밀번호)는 앱이 30초마다 새 6자리 코드를 만들어 주는 방식이다. 패스키와 보안키는 아직 주 수단으로 쓸 수 없고 백업으로만 등록할 수 있다.
아래 표는 인증 수단별로 깃허브가 정한 역할과 주의점을 비교한다.
| 인증 수단 | 깃허브 권장 역할 | 등록 조건 | 주의점 |
|---|---|---|---|
| TOTP 앱 | 주 수단(권장) | 없음 | 휴대폰 분실에 대비해 앱 백업 설정 |
| 패스키 | 백업 | TOTP나 SMS 2FA를 먼저 설정 | 비밀번호와 2FA를 한 번에 충족 |
| 보안키(WebAuthn) | 백업 | TOTP나 SMS 2FA를 먼저 설정 | 패스키와 별개 수단(Windows Hello·Face ID·Touch ID는 패스키로 등록) |
| GitHub Mobile | 백업(패스키·보안키가 없을 때) | TOTP나 SMS 2FA를 먼저 설정 | 앱 로그인과 푸시 알림 허용 필요 |
| SMS | 비권장 | 전화번호, 지원 국가 | 가로채기·피싱에 약하고 수신이 불안정 |
| 이메일 | 2FA로 인정 안 됨 | — | 비밀번호 재설정 경로와 겹침 |
SMS는 한국에서 되지만 권장하지 않는다
대한민국은 깃허브가 SMS 2FA를 지원하는 국가 목록에 들어 있다(GitHub Docs, 2026). 깃허브는 문자 전송 성공률 때문에 일부 국가에서만 SMS를 지원한다. 그래도 TOTP 앱을 SMS보다 강하게 권장한다.
SMS 2FA는 조직 접근이 막힐 수 있다는 점도 문제다. 일부 조직과 엔터프라이즈는 SMS 2FA를 쓰는 멤버의 콘텐츠 접근을 차단한다. 이때는 TOTP 앱으로 바꾸고 SMS를 꺼야 한다. 예비 전화번호(fallback number)는 이제 새로 등록할 수 없다(GitHub Docs, 2026).
이메일과 SAML SSO는 2FA를 대신하지 못한다
이메일 인증은 깃허브 의무 2FA로 인정되지 않는다. 비밀번호 재설정에 이메일을 쓰기 때문에 두 번째 인증 수단은 메일함과 분리해야 한다는 이유다(GitHub Docs, 2026). 회사 SAML SSO로 로그인하더라도 GitHub.com 계정의 2FA는 따로 켜야 한다.
TOTP 앱으로 2FA를 설정하는 7단계
TOTP 2FA 설정은 깃허브 Settings 메뉴에서 끝난다. 시작 전에 휴대폰이나 PC에 TOTP 앱을 하나 설치한다. 깃허브는 TOTP 표준을 따르는 앱이면 무엇이든 쓸 수 있다고 안내한다(GitHub Docs, 2026).
- 오른쪽 위 프로필 사진을 누르고 Settings로 들어간다.
- 왼쪽 사이드바 Access 영역에서 Password and authentication을 연다.
- Two-factor authentication 영역에서 Enable two-factor authentication을 누른다.
- TOTP 앱으로 QR 코드를 스캔한다. 스캔이 안 되면 setup key를 눌러 비밀값을 직접 입력한다.
- 앱에 뜬 6자리 코드를 "Verify the code from the app" 칸에 넣는다.
- 복구코드를 내려받아 안전한 곳에 보관한다.
- I have saved my recovery codes를 눌러 설정을 마친다.
QR 코드 대신 수동으로 입력할 때는 아래 값을 쓴다. 대부분의 앱은 기본값이 같아서 비밀값만 넣으면 된다.
| 항목 | 값 |
|---|---|
| 유형 | TOTP |
| 레이블 | GitHub:<사용자명> |
| 발급자(Issuer) | GitHub |
| 알고리즘 | SHA1(기본값) |
| 자릿수 | 6자리(기본값) |
| 주기 | 30초(기본값) |
설정을 마친 뒤 같은 화면에서 패스키, 보안키, GitHub Mobile을 백업 수단으로 추가한다. 패스키는 Passkeys 영역의 Add a passkey에서, 보안키는 Security keys 옆 Add에서 등록한다. Windows Hello, Face ID, Touch ID도 패스키로 쓸 수 있다.
설정 후 28일 체크업을 통과해야 한다
체크업 기간은 2FA 설정 직후 28일 동안 실제로 2FA를 쓸 수 있는지 확인하는 기간이다(GitHub Docs, 2026). 이 기간에 2FA 로그인을 한 번 성공하면 체크업이 바로 끝난다. 한 번도 하지 않았다면 28일째에 기존 세션에서 2FA를 요구한다.
2026-11-16에 설정했다면 설정일에 28일을 더한 2026-12-14 무렵에 체크업 요청이 뜬다. 체크업에서 2FA를 통과하지 못하면 화면에 나오는 바로가기로 2FA를 다시 설정해야 접근을 유지할 수 있다. 설정 당일에 로그아웃했다가 TOTP 코드로 다시 로그인해 보면 체크업이 그 자리에서 끝난다.
설정 전 체크리스트: 복구 수단을 먼저 만든다
복구 수단은 휴대폰을 잃었을 때 계정을 되찾는 유일한 길이다. 깃허브 지원팀은 2FA 수단과 복구 수단을 모두 잃은 계정을 복구해 주지 않는다(GitHub Docs, 2026). 아래 항목을 설정 당일에 모두 채운다.
- [ ] 복구코드 16개를 내려받아 비밀번호 관리자에 저장했다
- [ ] 복구코드를 인쇄하거나 오프라인 사본을 하나 더 만들었다
- [ ] 인증 수단을 2개 이상 등록했다(TOTP 앱 + 패스키·보안키·GitHub Mobile 중 하나)
- [ ] TOTP 앱의 백업 기능을 켰다(앱마다 방법이 다르다)
- [ ] SSH 키를 1개 이상 등록하고 키 유형을 authentication으로 골랐다
- [ ] PAT를 1개 이상 만들고 repo 범위를 줬다
- [ ] 평소 쓰는 기기에서 GitHub.com에 로그인해 두었다
- [ ] 기본(primary) 이메일과 백업 이메일에 지금 접속할 수 있다
복구코드는 16개이고 한 번씩만 쓴다
복구코드는 2FA 수단을 잃었을 때 대신 입력하는 일회용 코드다. 깃허브는 코드 16개를 주며 각 코드는 한 번 쓰면 다시 쓸 수 없다(GitHub Docs, 2026). 코드는 Settings → Password and authentication → Recovery codes 옆 View에서 다시 내려받거나 인쇄하거나 복사할 수 있다.
새 복구코드를 생성하면 이전 코드 16개는 모두 무효가 된다. 2FA를 껐다가 다시 켜도 코드가 새로 바뀐다. 2FA를 끄지 않고 수단만 재구성하면 기존 코드가 그대로 유지된다. 코드를 다시 만들었다면 비밀번호 관리자와 인쇄본을 함께 바꿔야 한다.
SSH 키와 PAT도 복구 증거가 된다
SSH 키와 PAT는 복구코드가 없을 때 본인 확인 수단으로 쓰인다. SSH 키는 오래 쓰지 않으면 삭제될 수 있어서, 복구 증거로 쓰려면 주기적으로 사용해야 한다(GitHub Docs, 2026). 비공개 저장소를 정적 사이트로 배포하면서 SSH 키를 쓰고 있다면 비공개 저장소 무료 정적 배포 가이드에서 쓰는 키가 authentication 유형인지 함께 확인한다.
휴대폰을 잃었을 때 복구 순서
휴대폰을 잃었다면 복구코드부터 쓴다. 복구코드를 입력하면 지원팀 검토 없이 바로 계정에 다시 들어갈 수 있다(GitHub Docs, 2026). 복구코드가 없으면 패스키나 보안키, 그다음 계정 복구 신청 순서로 내려간다.
아래 표는 내가 가진 수단에 따라 어떤 경로로 복구하는지 판정한다.
| 가진 수단 | 복구 경로 | 비밀번호 필요 | 걸리는 시간 |
|---|---|---|---|
| 복구코드 | 로그인 → More options → 2FA recovery code → 코드 입력 | 필요(모르면 재설정 후 입력) | 즉시 |
| 패스키 | 패스키로 로그인 | 불필요 | 즉시 |
| 보안키 | 보조 수단으로 로그인 | 필요 | 즉시 |
| 인증된 기기·SSH 키·PAT 중 1개 | 계정 복구 신청 → 지원팀 검토 | 필요 | 영업일 3일 이내 답변 |
| 아무것도 없음 | 복구 불가 | — | 영구히 접근 불가 |
복구코드가 없으면 계정 복구를 신청한다
계정 복구 신청은 비밀번호를 알고 있어야 진행할 수 있다(GitHub Docs, 2026). 절차는 다음과 같다.
- github.com/login에서 로그인하고 2FA recovery code를 고른 뒤 Begin account or email recovery를 누른다.
- I understand, get started를 누른다.
- 인증된 이메일로 일회용 비밀번호를 받아 입력하고 Verify email address를 누른다.
- 이전에 로그인했던 기기, SSH 키, PAT 중 하나로 본인임을 확인한다.
- 깃허브 지원팀이 검토해 영업일 기준 3일 안에 답한다.
승인되면 복구를 마무리할 링크가 메일로 온다. 기다리는 동안에도 2FA 수단이나 복구코드를 찾으면 바로 로그인할 수 있다. 검토 중에 같은 요청을 다시 보내도 추가 요청은 검토하지 않는다.
비밀번호까지 잊었다면 재설정 링크를 3시간 안에 연다
비밀번호도 모른다면 github.com/password_reset에서 계정 이메일을 넣고 재설정을 요청한다. 기본 이메일이나 백업 이메일만 받을 수 있고, 메일 속 링크는 3시간 안에 눌러야 한다(GitHub Docs, 2026). 링크를 연 뒤 2FA 화면에서 Begin account or email recovery를 골라 앞의 절차를 똑같이 밟는다.
모든 수단을 잃으면 이메일만 새 계정으로 옮긴다
2FA 수단과 복구 수단이 하나도 남지 않으면 계정 접근을 영구히 잃는다. 깃허브 지원팀도 이 경우에는 계정을 되돌려 주지 않는다(GitHub Docs, 2026). 잠긴 계정에서 이메일 주소를 분리하면 그 이메일을 새 계정이나 기존 계정에 연결할 수 있다.
오늘 할 일: 마감일 확인과 백업 수단 등록
메일 수신일에 52일을 더해 차단일을 적어 두고, 그 전에 TOTP 앱 설정과 복구코드 저장을 끝낸다. 다른 AI·개발 도구 계정 설정은 AI·개발 도구 가이드 모음에서, 개발자들의 질문은 바이브 코딩 커뮤니티 탭에서 이어서 확인할 수 있다.
자주 묻는 질문
깃허브 2FA 메일을 무시하면 언제 접속이 막히나요?
메일을 받은 날부터 45일 등록 기간과 7일 유예 기간이 지나면 GitHub.com 접속이 막힌다(GitHub Docs, 2026). 메일 수신일에 52일을 더한 날짜를 차단일로 잡고, 하루 차이에 대비해 며칠 일찍 설정한다.
2FA를 켜면 기존 토큰을 다시 만들어야 하나요?
다시 만들 필요가 없다. 2FA를 켜도 기존 PAT와 OAuth 토큰은 취소되거나 바뀌지 않는다. 2FA를 켜지 않아 계정이 잠긴 상태에서는 새 PAT를 만들 수 없으므로 마감 전에 설정한다.
한국 휴대폰 번호로 SMS 인증을 써도 되나요?
대한민국은 깃허브 SMS 2FA 지원 국가라서 등록은 할 수 있다. 하지만 깃허브는 가로채기·피싱 위험 때문에 TOTP 앱을 강력히 권장한다. 일부 조직은 SMS 2FA를 쓰는 멤버의 접근을 막기도 한다.
패스키만 등록해서 2FA를 대신할 수 있나요?
대신할 수 없다. 패스키와 보안키는 TOTP나 SMS 2FA를 먼저 설정한 뒤에만 백업으로 추가할 수 있다. 등록한 뒤에는 패스키 하나로 비밀번호와 2FA를 함께 충족해 로그인할 수 있다.
복구코드를 다시 생성하면 예전 코드는 어떻게 되나요?
예전 코드 16개는 모두 무효가 된다. 2FA를 껐다 다시 켜도 코드가 바뀐다. 2FA를 끄지 않고 수단만 재구성하면 기존 코드는 그대로다.
출처
- GitHub, About mandatory two-factor authentication (2026): https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/about-mandatory-two-factor-authentication
- GitHub, Configuring two-factor authentication (2026): https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication
- GitHub, Configuring two-factor authentication recovery methods (2026): https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods
- GitHub, Recovering your account if you lose your 2FA credentials (2026): https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials
- GitHub, Countries where SMS authentication is supported (2026): https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported