2FA(2단계 인증)로 인증하는 동안 "2단계 인증 실패" 오류가 발생하는 경우, 입력하는 인증 코드가 올바르지 않습니다. 계정 복구를 시도하기 전에 구성된 인증 방법의 문제를 해결할 수 있습니다.
TOTP 앱을 사용한 인증 문제 해결
올바른 앱 사용
GitHub는 TOTP 앱으로 인증할 때 아무 코드도 보내지 않습니다. 2FA를 설정할 때 TOTP 앱에 저장한 비밀 키를 기반으로 GitHub에 유효한 코드를 제공해야 합니다. 처음 2FA를 설정할 때 사용했던 앱이나 프로그램을 찾아서 인증 코드를 받으세요.
디바이스의 날짜 및 시간 확인
TOTP 코드는 시간 기반입니다. 휴대폰 또는 컴퓨터의 시계가 GitHub의 서버와 동기화되지 않으면 코드가 유효하지 않습니다. 디바이스의 날짜, 시간, 표준 시간대를 네트워크 공급자를 통해 자동으로 설정되도록 하세요. 대부분의 모바일 디바이스에서는 자동으로 설정 옵션을 켜 두어야 합니다.
새 코드 대기 후 즉시 입력
코드는 30초마다 변경됩니다. TOTP 앱을 열고 다음 코드가 나타날 때까지 기다렸다가 새 코드가 나타나는 즉시 입력하세요. 공백이나 추가적인 문자를 입력하면 코드가 유효하지 않게 되므로 입력하지 마세요.
올바른 계정 항목 확인
대부분의 TOTP 앱은 단일 웹 사이트에 대해 여러 계정을 지원합니다. 앱의 올바른 항목에서 코드를 읽고 있는지 확인하세요. 다른 계정용으로 생성된 코드는 작동하지 않습니다.
TOTP 백업에서 복원
많은 TOTP 앱은 클라우드 백업 또는 키 내보내기를 지원합니다. 디바이스를 분실하거나 초기화하면, 앱의 백업에서 새 디바이스로 2FA 데이터를 복원할 수 있습니다. 자세한 내용은 앱 설명서를 참조하세요.
문제 해결로도 인증할 수 없는 경우 계정 복구
문제 해결 후에도 인증이 되지 않는다면, 계정에 미리 구성된 패스키, 또는 보안 키와 같은 다른 방법으로 인증을 시도해 보세요. 자세한 내용은 2단계 인증을 사용하여 GitHub에 액세스을(를) 참조하세요.
다른 인증 방법이 없다면 계정 복구 절차를 시도해야 합니다. 계정 복구에 대한 자세한 내용은 2FA 자격 증명이 손실된 경우 계정 복구을(를) 참조하세요.
복구 코드를 사용한 문제 해결
복구 코드를 사용할 때 "복구 코드 인증 실패" 오류가 발생하는 경우, 입력하는 코드가 유효하지 않은 것입니다. 복구 코드 문제를 해결할 수 있습니다.
한 번에 하나의 코드 사용
복구 코드 집합에는 둘 이상의 코드가 포함되어 있습니다. 각 코드는 중간에 하이픈이 있는 10자리의 영숫자 문자입니다(xxxxx-yyyyy).
다른 코드 시도
각 코드는 한 번만 사용할 수 있습니다. 이미 사용한 코드는 다시 사용할 수 없으므로 다른 코드를 입력하세요. 집합에 있는 다른 코드를 사용해 보세요.
올바른 코드 집합 사용 확인
2FA를 비활성화 후 다시 활성화하면 새로운 복구 코드 집합이 생성되어 이전 집합은 무효화됩니다. 새 코드 집합이 생성될 때마다 복구 코드도 무효화됩니다. 다른 코드 집합이 없을 수도 있다고 생각되더라도 디바이스, 백업, 암호 관리자에서 해당 코드를 검색해 볼 수 있습니다. 기본 파일 이름은 github-recovery-codes.txt입니다.