Skip to main content
auth 서브커맨드가 로컬 자격증명과 후속 명령이 액션할 워크스페이스 관리. 로그인이 OAuth 기반; CLI 가 OS 설정 디렉토리 아래 사용자별 토큰 저장.

​
명령

​
auth login

OAuth 위해 브라우저 창 열림. 성공 시:
  • 워크스페이스 목록 fetch.
  • 아직 없으면 첫 것을 활성으로 고정.
  • OS 설정 위치에 자격증명 씀:
    • macOS: ~/Library/Application Support/nora/credentials.json
    • Linux: ~/.config/nora/credentials.json
    • Windows: %APPDATA%\nora\credentials.json
자격증명 파일이 chmod 0600 (여러분 읽기 전용). 절대 커밋이나 공유 안 함. 터미널에 브라우저 없으면 (SSH, 컨테이너), CLI 가 로컬 브라우저에 붙여넣을 URL 인쇄. 반환된 코드를 터미널에 복사.

​
auth logout

로컬 자격증명 파일 삭제. 서버 쪽 토큰 취소 안 함. 취소하려면 앱 사용: Settings → Personal Access Tokens → Revoke. 공유 머신에서 로그인 후 유용.

​
auth status

인쇄:
  • 활성 워크스페이스 이름과 ID.
  • 저장된 모든 워크스페이스 (이름 + ID + 역할).
  • 토큰 (편집됨, prefix 만 표시).
  • 가리키는 서버 URL.
뭔가 이상하다 느낄 때 좋은 첫 명령 — 어느 워크스페이스가 활성이고 어느 서버와 CLI 가 대화하는지 확인.

​
auth workspaces list

서버에서 워크스페이스 목록 새로고침 (오프라인이면 캐시로 폴백). 각 항목이 역할 (owner / manager / member) 표시해 파괴 명령 실행 전 권한 앎.

​
auth workspaces switch <id>

활성 워크스페이스 설정. 다시 전환할 때까지 후속 명령이 그것에 액션. 전환 없이 명령별 오버라이드도 가능:

​
auth workspaces current

활성 워크스페이스 ID 만 인쇄. 셸 스크립트에 유용:

​
한 머신에 여러 계정

CLI 가 하나의 활성 자격증명 세트 저장. 다른 계정 사용:
또는 NORA_CONFIG_DIR 가리켜 여러 자격증명 파일 유지:
빠른 전환용 각각 alias:

​
개인 vs. 워크스페이스 토큰

두 토큰 타입 모두 동작: CI 에 워크스페이스 토큰이 올바른 선택: 잘못된 워크스페이스에 실수로 액션 못하고, 하나 취소가 사용자를 앱에서 로그아웃 안 함. CI 는 NORA_TOKEN 을 시크릿으로 설정:
auth login 불필요 — CLI 가 NORA_TOKEN 자동 픽업.

​
토큰 수명

  • 개인 접근 토큰: 취소까지 유효. 사용 시 자동 새로고침.
  • 워크스페이스 토큰: 취소하거나 워크스페이스 삭제할 때까지 유효.
CLI 의 status 출력이 토큰 발급 시간 표시해 오래된 토큰 로테이션 가능.

​
트러블슈팅

“Not authenticated” — auth login 실행, 또는 NORA_TOKEN 설정. “Wrong workspace” — auth status 로 활성 워크스페이스 확인, 그 다음 auth workspaces switch 로 수정. “유효 토큰에도 서버가 401” — UI 에서 토큰 취소됨. auth login 재실행. 기업 프록시가 OAuth 블록 — auth login 전 HTTPS_PROXY=http://your-proxy:port 설정.