git clone 시 Authentication failed 오류가 발생하는 경우

git clone 시 아래와 같이 'Authentication failed for ~'와 같은 오류가 발생하는 경우가 있다.

 

[제어판]-[사용자 계정]-[자격 증명 관리자]-[Windows 자격 증명]-[일반 자격 증명]에서

git:https://gitlab.com 항목에 정상적으로 '사용자 이름'과 '암호'가 등록돼있는 경우에도 아래와 같이 인증이 실패하면 git 계정에 MFA 설정이 걸려있는 상태이기 때문에 id/pwd 인증만으로는 CLI를 통해 접속할 수 없게 된다.

 

이런 경우 웹 콘솔에서 [Access Tokens]를 통해 임시 토큰을 발급 받아 액세스가 가능하다.

토큰을 생성할 때 [Select scopes]를 통해 어떠한 permission을 줄지 결정한 후 토큰을 발급받는다.

 

이제 아래 명령어를 통해 다시 액세스를 시도해보자.

git clone https://oauth2:PERSONAL_ACCESS_TOKEN@gitlab.com/username/projectname.git

 

정상적으로 Cloning 되나 싶더니, 아래 새로운 오류가 발생한다.

'Clone succeeded, but checkout failed'

'invaild path ~'

검색해보니 clone 하려는 원본 디렉토리에 Windows에서 파일명에 사용할 수 없는 규칙의 이름을 가진

파일이 존재하기 때문이었다.

Windows에서 파일명에 사용할 수 없는 문자열은 아래와 같다.

\ / : * ? " < > |​

 

간단하게 git repository에서 파일명을 변경한 후 다시 clone 하는 방법으로 해결할 수 있다.