인증, 권한, 안전한 자격 증명

호출자 자격 증명 선택

에이전트에는 브라우저 OAuth를 사용하세요. 사용자가 로그인하고 접근 범위를 선택하면 CLI가 자격 증명을 저장하고 갱신합니다. 백엔드 스크립트나 CI 작업에는 VICKY_API_KEY로 개인 액세스 토큰을 전달하세요. 자격 증명을 브라우저 코드, 공개 저장소, 프롬프트, 스크린샷, 공유 로그에 넣지 마세요.

HTTP 예제는 Bearer 값의 서버 측 환경 변수로 SOSOAPI_ACCESS_TOKEN을 사용합니다. CLI 설정이 아닌 예시 변수입니다. 작업별 허용 자격 증명을 확인하세요. 개인 액세스 토큰은 API 키를 관리할 수 없습니다.

npx sosoapi auth login

npx sosoapi auth status

npx sosoapi auth logout

• 전체 API 참조

범위 및 기능

각 요청은 Workspace 멤버십과 해당 작업의 필수 역할을 확인합니다. 위임 OAuth는 사용자가 선택한 Workspace와 기능으로도 접근을 제한합니다. agent:operate는 읽기와 준비, agent:publish는 예약과 게시, agent:engage는 커뮤니티 쓰기를 담당합니다. API 키 관리에는 별도 권한이 필요합니다.

개인 액세스 토큰은 소유자의 역할과 저장된 기능 또는 Workspace 제한에 따라 제한됩니다. 통합에 필요한 접근만 선택하세요. 선택적 제한을 생략하면 키가 광범위한 접근 권한을 가질 수 있습니다. core와 full 프로필은 권한이 아닌 표시 도구 목록을 바꿉니다. 게시 접근은 매번 새 브라우저 승인 없이 부여된 범위에서 계속 유지됩니다.

자격 증명 저장 및 취소

CLI는 가능하면 운영체제 키체인에 자격 증명을 저장하고, 아니면 소유자만 읽을 수 있는 로컬 파일에 저장합니다. OAuth 액세스 토큰은 한 시간 유효하며 로그인 흐름에서 갱신합니다. 자격 증명 파일 복사 대신 auth status로 연결을 진단하세요.

Settings → Agents & API Access에서 기기나 권한을 취소하거나 auth logout으로 현재 로컬 기기에서 로그아웃하세요. 향후 접근이 중단됩니다. 이미 게시된 게시물이나 SosoAPI가 접수한 예약은 취소되지 않으므로 별도로 확인하고 관리하세요.

인증 초기 설정 엔드포인트

agent-auth 엔드포인트 네 개는 로그인 프로토콜을 문서화합니다. 지원 CLI 또는 원격 OAuth 클라이언트로 로그인하세요. 이 엔드포인트는 api post에서 사용할 수 없습니다. config, request, session, revoke-current는 각기 다른 자격 증명과 필드를 받습니다. 엔드포인트별 스키마를 따르고 세션 자격 증명을 출력과 로그에 넣지 마세요.

• 인증 엔드포인트 참조