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