co auth — 인증 | CollabOps Docs

co auth 는 CollabOps 인증을 관리합니다. 호스트, 토큰/세션 쿠키, 기본 워크스페이스 슬러그를 한 번에 저장합니다.

로그인 방법은 세 가지입니다. 브라우저 로그인(--web), 이메일 + 비밀번호, 토큰(--token). 구글·애플 같은 소셜 계정으로 가입해 비밀번호가 없다면 브라우저 로그인을 쓰세요.

co auth login --web
co auth login
co auth login --host https://collabops.ai --identifier you@collabops.ai
co auth login --token <PAT>

옵션	설명
--host <url>	API 호스트. 예: https://collabops.ai
--identifier <email>	이메일/사용자명 — 입력하면 프롬프트 건너뜀
--web	브라우저로 로그인 (구글·애플 등 웹에서 쓰는 모든 로그인 방법)
--token <token>	비밀번호 대신 PAT 사용
--workspace <slug>	기본 워크스페이스 슬러그 (예: my-team)

성공하면 ~/.config/collabops/config.json 에 호스트·세션 쿠키·워크스페이스가 저장됩니다.

옵션 없이 co auth login 을 실행하면 로그인 방법을 고르는 화면(How would you like to log in?)이 먼저 나옵니다. Browser 를 고르면 --web 과 같고, Email + password 를 고르면 이메일과 비밀번호를 묻습니다. --identifier 를 주면 이 화면 없이 바로 비밀번호를 묻습니다.

브라우저로 로그인 (--web)

구글 등 소셜 계정으로 가입한 사용자를 위한 방법입니다. 터미널에 비밀번호를 입력하지 않고, 웹에서 평소처럼 로그인한 뒤 그 로그인을 CLI 로 넘겨받습니다.

co auth login --web 을 실행하면 터미널에 확인 코드(XXXX-XXXX 형식)가 표시되고 브라우저가 열립니다.
브라우저에서 CollabOps 에 로그인합니다. 이미 로그인돼 있다면 이 단계는 건너뜁니다.
「CLI 로그인」 화면에 어느 계정으로 로그인되는지 표시됩니다. 확인 코드 칸에 터미널의 코드를 입력하고 승인을 누릅니다.
브라우저 탭에 완료 메시지가 뜨면 탭을 닫고 터미널로 돌아갑니다. 처음 로그인이라면 이어서 기본 워크스페이스를 고릅니다.

co auth login --web
# ! Confirmation code: ABCD-EFGH (enter it on the browser page)
# - Complete login in your browser: https://collabops.ai/cli/authorize?...

브라우저 로그인은 co 를 실행한 컴퓨터의 브라우저에서 마쳐야 합니다. 로그인 결과를 그 컴퓨터의 로컬 주소(127.0.0.1)로 받기 때문에, SSH 로 접속한 원격 서버처럼 브라우저가 다른 컴퓨터에 있으면 완료되지 않습니다. 이럴 때는 --token 을 쓰세요. 5분 안에 승인하지 않으면 시간이 초과되니 다시 실행하면 됩니다.

브라우저가 자동으로 열리지 않으면 터미널에 표시된 주소를 직접 열면 됩니다. --web 옵션이 없다는 오류가 나면 co update 로 CLI 를 최신 버전으로 올리세요.

SSH 키·Git 자동 설정

로그인이 끝나면 co 가 이 컴퓨터에서 CollabOps 저장소를 clone·push 하고 커밋에 서명할 준비가 됐는지 확인합니다. 바꿀 것이 있으면 변경될 항목을 먼저 보여주고 위 내용으로 진행할까요? (y/N) 를 묻습니다. y 를 입력해야 진행하고, Enter 만 누르면 아무것도 바꾸지 않고 건너뜁니다. 이미 준비돼 있으면 아무것도 묻지 않습니다.

항목	하는 일
SSH 키	이 계정에 등록된 키가 ~/.ssh 에 있으면 그 키를 씁니다. 없으면 ~/.ssh/collabops_<호스트>_<사용자명> 키를 새로 만듭니다. passphrase 는 ssh-keygen 이 묻고, 비워 두려면 Enter 를 두 번 누릅니다.
서버 등록	공개키를 접속용 키와 커밋 서명용 키로 등록합니다. 개인키는 이 컴퓨터에만 남습니다.
Git 설정	~/.config/collabops/gitconfig-<호스트> 에 user.name, user.email, core.sshCommand, 커밋 서명 설정을 쓰고, ~/.gitconfig 에는 이 파일을 불러오는 include 한 줄만 더합니다. CollabOps 저장소에만 적용되고 다른 저장소 설정은 바뀌지 않습니다.

co auth login
# ✔ Logged in as <your-name>
# › CollabOps Git 설정 (clone/push/커밋 서명). 다음 항목이 변경됩니다:
#    • 새 SSH 키 생성: ~/.ssh/collabops_… (passphrase 는 다음 단계에서 ssh-keygen 이 묻습니다)
#    • 서버 등록: 접속용 키 (공개키만 전송, 개인키는 이 컴퓨터에만 남음)
#    • 서버 등록: 커밋 서명용 키
#    • 앞으로 CollabOps 레포 커밋에 이 키로 서명이 붙습니다
# ? 위 내용으로 진행할까요? (y/N) y
# ✔ 접속용 키 등록
# ✔ 서명용 키 등록

이미 user.signingkey 를 설정해 두었다면 커밋 서명 설정은 그대로 둡니다. 전역 user.name 이 있으면 그 이름을 그대로 씁니다. git 2.36 미만이면 Git 설정은 건너뜁니다. 터미널이 아닌 스크립트·CI 에서는 실행되지 않습니다.

co repo clone 도 접속용 키가 없으면 같은 설정을 제안합니다. 그래서 아래 한 줄로 로그인부터 키 준비, clone 까지 끝낼 수 있습니다. 건너뛴 설정은 co auth login 을 다시 실행하면 다시 제안합니다.

co auth login && co repo clone <workspace>/<repo>

co auth status

현재 호스트, 워크스페이스, 인증 종류 (cookie/token/none) 를 출력하고 사용자 이름을 검증합니다.

co auth status
# Host: https://collabops.ai
# Workspace: my-team
# Auth: ✓ cookie
# ✓ Authenticated as <your-name>

co auth logout

저장된 자격 증명만 비웁니다 — 호스트와 기본 워크스페이스는 유지됩니다.

co auth logout

co 가 키와 Git 설정을 만들었다면 로그아웃할 때 지울지 묻습니다 (기본 N). 서버에 등록한 키, co 가 만든 키 파일, Git 설정만 지우고 직접 만든 키는 건드리지 않습니다. 공용 컴퓨터라면 모두 삭제하세요.

config 파일 경로가 궁금하면 co config path 로 확인할 수 있습니다.

co auth — 인증

co auth login

브라우저로 로그인 (--web)

SSH 키·Git 자동 설정

co auth status

co auth logout

목차