Sourcetree git 인증 실패 에러 해결 방법

git 히스토리 및 pull request를 날렸을 때 comflict 나는 것을 쉽게 고칠 수 있는 장점 덕분에 소스트릐를 사용하고 있다.

하지만, 어느 날 소스 트리에서 풀을 받으려고 하니까 아래 에러가 발생하면서 풀이 받아지지 않았다.

 

Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.

 

 

이건 소스트리에서 git 사용자 인증 하는 방법을 사용자 이름(이메일)과 비밀번호로 하는 방식에서 토큰 방식으로 2021년 8월 13일부터 정책을 바꿨기 때문에 발생하는 일이다. 해당 정책 변경에 대해서 메일을 받았었으나 토큰 방식으로 바꾸지 않아서 위와 같은 에러가 발생하는 것이다.

 

 

Git Personal Access Token 발급 받기

우선 소스트리에 입력해줄 git 토큰을 발급 받아야한다.

깃으로 이동해서 우측 상단의 사용자 아이콘을 클릭해서 아래에 있는 Settings 메뉴를 클릭한다.

 

 

git 설정 화면에서 좌측 메뉴 리스트 아래의 Developer settings 메뉴로 들어간다.

 

 

Developer settings 화면에서 좌측 메뉴들 중 마지막 메뉴인 Personal access tokens 메뉴를 클릭 한 후 Generate new token 버튼을 눌러 토큰을 생성한다.

 

 

새로운 퍼스널 토큰을 생성할 때 Note에는 알아볼 수 있도록 토큰에 대한 설명이나 토큰의 이름을 적으면 된다. (그냥 나중에 이 토큰이 어디서 쓰이는지 알아보기 위함이다.)

Expiration은 토큰의 유효기간으로 어차피 소스트리에서 사용할 것이므로 No expiration으로 설정했다. (이렇게 하는 것은 토큰 정책 상 좋지 않은 것이긴 하다.)

마지막으로 해당 토큰으로 얻을 수 있는 권한은 repo만 선택하면 된다. 다른 권한은 굳이 주지 않아도 된다.

 

 

토큰을 생성하면 아래와 같이 토큰 값이 나타나면서 복사할 수 있게 된다.

참고로 다음에 다시 토큰 목록에 들어가면 해당 토큰 값을 다시 볼 수 없고, 토큰 값을 까먹어서 다시 토큰 값을 받아야할 때는 해당 토큰에 들어가서 Regenerate token 버튼을 통해 토큰 값을 다시 발급 받아야 한다. 토큰 값을 다시 발급 받으면 예전 토큰 값은 사용할 수 없으므로 예전 토큰 값을 새로 발급 받은 토큰 값으로 변경해줘야 한다.

 

 

 

소스트리에 토큰 값 입력하기

git에서 토큰을 발급 받고 해당 값을 복사했다면 이제 소스트리에 해당 토큰 값을 입력하면 된다.

이 방법은 매우 쉽다. 소스트리의 상단에 있는 설정 아이콘을 클릭한다.

 

 

설정 화면에서 원격 탭으로 이동해서 현재 해당 리포지토리에 연결되어 있는 원격 주소에 대해 편집 버튼을 클릭한다.

 

 

원격에 입력되어 있는 git 경로에 'github.com~' 앞에 '토큰 값@'를 붙여넣어준다. 즉, git 경로가 'https://토큰 값@github.com~'이 되는 것이다.

그러면 자동으로 사용자명에 토큰 값이 입력된다. 그리고 확인 버튼을 클릭해 설정한 git 원격 토큰 정보를 저장한다.

 

 

위의 방법으로 소스트리에 퍼스널 토큰 값을 저장한 후 다시 소스트리로 pull/push 등 git 동작을 해보면 정상 동작하는 것을 알 수 있다.