Skip to main content

이 버전의 GitHub Enterprise는 다음 날짜에 중단되었습니다. 2024-09-25. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

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

2FA를 사용하도록 설정하면 GitHub Enterprise Server에 로그인할 때 암호뿐만 아니라 2FA 인증 코드를 제공하라는 메시지가 표시됩니다.

2단계 인증을 사용하도록 설정한 경우 인증 코드를 제공하고 브라우저를 통해 GitHub Enterprise Server에 액세스할 때 보안 키를 사용해야 합니다. API 또는 명령줄과 같은 다른 방법을 사용하여 GitHub Enterprise Server에 액세스하는 경우 다른 형식의 인증을 사용해야 합니다. 자세한 내용은 "GitHub에 대한 인증 정보" 항목을 참조하세요.

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

암호를 사용하여 GitHub Enterprise Server에 로그인한 후에는 인증 코드를 제공하고 보안 키를 사용하여 2FA를 수행해야 합니다.

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

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

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

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

보안 키 사용

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

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

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

2FA를 사용하도록 설정한 후에는 더 이상 암호를 사용하여 명령줄의 GitHub Enterprise Server에 액세스하지 않습니다. 대신 Git 자격 증명 관리자, personal access token 또는 SSH 키를 사용합니다.

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

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

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

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

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

명령줄에서 사용자 이름과 암호 묻는 메시지가 표시되면 GitHub Enterprise Server 사용자 이름 및 personal access token을(를) 사용합니다. 명령줄 프롬프트는 암호를 요청할 때 personal access token을(를) 입력하도록 명시하지 않습니다.

자세한 내용은 "개인용 액세스 토큰 관리" 항목을 참조하세요.

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

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

2단계 인증으로 Subversion을 사용하여 리포지토리에 액세스

참고: GitHub 버전 3.13에서 Subversion 지원이 제거됩니다. 자세한 내용은 GitHub 블로그를 참조하세요.

Subversion을 통해 리포지토리에 액세스할 때 암호를 입력하는 대신 personal access token을(를) 제공해야 합니다. 자세한 내용은 "개인용 액세스 토큰 관리" 항목을 참조하세요.

문제 해결

2단계 인증 자격 증명에 대한 액세스 권한이 없어지면 복구 코드 또는 다른 복구 방법(설정한 경우)을 사용하여 계정에 대한 액세스 권한을 다시 얻을 수 있습니다. 자세한 내용은 "2FA 자격 증명이 손실된 경우 계정 복구" 항목을 참조하세요.

인증에 여러 번 실패하는 경우 휴대폰의 시계를 모바일 공급자와 동기화해야 합니다. 종종 자신의 표준 시간대를 제공하는 대신 휴대 전화의 시계에서 "자동으로 설정" 옵션을 확인하는 것을 포함합니다.

추가 참고 자료