alpacon acl

명령 사전 승인 원장을 관리합니다. 원장에는 서비스 토큰이 사람의 승인 없이 실행할 수 있는 사전 승인된 명령과, 이를 변경할 수 있는 Command ACL 관리자가 들어 있습니다. 웹 콘솔에서는 서비스 토큰 페이지의 사전 승인된 명령에서 같은 항목을 볼 수 있습니다.

Alpacon Cloud에서 서비스 토큰의 명령이 어떤 항목과도 일치하지 않으면 command_acl_denied로 거부됩니다. 사람의 승인 요청으로 넘어가지 않습니다.

사용법

alpacon acl [flags]
alpacon acl [command]

핵심 사항

  • 워크스페이스의 Command ACL 관리자만 원장을 조회하거나 변경할 수 있음. 이 역할은 워크스페이스 역할과 별개
  • alpacon login으로 브라우저에서 로그인해야 함. API 토큰(-t)으로 로그인한 상태는 거부됨
  • 개인 API 토큰에는 원장의 명령 목록이 없음. 사전 승인된 명령은 서비스 토큰에만 줄 수 있음
  • 원장이 없는 자체 호스팅 배포처럼 아직 명령 ACL 규칙으로 관리하는 워크스페이스에서는 모든 alpacon acl 명령이 그 사실을 알리고 1로 종료됨. 이때는 alpacon token acl command 사용

플래그

플래그유형설명기본값
-h, --helpbool명령 도움말 표시false
--outputstring출력 형식: table 또는 jsontable

예제

워크스페이스의 사전 승인된 명령 조회

bash
alpacon acl entry ls

원장 인증

원장은 alpacon login과 별도로 인증해야 합니다. 첫 alpacon acl 명령은 alpacon login처럼 링크와 코드를 출력하고 브라우저를 엽니다. 코드를 확인하고 로그인하면 명령이 이어서 실행됩니다.

이 인증은 인증한 워크스페이스에 대해 저장되며, 백그라운드에서 갱신되지 않습니다. 만료되면 다음 alpacon acl 명령에서 다시 인증을 요청합니다. alpacon logout이나 새 alpacon login을 실행하면 저장된 인증이 지워집니다. 브라우저에서 거절했거나 코드가 만료됐다면 명령을 다시 실행하세요.

Alpacon Cloud 워크스페이스는 따로 설정할 것이 없습니다. 자체 원장을 운영하는 자체 호스팅 배포에서는 ALPACON_AI_URL을 설정하고, 로그인에 다른 audience를 쓴다면 ALPACON_AI_AUDIENCE도 설정하세요. 루프백 호스트가 아니면 URL은 https여야 합니다. MCP 서버는 별도의 환경 변수를 읽습니다. 원장 로그인을 참고하세요.

관련 명령

최종 수정: