인증
CLI는 브라우저, 디바이스 코드 또는 API 키로 로그인하며, 스크립트와 CI에서는 플래그나 환경 변수에서 자격 증명을 읽습니다. polylane auth login을 실행해 대화형으로 방법을 고르거나, 플래그를 전달해 선택 화면을 건너뛰세요.
로그인 방법
| 방법 | 명령 | 설명 |
|---|---|---|
| 브라우저 | polylane auth login | 대화형 사용을 위한 방법. CLI가 브라우저를 열고, localhost 콜백으로 토큰을 받고, 만료되면 갱신합니다. |
| 디바이스 코드 | polylane auth login --no-browser | SSH와 헤드리스 머신을 위한 방법. CLI가 URL과 코드를 출력합니다. 아무 기기에서나 URL을 열고 코드를 입력하면, CLI가 승인될 때까지 폴링합니다. |
| API 키 | polylane auth login --api-key sk_xxxxx | 스크립트, CI, 에이전트를 위한 방법. CLI가 키를 검증하고 기본 워크스페이스와 함께 저장합니다. |
로그인 후 CLI는 사용자가 누구인지 보여 주고, 둘 이상의 워크스페이스에 속해 있으면 기본값을 고르게 하여 ~/.polylane/config.json에 workspace_id로 저장합니다. polylane auth refresh로 토큰 갱신을 강제할 수 있습니다.
API 키
Settings > API Keys에서 Create an API key로 키를 만드세요: 이름을 정하고, 스코프를 고르고, 복사하세요. 한 번만 표시됩니다. 키는 sk_로 시작합니다. CI에서는 로그인 단계를 실행하는 대신 환경에 POLYLANE_API_KEY를 설정하거나, 단일 호출에 전역 --api-key <key> 플래그를 전달하세요.
자격 증명 우선순위
여러 자격 증명이 있으면 CLI는 다음 순서로 결정합니다:
- 현재 명령의
--api-key플래그 POLYLANE_API_KEY환경 변수~/.polylane/credentials.json의 OAuth 자격 증명~/.polylane/config.json의api_key
내보낸 POLYLANE_API_KEY는 오래된 ~/.polylane/credentials.json보다 항상 우선하므로, 변수가 설정된 CI 러너는 남아 있는 OAuth 토큰을 집어 들지 않습니다. polylane auth status가 어떤 출처가 사용 중인지 보여 줍니다.
확인과 전환
polylane auth status
polylane auth whoami
polylane auth logout
auth status는 사용 중인 방법, 마스킹된 토큰, 사용자, 워크스페이스를 보여 주고, auth whoami는 현재 사용자를 보여 줍니다. auth logout은 확인 후 OAuth 토큰을 폐기하고 저장된 자격 증명을 지우며, --yes로 확인을 건너뛸 수 있습니다. 계정을 전환하려면 로그아웃한 뒤 다른 자격 증명으로 로그인하세요.
환경 변수
| 변수 | 설명 |
|---|---|
POLYLANE_API_KEY | 비대화형 인증을 위한 API 키 |
POLYLANE_WORKSPACE_ID | 기본 워크스페이스(ws_ id) |
POLYLANE_API_DOMAIN | API 호스트 이름 재정의 |
~/.polylane/에 쓰고 싶지 않은 CI 작업과 컨테이너에서 이를 사용하세요. 전체 목록은 구성에 있습니다.
관련 문서
- 구성: 전체 우선순위, 모든 환경 변수, 디스크의 파일.
- 스크립팅: JSON 출력, 종료 코드, CI와 에이전트를 위한 플래그.
- API 키와 OAuth: 스코프, 키 관리, OAuth 클라이언트.