2단계 인증을 사용하여 GitHub 액세스

2FA를 사용하도록 설정하면 로그인 GitHub할 때 2FA 인증 코드와 암호를 입력하라는 메시지가 표시됩니다.

이 기사에서

2단계 인증(2FA)이 활성화되면 브라우저를 통해 GitHub에 액세스할 때 두 번째 인증 수단을 사용해야 합니다. 2FA를 처음 구성할 때, 계정의 2FA 방법이 올바르게 설정되었는지 확인하기 위한 28일간의 계정 검사 기간이 시작됩니다. 이 28일 안에 2FA를 성공적으로 수행하면 검사 기간을 끝낼 수 있습니다. 28일 이내에 인증하지 않으면 기존 GitHub 세션 중 하나에서 2FA를 수행하라는 메시지가 표시됩니다. 28일째 검사를 통과하기 위해 2FA를 수행할 수 없는 경우 제공된 바로 가기를 사용하여 2FA 설정을 다시 구성하고 액세스 권한을 GitHub유지합니다. 자세한 내용은 2단계 인증 구성을(를) 참조하세요.

API 또는 명령줄과 같은 다른 메서드를 사용하여 액세스 GitHub 하는 경우 토큰, 애플리케이션 또는 SSH 키를 사용하여 인증합니다. 자세한 내용은 GitHub 인증 정보을(를) 참조하세요.

웹 사이트 로그인 시 2FA 수행

암호를 사용하여 로그인 GitHub 한 후에는 인증 코드를 제공하거나, 알림을 GitHub Mobile탭하거나, 보안 키를 사용하여 2FA를 수행해야 합니다.

GitHub 는 로그아웃했거나, 새 디바이스를 사용 중이거나, 중요한 작업을 수행하거나, 세션이 만료되는 경우에만 2FA 인증 코드를 다시 제공하도록 요청합니다. 중요한 작업의 2FA에 대한 자세한 내용은 sudo 모드을(를) 참조하세요.

TOTP 애플리케이션을 통해 코드 생성

TOTP 애플리케이션을 사용하여 2단계 인증을 설정하도록 선택한 경우 언제든지 인증 코드를 GitHub 생성할 수 있습니다. 대부분의 경우 애플리케이션을 시작하면 새 코드가 생성됩니다. 세부 지침은 애플리케이션의 설명서를 참조해야 합니다.

2단계 인증을 구성한 후 Authenticator 애플리케이션을 삭제하는 경우 계정에 액세스하려면 복구 코드를 제공해야 합니다. 많은 TOTP 앱이 클라우드에서 인증 코드의 안전한 백업을 지원하며, 디바이스에 대한 액세스 권한을 잃은 경우 복원할 수 있습니다. 자세한 내용은 2FA 자격 증명이 손실된 경우 계정 복구을(를) 참조하세요.

보안 키 사용

계정에 보안 키를 설정했고 브라우저에서 보안 키를 지원하는 경우, 보안 키를 사용하여 로그인을 완료할 수 있습니다.

  1. 사용자 이름과 암호를 사용하여 브라우저를 통해 GitHub에 로그인합니다.
  2. 물리적 보안 키를 사용하는 경우 디바이스에 연결되어 있어야 합니다.
  3. 운영 체제에서 보안 키 프롬프트를 트리거하려면 "보안 키 사용"을 선택합니다.
  4. 프롬프트에서 적절한 옵션을 선택합니다. 보안 키 구성에 따라 PIN을 입력하거나, 생체 인식 프롬프트를 완료하거나, 물리적 보안 키를 사용할 수 있습니다.

암호 사용

2FA를 사용하도록 설정하고 계정에 암호를 추가한 경우 암호를 사용하여 로그인할 수 있습니다. 암호 키는 암호 요구 사항과 2FA 요구 사항을 모두 충족하므로 한 단계로 로그인을 완료할 수 있습니다. 패스키 정보을(를) 참조하세요.

문자 메시지 수신

문자 메시지를 GitHub 통해 2단계 인증을 설정하는 경우 인증 코드가 포함된 문자 메시지를 보냅니다.

GitHub Mobile을 사용한 확인

GitHub Mobile을(를) 설치하고 로그인한 경우 2단계 인증용으로 GitHub Mobile를 사용해 인증하도록 선택할 수 있습니다.

  1. GitHub 사용자 이름 및 암호를 사용하여 브라우저로 로그인합니다.

  2. GitHub 는 로그인 시도를 확인하기 위해 푸시 알림을 보냅니다. 푸시 알림을 열거나 앱을 열 GitHub Mobile 면 이 로그인 시도를 승인하거나 거부하라는 프롬프트가 표시됩니다.

    참고

    이 프롬프트를 사용하려면 로그인하는 브라우저 내에 표시되는 두 자리 숫자를 입력해야 할 수 있습니다.

    • 로그인 시도를 GitHub Mobile승인하면 브라우저에서 로그인 시도를 자동으로 완료합니다.
    • 로그인 시도를 거부하면 인증이 완료되지 않습니다. 자세한 내용은 계정 및 데이터 보안 유지을(를) 참조하세요.

명령줄에서 2단계 인증 사용

Git 자격 증명 관리자를 사용하여 명령줄에서 인증

Git 자격 증명 관리자는 Windows, macOS 및 Linux에서 실행되는 보안 Git 자격 증명 도우미입니다. Git 자격 증명 도우미에 대한 자세한 내용은 Pro Git 설명서에서 반복 방지를 참조하세요.

설치 지침은 컴퓨터의 운영 체제에 따라 달라집니다. 자세한 내용은 GitCredentialManager/git-credential-manager 리포지토리의 다운로드 및 설치를 참조하세요.

HTTPS를 사용하여 명령줄에서 인증

HTTPS URL을 사용해 명령줄에서 personal access token에 인증할 때 암호로 사용할 GitHub를 만들어야 합니다.

명령줄에서 사용자 이름과 암호를 묻는 메시지가 표시되면 GitHub 사용자 이름과 personal access token를 사용하세요. 명령줄 프롬프트는 암호를 요청할 때 personal access token를 입력해야 한다는 점을 명시하지 않습니다.

자세한 내용은 개인용 액세스 토큰 관리을(를) 참조하세요.

SSH를 사용하여 명령줄에서 인증

2FA를 사용하도록 설정해도 SSH URL을 사용하여 명령줄에서 인증하는 GitHub 방법은 변경되지 않습니다. SSH 키를 설정하고 사용하는 방법에 대한 자세한 내용은 SSH를 사용하여 GitHub 연결을(를) 참조하세요.

문제 해결

2FA로 인증하는 동안 "2단계 인증 실패" 오류가 발생하는 경우, 입력하는 인증 코드가 올바르지 않은 것입니다. 계정 복구를 시도하기 전에 구성된 인증 방법의 문제를 해결할 수 있습니다. 2단계 인증 문제 해결을(를) 참조하세요.

추가 참고 자료