계정 & 인증

​

계정은 어디서 관리하나요

​

계정 추가하기

• 개인 액세스 토큰
• GitHub OAuth
• SSH 키

• host 는 Cloud에서 고정되고, Enterprise/Server 계열에서는 직접 입력합니다.
• username 은 Bitbucket 계열에서만 나타나며 필수입니다.
• 토큰 에는 발급받은 토큰(GitHub ghp_…, GitLab glpat-…, Bitbucket 앱 비밀번호 등)을 붙여넣습니다. 토큰 생성 페이지 열기 링크와 필요 권한(최소) 안내가 함께 제공됩니다.
• 검증 은 성공하면 비어 있던 이름과 이메일을 채우고 username과 아바타를 저장합니다.

토큰은 OS 키체인에 저장되며 평문으로 디스크에 남지 않습니다.

새 토큰을 입력했다면 검증 이 성공해야 추가/저장 이 활성화됩니다. 기존 계정을 편집할 때 토큰 칸을 비워 두면 저장된 토큰이 그대로 유지됩니다.

브라우저 로그인(디바이스 코드)으로 계정을 연결합니다.

1

로그인 시작

GitHub으로 로그인 버튼을 누릅니다.

2

코드 확인 및 브라우저 인증

사용자 코드(예: PLNE-2026)가 표시됩니다. 코드 복사 로 복사하고 GitHub에서 인증하기 로 브라우저를 열어 입력하고 승인합니다.

3

승인 완료 후 추가

승인이 끝나면 카드가 @사용자명 계정으로 로그인됨 으로 바뀌고 이름과 이메일이 채워집니다. 추가 를 눌러 저장합니다.

OAuth 로그인은 github.com 계정에만 동작합니다. GitHub Enterprise, GitLab, Bitbucket Server는 토큰 방식만 사용합니다.

실행 중인 빌드에 GitHub 로그인이 구성되어 있지 않으면, 새 계정 추가 시 인증 유형이 토큰 입력으로 되돌아갑니다. 이미 OAuth로 저장된 계정은 기존 자격 증명을 그대로 유지해 계속 작동합니다.

SSH 계정은 특정 호스트에 묶이지 않고 키만 지정합니다.

• 키 선택 에서 ~/.ssh 의 기존 키를 고르거나 새 SSH 키 만들기 로 생성합니다.
• 공개키 복사 로 복사한 뒤 Git 호스트의 SSH 키 설정에 등록합니다. GitHub에 등록 같은 링크로 등록 페이지를 바로 열 수 있습니다.
• SSH 폴더 열기 로 ~/.ssh 를 Finder에서 엽니다.

SSH 계정이 실제로 쓰이려면 저장소의 원격 URL이 SSH 형식(git@…)이어야 합니다. HTTPS 원격이면 경고가 표시됩니다.

​

연결 상태 확인

• 토큰/OAuth 계정 은 제목 옆에 Online / Offline 과 username이 표시되고, 상태 확인 은 토큰을 재검증해 표시와 아바타를 갱신합니다.
• SSH 계정 은 상태 확인 을 누르면 테스트할 호스트를 고르는 팝오버가 열리고, 인증에 성공한 호스트가 카드에 나열됩니다.

​

저장소에 계정 적용하기

​

아바타

​

인증 오류 해결