84. (Bitbucket/Git) [SSH Key 설정 방법] : [3] : App passwords are deprecated .. URL returned error: 410

---

[환경 설정]

​

저장소 : Git / 깃 / Bitbucket

​

사용 목적 : 소스 코드 버전 관리 실시

​

제 목 : [SSH Key 설정 방법] : [3] : App passwords are deprecated .. URL returned error: 410

​

 

---

[설 명]

​

-----------------------------------------------------------------------------------------
[구 분]
-----------------------------------------------------------------------------------------

구 분 : Git / 원격 저장소


제 목 : [SSH Key 설정 방법] : [3] : App passwords are deprecated .. URL returned error: 410


사전) Git 간단 설명 정리 : 

  >> Git 은 소스 코드 버전 관리를 위한 분산 버전관리 시스템 (Distributed Version Control System, DVCS) 입니다.

    - 코드의 변경 이력을 모두 기록하고, 여러 개발자가 안전하게 협업할 수 있게 도와주는 도구입니다.

  >> Git 을 통해 코드의 과거부터 현재까지 모든 변경 이력을 기록하고, 여러 사람이 동시에 작업해도 충돌 없이 협업할 수 있습니다.

  >> Git 주요 용어 정리 : 

    - 저장소 (Repository) : 프로젝트의 파일과 변경 이력을 저장하는 장소 (로컬 저장소: 내 컴퓨터 / 원격 저장소: GitHub, GitLab 등의 서버)
    - 커밋 (Commit) : 저장 버튼 + 스냅샷 (특정 시점의 전체 파일 상태를 기록한 것)
    - 브랜치(Branch) : 독립된 작업 공간 (각 기능(feature)마다 따로 작업할 수 있음 / 개발을 마치면 메인 브랜치에 merge (병합) 하여 통합)
    - remote : 원격 저장소
    - Merge : 두 브랜치를 합치는 가장 흔한 방식
    - Rebase : 히스토리를 깔끔하게 재정렬하며 합치는 방식

  >> Git 주요 명령어 정리 : 

    - git clone : 원격 저장소를 내 로컬에 그대로 복제
    - git pull : 원격 저장소 변경 사항을 가져와 내 브랜치에 자동 병합
    - git fetch : 변경 사항만 로컬에 가져오고 병합은 직접 해야 함
    - git push : 내 변경 사항을 원격 저장소로 올림

-----------------------------------------------------------------------------------------






-----------------------------------------------------------------------------------------
[에러 원인]
-----------------------------------------------------------------------------------------

1. git push 수행 시 Bitbucket 에서 App Password 인증 방식이 더 이상 지원되지 않기 때문에 발생하는 이슈

  >> Git HTTPS -> Username -> App Password 방식으로 인증하는 것이 종료되었습니다.


2. ❌ 에러 발생 로그 예시 : 

  git push origin main remote: CHANGE-3222 - Functionality has been deprecated remote: App passwords are deprecated and must be replaced with API tokens. 

  remote: https://developer.atlassian.com/cloud/bitbucket/changelog#CHANGE-3222 

  fatal: unable to access 'https://bitbucket.org/twok-2k/ios-swiftproject.git/': The requested URL returned error: 410

-----------------------------------------------------------------------------------------






-----------------------------------------------------------------------------------------
[해결 방법]
-----------------------------------------------------------------------------------------

✅ ssh 명령어는 현재 로그인한 사용자 계정의 SSH 설정 디렉터리이므로, 어느 위치에서 실행해도 같은 결과가 나옵니다.

   예를 들어 현재 위치가 어디든 상관없습니다.

-----------------------------------------------------------------------------------------

1. SSH Key 연동 방식을 사용 해서 git remote url 설정 및 git push 수행하도록 변경 수행


2. 🟦 Mac OS 기준 SSH Key 생성 : ED25519 방식을 권장합니다.

  >> 문법 : ssh-keygen -t ed25519 -C "본인 이메일"

  >> 예시 : ssh-keygen -t ed25519 -C "example@gmail.com"

  >> 결과 : Generating public/private ed25519 key pair. 
           Enter file in which to save the key 가 출력됩니다.

  >> ✅ 그냥 Enter를 누르세요 : /Users/mac/.ssh/id_ed25519 에 저장됩니다.

  >> ✅ 다음에는 Enter passphrase 가 나오는데 원하면 입력하고 아니면 그냥 Enter 두 번 눌러도 됩니다.


3. 🟦 SSH Agent 실행

  >> 명령어 : eval "$(ssh-agent -s)"

  >> 결과 : Agent pid 12345 처럼 표시됩니다.


4. 🟦 SSH Key 등록

  >> 명령어 : ssh-add --apple-use-keychain ~/.ssh/id_ed25519

    - 만약 오류가 발생하면 ssh-add ~/.ssh/id_ed25519 를 실행하세요.


5. 🟦 공개키 확인 

  >> 명령어 : cat ~/.ssh/id_ed25519.pub

  >> 결과 : ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI....test@gmail.com


6. 🟦 Bitbucket에 등록

  >> Personal settings -> SSH Keys -> Add key 를 클릭합니다.

  >> ssh-ed25519 AAAAC3Nz...... 를 붙여넣고 저장합니다.


7. 🟦 SSH 연결 테스트

  >> 명령어 : ssh -T git@bitbucket.org

  >> 결과 : The authenticity of host 'bitbucket.org' can't be established.
           Are you sure you want to continue connecting (yes/no)? 가 나옵니다.

           ✅ yes 를 입력하면 -> authenticated via ssh key. 가 출력 됩니다.


8. 🟦 현재 특정 프로젝트 remote SSH 주소로 변경

  >> 문법 : git remote set-url origin git@bitbucket.org:<project ssh url>

  >> 명령어 : git remote set-url origin git@bitbucket.org:twok-2k/ios-swiftproject.git

-----------------------------------------------------------------------------------------






-----------------------------------------------------------------------------------------
[참고 사이트]
-----------------------------------------------------------------------------------------

▶️ 83. (Bitbucket/Git) [SSH Key 설정 방법] : [2] : 비트버킷 ssh key 생성 방법 및 ssh 연결 테스트 확인 방법

https://kkh0977.tistory.com/8989

https://blog.naver.com/kkh0977/224350974963


▶️ 82. (Bitbucket/Git) [SSH Key 설정 방법] : [1] : mac os 에서 ssh key 생성 및 프로젝트에 remote origin 설정 방법

https://kkh0977.tistory.com/8988

https://blog.naver.com/kkh0977/224350968799


▶️ 79. (GitLab/Git) [깃랩] Personal Access Token (PAT) Git 액세스 토큰 생성 방법 정리

https://kkh0977.tistory.com/8654

https://blog.naver.com/kkh0977/224198943947


▶️ 80. (Git/깃) [에러 관리] fatal access ... SSL certificate problem: unable to get local issuer certificate

https://kkh0977.tistory.com/8661

https://blog.naver.com/kkh0977/224200032728


▶️ 81. (Git/깃) [에러 관리] fatal 'main' does not appear to be a git repository .. Could not read repository

https://kkh0977.tistory.com/8662

https://blog.naver.com/kkh0977/224200042584


▶️ 77. (Bitbucket/Git) [에러 관리] Git Push 업로드 수행 시 Complete 완료 무한 대기 현상 해결 - git push 업로드 시 용량 제한 설정

https://kkh0977.tistory.com/8083

https://blog.naver.com/kkh0977/223910368561


▶️ 76. (Bitbucket/Git) App passwords are recommended .. fatal: Authentication failed for 'https ..'

https://kkh0977.tistory.com/8082

https://blog.naver.com/kkh0977/223910363021

-----------------------------------------------------------------------------------------

 

---

[참고 사이트]

​

https://kkh0977.tistory.com/8989

83. (Bitbucket/Git) [SSH Key 설정 방법] : [2] : 비트버킷 ssh key 생성 방법 및 ssh 연결 테스트 확인 방법

---