Git에서 GitHub 자격 증명 캐싱

HTTPS를 사용하여 GitHub 리포지토리를 복제하는 경우 GitHub CLI 또는 GCM(Git Credential Manager)을 사용하여 자격 증명을 기억해두는 것이 좋습니다.

Platform navigation

이 문서의 내용

팁: SSH를 사용하여 GitHub 리포지토리를 복제하는 경우 다른 자격 증명을 사용하는 대신 SSH 키를 사용하여 인증할 수 있습니다. SSH 연결을 설정하는 방법에 대한 자세한 내용은 "SSH를 통한 GitHub 연결”을(를) 참조하세요.

GitHub CLI

GitHub CLI는 Git 작업의 기본 프로토콜로 HTTPS가 선택된 경우 자동으로 Git 자격 증명을 저장하고 GitHub 자격 증명으로 Git에 인증할지 묻는 프롬프트에 “예”라고 대답합니다.

  1. macOS, Windows 또는 Linux에 GitHub CLI를 설치합니다.
  2. 명령줄에서 gh auth login을 입력하고 프롬프트를 따릅니다.
    • Git 작업의 기본 프로토콜을 묻는 메시지가 표시되면 HTTPS를 선택합니다.
    • GitHub 자격 증명으로 Git에 인증할 것인지 묻는 메시지가 표시되면 Y를 입력합니다.

GitHub CLI에서 인증하는 방법에 대한 자세한 내용은 gh auth login을 참조하세요.

Git Credential Manager

GCM(Git Credential Manager)은 자격 증명을 안전하게 저장하고 HTTPS를 통해 GitHub에 연결하는 또 다른 방법입니다. GCM을 사용하면 GCM이 2FA(2단계 인증)를 비롯한 인증을 사용자 대신 관리하므로 수동으로 personal access token을(를) 만들고 저장할 필요가 없습니다.

  1. Homebrew를 사용하여 Git을 설치합니다.

    brew install git

  2. Homebrew를 사용하여 GCM을 설치합니다.

    brew install --cask git-credential-manager

macOS의 경우 GCM이 자동으로 Git을 구성하므로 git config를 실행할 필요가 없습니다.

다음에 인증이 필요한 HTTPS URL을 복제할 때 Git에서 브라우저 창을 사용하여 로그인하라는 메시지를 표시합니다. 먼저 OAuth app에 권한을 부여하라는 메시지가 표시될 수 있습니다. 계정 또는 조직에 2단계 인증이 필요한 경우 2FA 과제도 완료해야 합니다.

성공적으로 인증되면 자격 증명이 macOS 키 집합에 저장되고 HTTPS URL을 복제할 때마다 사용됩니다. 자격 증명을 변경하지 않는 한, Git에서 명령줄에 자격 증명을 다시 입력하도록 요구하지 않습니다.

  1. GCM을 포함하는 Git for Windows를 설치합니다. 자세한 내용은 릴리스 페이지에서 “Git for Windows 릴리스”를 참조하세요.

항상 최신 버전을 설치하는 것이 좋습니다. 최소한 GitHub에 대한 OAuth 지원을 제공하는 첫 번째 버전인 버전 2.29 이상을 설치합니다.

다음에 인증이 필요한 HTTPS URL을 복제할 때 Git에서 브라우저 창을 사용하여 로그인하라는 메시지를 표시합니다. 먼저 OAuth app에 권한을 부여하라는 메시지가 표시될 수 있습니다. 계정 또는 조직에 2단계 인증이 필요한 경우 2FA 과제도 완료해야 합니다.

성공적으로 인증되면 자격 증명이 Windows Credential Manager에 저장되고 HTTPS URL을 복제할 때마다 사용됩니다. 자격 증명을 변경하지 않는 한, Git에서 명령줄에 자격 증명을 다시 입력하도록 요구하지 않습니다.


경고: 이전 버전의 Git for Windows는 Windows용 Git Credential Manager와 함께 제공되었습니다. 이전 제품은 더 이상 지원되지 않으며 OAuth를 통해 GitHub에 연결할 수 없습니다. 최신 버전의 Git for Windows로 업그레이드하는 것이 좋습니다.

경고: Windows용 자격 증명 관리자에서 잘못되었거나 오래된 자격 증명을 캐시한 경우 Git에서 GitHub에 액세스하지 못합니다. Git에서 자격 증명을 입력하라는 메시지가 표시되도록 캐시된 자격 증명을 초기화하려면 Windows 제어판의 사용자 계정 > 자격 증명 관리자에서 자격 증명 관리자에 액세스합니다. GitHub 항목을 찾아서 삭제합니다.

Linux의 경우 Git 및 GCM을 설치한 다음, GCM을 사용하도록 Git을 구성합니다.

  1. 배포판의 패키징 시스템에서 Git을 설치합니다. 지침은 실행하는 Linux 버전에 따라 다릅니다.

  2. GCM을 설치합니다. GCM 리포지토리의 지침을 참조하세요. 지침은 실행하는 Linux 버전에 따라 다릅니다.

  3. GCM을 사용하도록 Git을 구성합니다. 선택할 수 있는 백업 저장소가 여러 개 있으므로 GCM 문서를 참조하여 설정을 완료합니다. 자세한 내용은 “GCM Linux”를 참조하세요.

다음에 인증이 필요한 HTTPS URL을 복제할 때 Git에서 브라우저 창을 사용하여 로그인하라는 메시지를 표시합니다. 먼저 OAuth app에 권한을 부여하라는 메시지가 표시될 수 있습니다. 계정 또는 조직에 2단계 인증이 필요한 경우 2FA 과제도 완료해야 합니다.

성공적으로 인증되면 자격 증명이 해당 시스템에 저장되고 HTTPS URL을 복제할 때마다 사용됩니다. 자격 증명을 변경하지 않는 한, Git에서 명령줄에 자격 증명을 다시 입력하도록 요구하지 않습니다.

Linux에 자격 증명을 저장하는 방법에 대한 자세한 내용은 Pro Git에서 자격 증명 스토리지를 참조하세요.


자세한 내용을 보거나 GCM 관련 이슈를 보고하려면 “Git Credential Manager”에서 공식 GCM 문서를 참조하세요.