Ex1-my-blog/docs/git-auth-guide-mac.md

Git 인증 설정 가이드 (Mac)

이 가이드는 git.nnotion.kr Gitea 서버에서 Personal Access Token(PAT)을 발급받고, Mac에서 설정하는 방법을 안내합니다.

---

목차

1. Personal Access Token 발급
2. 인증 설정
3. 설정 확인
4. 문제 해결

---

1. Personal Access Token 발급

1.1 토큰 생성 페이지 접속

브라우저에서 아래 주소로 이동:

https://git.nnotion.kr/user/settings/applications

또는 웹에서 수동으로 이동:

우측 상단 프로필 아이콘 → Settings → Applications

1.2 토큰 생성

1. Token Name 입력: my-blog-token (원하는 이름)
2. Select permissions 설정:
   • ✅ repository → Read and Write 체크
3. Generate Token 버튼 클릭

1.3 토큰 복사 (중요!)

⚠️ 주의: 토큰은 생성 직후 한 번만 표시됩니다!

• 생성된 토큰을 즉시 복사하여 안전한 곳에 저장
• 예시: d262946c36480d23f57736dfe76b845706f513b0

---

2. 인증 설정

방법 A: 터미널 사용 (권장)

2.1 터미널 열기

• Cmd + Space → 터미널 검색 → 실행

2.2 호스트별 인증 설정

# git.nnotion.kr 전용 credential 설정
git config --global credential.https://git.nnotion.kr.helper store

# 인증정보 저장
echo "https://사용자명:토큰@git.nnotion.kr" >> ~/.git-credentials

예시 (사용자명: jobdori, 토큰: abc123...):

echo "https://jobdori:abc123token@git.nnotion.kr" >> ~/.git-credentials

방법 B: macOS Keychain 사용

2.1 Keychain 설정

# Keychain helper 설정
git config --global credential.helper osxkeychain

2.2 첫 Push 시 인증

git push -u origin main

프롬프트가 나타나면:

Username: 사용자명
Password: 토큰 (비밀번호 아님!)

Keychain에 자동 저장되어 이후 입력 불필요

방법 C: 프로젝트 폴더에서 직접 설정

# 프로젝트 폴더로 이동
cd ~/Desktop/my-blog

# 원격 URL에 인증정보 포함
git remote set-url origin https://사용자명:토큰@git.nnotion.kr/Clauders/Ex1-my-blog.git

---

3. 설정 확인

3.1 원격 저장소 확인

git remote -v

정상 출력:

origin  https://git.nnotion.kr/Clauders/Ex1-my-blog.git (fetch)
origin  https://git.nnotion.kr/Clauders/Ex1-my-blog.git (push)

3.2 Push 테스트

git push

성공 메시지:

Everything up-to-date

또는

To https://git.nnotion.kr/Clauders/Ex1-my-blog.git
   abc1234..def5678  main -> main

3.3 Credential 설정 확인

# 저장된 credential 확인
cat ~/.git-credentials

3.4 Keychain 확인

1. Cmd + Space → 키체인 접근 검색 → 실행
2. git.nnotion.kr 검색
3. 저장된 인증정보 확인/수정 가능

---

4. 문제 해결

문제: Authentication failed

원인: 토큰이 잘못되었거나 만료됨

해결:

# 기존 credential 삭제
git config --global --unset credential.helper

# Keychain Access에서 git.nnotion.kr 항목 삭제
# 1. Cmd + Space → 키체인 접근
# 2. git.nnotion.kr 검색
# 3. 해당 항목 삭제

# 다시 설정
git config --global credential.https://git.nnotion.kr.helper store

문제: 다른 Git 서버와 충돌

원인: 전역 credential이 모든 서버에 적용됨

해결: 호스트별 credential 분리

# git.nnotion.kr 전용
git config --global credential.https://git.nnotion.kr.helper store

# github.com 전용 (필요시)
git config --global credential.https://github.com.helper osxkeychain

문제: remote: Repository not found

원인: 저장소 접근 권한 없음

해결:

1. 토큰 권한 확인 (repository: Read and Write)
2. 저장소 URL 확인
3. 조직 멤버 권한 확인

문제: 토큰을 잊어버림

해결: 새 토큰 발급

1. https://git.nnotion.kr/user/settings/applications 접속
2. 기존 토큰 삭제 (Revoke)
3. 새 토큰 생성
4. ~/.git-credentials 파일 수정 또는 재설정

---

부록: 유용한 명령어

# Git 설정 전체 확인
git config --list

# 특정 설정 확인
git config --global credential.helper

# credential 파일 위치
# ~/.git-credentials

# 원격 URL 변경
git remote set-url origin [새URL]

# 현재 브랜치 확인
git branch

# 푸시
git push -u origin main

# Keychain에서 특정 호스트 인증정보 찾기
security find-internet-password -s git.nnotion.kr

---

요약

단계	명령어/작업
1. 토큰 발급	Gitea 웹에서 생성
2. 터미널 열기	Cmd + Space → 터미널
3. Credential 설정	git config --global credential.https://git.nnotion.kr.helper store
4. 인증정보 저장	echo "https://user:token@git.nnotion.kr" >> ~/.git-credentials
5. Push 테스트	git push

---

문제가 있으면 이슈를 등록해주세요: https://git.nnotion.kr/Clauders/Ex1-my-blog/issues