본문으로 건너뛰기
Novaz Authenticator받기

GitHub 2FA: 인증 앱 설정 방법

작성: Novaz 팀 · 업데이트: 2026년 10월 29일
Novaz 단계는 버전 1.0.5에서 확인함

영어 가이드를 번역한 글입니다. 서비스 웹사이트의 버튼과 메뉴는 한국어로 표시될 때 이름이 조금 다를 수 있습니다.

이 페이지의 내용
  1. 내 계정에 2FA가 필수인가요?
  2. 인증 앱으로 2FA 켜기
  3. 28일 점검
  4. 복구 코드
  5. GitHub가 코드를 요청할 때
  6. GitHub가 코드를 거부할 때
  7. 새 iPhone으로 옮길 때
  8. 인증 앱을 잃어버렸을 때
  9. 2FA 끄기
  10. GitHub 공식 도움말

GitHub 계정에는 리포지토리, 이슈, 풀 리퀘스트가 있으며, 이 계정에서는 2단계 인증(2FA)을 직접 선택할 수 없는 경우가 많습니다. 2023년 3월부터 GitHub는 코드를 기여하는 계정에 2FA를 요구하고 있으며, 조직은 멤버에게 2FA를 요구할 수 있습니다. GitHub는 기본 방법으로 인증 앱을 권장하며, 문서에서는 이를 TOTP 앱이라고 부릅니다. 처음 설정할 때 쓸 수 있는 다른 방법은 문자 메시지뿐이며, 패스키, 보안 키, GitHub Mobile은 나중에 추가할 수 있습니다(GitHub, GitHub). 이 가이드는 iPhone의 Authenticator App - Novaz를 사용하지만, 어떤 인증 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: GitHub 관련 단계는 GitHub Docs와 GitHub Blog(아래에 링크)를 바탕으로 했으며, 2026년 10월 20일에 읽었습니다. GitHub 계정으로 테스트하지는 않았으므로 레이블이 조금 다를 수 있습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

내 계정에 2FA가 필수인가요?

GitHub는 계정의 활동을 기준으로 대상을 선정합니다. 앱이나 액션 게시, 릴리스 생성, 조직 소유, 패키지를 게시하거나 GitHub가 중요도가 높다고 판단하는 리포지토리에 기여하는 경우입니다. 선정된 계정은 이메일과 배너로 안내를 받으며, 2FA를 설정할 수 있는 45일과 7일의 유예 기간이 주어집니다. 그 이후에는 2FA를 켤 때까지 GitHub.com을 이용할 수 없습니다. 회사의 Single Sign-On을 사용하더라도 면제되지 않습니다(GitHub).

GitHub에 전화번호를 줄 필요는 전혀 없습니다. 인증 앱만으로 충분합니다. GitHub가 문자 메시지를 제공하지 않는 지역에서는 인증 앱이 유일한 선택지이며, 보안 방법만 허용하는 조직에서도 보안 방법으로 인정됩니다(GitHub).

인증 앱으로 2FA 켜기

GitHub.com에서의 단계입니다(GitHub).

  1. 오른쪽 위의 프로필 사진을 클릭한 다음 Settings(설정)를 클릭하세요.
  2. 사이드바의 Access(액세스) 섹션에서 Password and authentication(비밀번호 및 인증)을 클릭하세요.
  3. Two-factor authentication(2단계 인증) 아래에서 Enable two-factor authentication(2단계 인증 활성화)을 클릭하세요.
  4. Scan the QR code(QR 코드 스캔) 아래에 GitHub가 QR 코드를 표시합니다. Novaz에서 **+**를 탭하고 QR 코드 스캔을 탭하세요. QR 코드가 같은 iPhone에 있다면 스크린샷을 찍고 사진 선택을 사용하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
  5. 스캔할 수 없나요? setup key(설정 키)를 클릭하면 비밀 키가 텍스트로 표시됩니다. Novaz에서 +, 키를 직접 입력을 탭하고 설정 키에 입력하세요. GitHub는 6자리, 30초, SHA-1을 사용하므로 직접 입력한 키도 작동합니다. 2FA 설정 키란 무엇인가요?를 참고하세요.
  6. Verify the code from the app(앱의 코드 확인) 아래에 Novaz의 코드를 입력하세요.
  7. Save your recovery codes(복구 코드 저장) 아래에서 Download(다운로드)를 클릭한 다음 I have saved my recovery codes(복구 코드를 저장했습니다)를 클릭하세요. 이 버튼을 클릭하면 2FA가 켜집니다.

28일 점검

2FA를 새로 설정하면 28일 점검이 시작됩니다. 그 기간 안에 2FA로 로그인을 한 번 완료하면 점검이 끝납니다. 그러지 않으면 28일째에 GitHub가 열려 있는 세션 중 하나에서 2FA를 요청합니다(GitHub). 잘못 설정된 인증 앱을 찾아내기 위한 절차입니다. 통과하지 못하면 GitHub가 계정이 잠기지 않은 상태로 2FA를 다시 설정할 수 있는 바로가기를 제공합니다(GitHub). 쉽게 통과하는 방법은 설정 직후 로그아웃했다가 Novaz의 코드로 다시 로그인하는 것입니다.

복구 코드

xxxxx-yyyyy 형식의 일회용 코드 16개를 받으며, 기본적으로 github-recovery-codes.txt로 저장됩니다(GitHub, GitHub). GitHub는 클라우드에 백업하는 인증 앱을 권장합니다(GitHub). Novaz에서는 iCloud 백업(PRO)이 이에 해당합니다. 직접 내보낸 백업 파일도 최신 상태로 유지한다면 괜찮습니다. 둘 다 없으면 키는 iPhone에만 있습니다. 휴대폰이 없어지고 백업도 없거나 오래된 날을 대비해, 어느 경우든 복구 코드를 보관하세요. GitHub는 비밀번호 관리자에 보관하라고 권합니다.

나중에 Password and authentication의 Recovery codes(복구 코드) 옆에 있는 View(보기)를 클릭하면 Download, Print(인쇄), Copy(복사)를 할 수 있습니다. Generate new recovery codes(새 복구 코드 생성)를 누르면 이전 세트가 무효가 되며, 2FA를 껐다가 다시 켜도 마찬가지입니다. 인증 앱을 바꾸는 것으로는 무효가 되지 않습니다(GitHub). 2FA 백업 코드를 참고하세요.

GitHub가 코드를 요청할 때

GitHub는 로그인할 때 비밀번호 다음에 코드를 요청합니다. 로그아웃했거나, 새 기기를 사용하거나, 세션이 만료되었거나, 민감한 작업을 할 때만 다시 요청합니다(GitHub). 민감한 작업에는 이메일 주소 변경, SSH 키 추가, 개인 액세스 토큰 생성, 복구 코드 보기가 포함됩니다. 이런 작업을 한 번 하면 GitHub는 2시간 동안 다시 묻지 않습니다(GitHub).

명령줄의 Git은 코드를 요청하지 않습니다. HTTPS는 개인 액세스 토큰을 사용하고, SSH는 이전과 같이 작동합니다(GitHub).

GitHub가 코드를 거부할 때

잘못된 코드를 입력하면 Two-factor authentication failed(2단계 인증 실패)가 표시됩니다. GitHub가 안내하는 확인 사항은 다음과 같습니다. 앱에서 설정한 바로 그 항목의 코드를 읽고, 휴대폰의 날짜와 시간을 자동으로 설정하고, 새 코드를 띄어쓰기 없이 바로 입력하세요(GitHub). iPhone에서는 설정 › 일반 › 날짜 및 시간 › 자동으로 설정입니다. Novaz는 시계가 15초 이상 어긋나면 알려 줍니다.

같은 페이지에 따르면 GitHub 지원팀은 “cannot assist with troubleshooting your 2FA methods”(2FA 방법의 문제 해결을 도와드릴 수 없습니다)라고 합니다(GitHub). 인증 앱 코드가 작동하지 않나요?를 참고하세요.

새 iPhone으로 옮길 때

2FA를 끌 필요는 없습니다. Password and authentication의 Two-factor methods(2단계 인증 방법) 아래에서 인증 앱 옆의 Edit(편집)를 클릭하세요(방법이 여러 개라면 먼저 그 옆의 메뉴를 여세요). 새 iPhone의 Novaz로 새 QR 코드를 스캔하고, 코드를 입력한 다음 Save(저장)를 클릭하세요. 복구 코드는 그대로 유지됩니다(GitHub). 그런 다음에만 이전 iPhone의 Novaz에서 GitHub를 삭제하세요. 계정을 열고 계정 삭제를 탭하면 됩니다. 이전 iPhone을 처분하기 전에 하세요. iCloud 백업이나 Novaz 백업 파일이 있다면 대신 새 iPhone에서 계정을 복원할 수 있으며, GitHub 항목도 계속 작동합니다. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

인증 앱을 잃어버렸을 때

GitHub가 안내하는 방법은 다음 순서입니다(GitHub).

  1. 추가해 둔 다른 방법: 패스키, 보안 키, GitHub Mobile 또는 문자 메시지.
  2. 복구 코드. 비밀번호를 입력한 후 More options(추가 옵션) 아래의 2FA recovery code(2FA 복구 코드)를 선택하고, 코드를 입력한 다음 Verify(확인)를 클릭하세요.
  3. 계정 복구. 같은 화면에서 Begin account or email recovery(계정 또는 이메일 복구 시작)를 선택한 다음 I understand, get started(이해했습니다, 시작하기)를 선택하세요. GitHub가 이메일로 보낸 일회용 비밀번호를 입력한 다음, Verify with this device(이 기기로 확인, 이전에 이 기기에서 로그인한 적이 있는 경우), SSH key(SSH 키) 또는 Personal access token(개인 액세스 토큰)으로 본인임을 증명하세요. GitHub 지원팀이 요청을 검토하고 영업일 기준 3일 이내에 이메일로 답변합니다.

비밀번호도 잊어버렸나요? 비밀번호 재설정부터 시작하세요. 그러면 GitHub가 같은 옵션을 제공합니다.

3번 방법은 미리 준비해 둔 경우에만 사용할 수 있습니다. GitHub는 인증 키로 추가한 SSH 키나, repo 범위가 있는 클래식 개인 액세스 토큰을 권합니다(GitHub). 쿠키를 매일 지우지 마세요. GitHub는 쿠키로 이전에 사용한 기기를 알아봅니다(GitHub).

아무것도 통하지 않으면 계정은 영영 되찾을 수 없습니다. 지원팀은 계정을 복원해 주지 않으며 신분증 확인도 받지 않습니다(GitHub). 그래도 이메일 주소의 연결을 해제해 새 계정에서 사용할 수는 있습니다. 인증 앱이 있는 휴대폰을 잃어버리셨나요?를 참고하세요.

2FA 끄기

Password and authentication에서 점 세 개 메뉴를 열고 Disable two-factor authentication(2단계 인증 비활성화)을 선택한 다음 확인하세요. 2FA를 요구하는 조직에는 접근할 수 없게 되며, GitHub가 2FA 필수 대상으로 선정한 계정이라면 아예 끌 수 없습니다(GitHub). 앱을 바꾸려면 대신 방법을 편집하세요.

GitHub 공식 도움말

가이드 더 보기: 개발자 도구