git personal access token 발급, 설정하는 방법

안녕하세요, 첼린지맨입니다.
오늘은 github remote push를 진행했는데, 아래와 같은 에러 메시지가 발생하면서 push가 되지않았습니다.

- 에러 메시지
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: unable to access 'https://github.com/sominparrrk/repoName.git/': The requested URL returned error: 403

에러 메시지를 읽어보니, 인증방식이 기존 비밀번호에서 personal access token 방식으로 변경이 되었더라고요.
그래서 github에서 personal access token을 생성하고, windows나 macOS에 맞게 설정을 해주어야 합니다.
우선, personal access token 생성하는 방법부터 알아보도록 하겠습니다. 위에 에러에 나타난 url을 타고 들어가시면 상세한 설명이 나와있습니다. 아래 링크로 들어가보세요.
https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/

Token authentication requirements for Git operations | The GitHub Blog

personal access token을 시행하게 된 배경부터 해서 쭉 설명해주고 있는데, 중간쯤 보면 생성하는 방법을 설명해주는 링크가 있어요. 그걸 클릭해서 들어가주시면 되는데, 좀 더 빠른 진행을 위해 아래 링크를 타고 들어가세요.
https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token

Creating a personal access token - GitHub Docs

그럼 그림과 함께 설명이 쭉 나열되어 있는데, 따라가시면 됩니다. 그림으로 친절히 설명을 해놓아서 따라가서 토큰을 생성하는 것은 쉽게 할 수 있을겁니다.
1. github 로그인 -> setting 탭 이동

github 홈페이지 설명 발췌

2. setting탭 눌러 들어가면 아래쪽에 'Developer settings'탭을 눌러 이동, personal access tokens 클릭합니다.

github 홈페이지 설명 발췌

3. Generate new token을 클릭하시고, Note 이름을 넣고, 유효기간을 설정합니다. 유효기간은 7~90일까지 있었는데, 저는 30일정도로 설정했습니다.

github 홈페이지 설명 발췌

4. repo 범위 설정을 합니다. 아래와 같이 친절히 알려주기때문에 동일하게 설정해주세요. 혹시 추가로 다른것도 하실 거면 설정하셔도 됩니다.

github 홈페이지 설명 발췌

5. 토큰 생성을 클릭해 주시면, 최종적으로 아래와 같은 토큰이 생성됩니다. 이 토큰은 페이지가 벗어나면 사라져서 볼 수 없기떄문에 복사해서 메모장이든 다른 곳이든 복사해서 저장해주시기 바랍니다.

github 홈페이지 설명 발췌

이렇게 설정하고, 이제 push하면 remote push가 될까요? 해봤는데 당연히 되지 않았습니다. github 페이지에서는 비밀번호 -> personal access token으로 변경하라고 했는데, 이에 대한 자세한 설명을 제가 찾기 못해서 블로그 참조해서 진행했는데요, 저의 경우는 블로그를 보고 했는데도 계속 에러가 나길래 제가 해결한 방법에 대해서 적어보겠습니다.
personal access token을 발급을 했으니, 이제 제어판 -> 모든 제어판 항목 ->자격 증명 관리자 으로 이동합니다.

밑에 보면 일반 자격 증명 탭이 있고, 이 탭 밑에 보시면 "git:https://github.com"이라고 되어있는 증명이 있을거에요. 거기서 "편집"을 눌러서 설정된 비밀번호를 "personal access token"으로 변경하고 저장합니다. 그리고나서 push를 해봅니다. 안되는 분들도 있고, 되시는 분들도 있을 건데, 대부분이 안되실 것으로 생각합니다.
그러면 git:https://github.com 을 삭제하고나서, "일반 자격 증명 추가"를 눌러서 다시 생성합니다. 아래와 같이 추가해보세요.

- 인터넷 또는 네트워크주소: git:https://github.com/"자신이 설정한 username"
- 사용자 이름: "자신이 설정하고 싶은 이름"
- 비밀번호: "personal access token"

인터넷 또는 네트워크 주소에 들어가는 username은 자신의 github 로그인 시, 들어가지는 username입니다. 위와 같이 작성하고, 다시 git bash로 가서 push를 해봅니다. push를 하면 이제 에러가 없이 아래와 같은 창이 뜨게 됩니다. 그럼 아래의 버튼을 누르면 웹 브라우저로 이동하게 되요.

웹 브라우저로 이동하면 아래와 같은 화면이 뜨게 되고, 마지막으로 Authorize GitCredentialManager를 눌러주시면 최종 Setting이 되게됩니다.

이 셋팅을 하고 난 뒤에는 이미 remote push가 되어 있게됩니다. 이렇게 셋팅하면 문제없이 bash에서 사용하실 수 있을 거에요. 이번 personal access token은 git bash에서 사용 시, 사용 설정을 해줘야 remote push가 가능하고, github desktop 버전에서는 push 가능했습니다. 오랜만에 쓴 이번 포스팅은 여기서 마무리하도록 하겠습니다.