관리자 키

관리자 키로 xenocast에서 멤버, 초대, 워크스페이스, API 키, 사용량과 비용, 지출 한도를 관리합니다

관리자 키는 조직 관리 전용 키입니다, xenocast의 xenocast admin 명령과 AI 앱의 관리 도구가 이 키로 로그인합니다

잡을 실행하거나 로그를 읽는 데는 쓸 수 없습니다, 그때는 API 키를 씁니다
API 키로는 조직을 관리할 수 없습니다, 두 키는 서로 대신할 수 없습니다
결제, 충전, 환불은 관리자 키로 할 수 없습니다, 돈이 움직이는 일은 콘솔에서 사람이 합니다

누가 만들 수 있나요

팀 조직의 소유자와 관리자만 콘솔 설정 → 관리자 키에서 만듭니다
개인 조직에서는 쓸 수 없습니다, 메뉴도 보이지 않습니다
키는 조직이 소유합니다, 키를 만든 사람이 조직에서 나가도 키는 계속 동작합니다

키 형식과 보관

xci_admin_<43자>_<6자>

만료일은 반드시 정합니다, 내일부터 최대 1년까지 고릅니다
서버는 키의 SHA-256 해시만 저장합니다, 키 값은 만든 직후 한 번만 보입니다
목록에는 앞 12자와 뒤 4자만 보입니다
키 하나로 1분에 60번까지 요청합니다, 넘으면 잠시 뒤 다시 시도하라는 답을 받습니다

할 수 있는 일

관리자 키는 조직의 관리자 역할로 동작합니다, 소유자 역할을 주거나 소유자를 내보내는 일은 콘솔에서 소유자가 합니다

영역	터미널	AI 앱 도구
조직 정보	`xenocast admin organization`	`admin_organization`
멤버 목록, 역할 변경, 내보내기	`xenocast admin members`	`admin_members`
초대 목록, 보내기, 취소	`xenocast admin invites`	`admin_invites`
워크스페이스 만들기, 이름 변경, 보관, 멤버 추가와 제거	`xenocast admin workspaces`	`admin_workspaces`
API 키 목록, 이름 변경, 비활성화와 활성화	`xenocast admin keys`	`admin_api_keys`
사용량	`xenocast admin usage`	`admin_usage`
비용	`xenocast admin cost`	`admin_cost`
지출 한도 조회와 변경	`xenocast admin spend-limit`	`admin_spend_limit`

API 키를 새로 만드는 일은 콘솔에서만 합니다

터미널 예시

xenocast admin members
xenocast admin members role usr_123 developer
xenocast admin invites create dev@example.com --role developer
xenocast admin workspaces create android
xenocast admin workspaces add-member wrk_123 usr_123
xenocast admin keys --status active --workspace wrk_123
xenocast admin keys disable key_123
xenocast admin usage --from 2026-10-01 --to 2026-10-13 --by workspace
xenocast admin cost --range mtd --by api_key
xenocast admin spend-limit set 500

모든 명령에 --json을 붙이면 결과를 JSON 한 줄로 받습니다

AI 앱 예시

관리자 키로 로그인한 컴퓨터의 AI 에이전트는 새 세션에서 admin_ 으로 시작하는 도구를 봅니다, 관리자 키가 없으면 이 도구들은 목록에 나오지 않습니다

{ "name": "admin_invites", "arguments": { "action": "create", "email": "dev@example.com", "role": "developer" } }

{ "name": "admin_spend_limit", "arguments": { "limit_usd": "500.00" } }

감사 로그

관리자 키를 만들고, 쓰고, 이름을 바꾸고, 끄고, 지운 기록은 모두 감사 로그에 남습니다, 콘솔 설정 → 관리자 키의 최근 활동에서 시간, 작업, 키, 요청 경로, IP를 볼 수 있습니다

키가 새었다면

콘솔 설정 → 관리자 키에서 그 키를 바로 비활성화하거나 삭제하고 새 키를 만드세요, 조직을 삭제하면 그 조직의 관리자 키도 모두 멈춥니다