인증 및 API 키

Subaya는 동일한 API에 대해 두 가지 인증 모드를 지원합니다.

API 키 — SUBAYA_API_KEY (에이전트 및 CI)

가장 간단한 경로이며, AI 에이전트와 CI 파이프라인에 사용할 방식입니다. 환경 변수를 설정하면 모든 suya 명령(과 플랫폼 API)이 그것을 가져옵니다:

export SUBAYA_API_KEY="sk_..."
suya auth whoami      # confirm the identity the key resolves to

브라우저도, 대화형 단계도 없습니다 — 헤드리스 환경에 이상적입니다. 콘솔에서 키를 발급하고 관리하십시오.

OAuth 브라우저 로그인 (사람)

워크스테이션에서의 대화형 사용을 위해:

suya auth login                 # opens a browser (loopback redirect)
suya auth login --no-browser    # manual-code fallback for remote/headless shells

CLI는 생성된 토큰을 로컬에(~/.config/suya/ 아래) 저장합니다. 그것을 확인하거나 지우십시오:

suya auth status    # local status, without calling the server
suya auth logout    # log out and revoke the local token

우선순위

둘 이상의 자격 증명이 존재할 때 suya는 다음 순서로 결정합니다:

1. --token 전역 플래그
2. SUBAYA_API_KEY
3. 로컬에 저장된 OAuth 토큰(~/.config/suya/auth.json)

다른 호스트를 가리키기

기본이 아닌 API 엔드포인트를 대상으로 삼아야 한다면 모든 명령은 --host(기본값 https://subaya-dev.com)를 허용합니다.

다음 단계

• 빠른 시작 — 첫 번째 시뮬레이션을 실행합니다.
• CLI: auth — 전체 suya auth 레퍼런스.