alpacon acl entry add

서비스 토큰에 명령 패턴을 사전 승인합니다. 사전 승인하면 토큰이 일치하는 명령을 사람의 승인 없이 실행할 수 있습니다. Alpacon Cloud에서는 어떤 항목과도 일치하지 않는 명령이 승인 요청으로 넘어가지 않고 command_acl_denied로 거부됩니다.

사용법

alpacon acl entry add --token TOKEN --command PATTERN --username USER [flags]
alpacon acl entry add --file FILE

핵심 사항

  • 서비스 토큰만 사전 승인할 수 있음. 개인 API 토큰에는 원장의 명령 목록이 없음
  • 인수 자리에는 * 와일드카드 사용. *가 없는 패턴은 그 명령줄과 정확히 일치해야 함
  • --username은 명령을 실행할 계정. 모든 계정은 "*"
  • --server를 생략하면 워크스페이스의 모든 서버에 적용되며 경고가 표시됨. 빈 --server 값은 모든 서버로 해석하지 않고 거부함
  • --expires-at은 미래 시각의 RFC 3339 형식이어야 함
  • 원장에 이미 있는 항목을 추가하면 거부됨

플래그

플래그유형설명기본값
-c, --commandstring사전 승인할 명령 패턴. * 와일드카드 지원—
--disabledbool비활성 상태로 발급false
--expires-atstringRFC 3339 형식의 만료 시각만료 없음
--filestring이 JSON 파일의 항목을 모두 발급—
--groupnamestring명령을 실행할 그룹제한 없음
-h, --helpbool명령 도움말 표시false
--serverstrings항목을 적용할 서버의 이름 또는 ID. 반복하거나 쉼표로 구분모든 서버
--tokenstring명령을 사전 승인할 서비스 토큰(이름 또는 ID)—
--usernamestring명령을 실행할 계정. 모든 계정은 "*"—
--outputstring출력 형식: table 또는 jsontable

예제

서버 하나에 명령 하나 사전 승인

bash
alpacon acl entry add --token deploy-bot --command "systemctl restart nginx" \
  --username root --server web-01

서버 두 대에 패턴을 지정한 시각까지 사전 승인

bash
alpacon acl entry add --token deploy-bot --command "docker compose *" \
  --username deploy --server web-01,web-02 --expires-at 2027-01-15T10:00:00Z

파일로 여러 항목 추가

bash
alpacon acl entry add --file entries.json

파일로 항목 추가

--file은 항목의 JSON 배열을 받으며, 항목 하나를 지정하는 플래그와 함께 쓸 수 없습니다. 전부 발급되거나 하나도 발급되지 않습니다. 항목 하나라도 거부되면 파일 전체가 거부되고 아무것도 발급되지 않습니다.

json
[
  {
    "principal_id": "550e8400-e29b-41d4-a716-446655440000",
    "command_pattern": "systemctl restart nginx",
    "username": "root",
    "server_ids": ["6ba7b810-9dad-11d1-80b4-00c04fd430c8"]
  },
  {
    "principal_id": "550e8400-e29b-41d4-a716-446655440000",
    "command_pattern": "docker compose *",
    "username": "deploy",
    "server_ids": [],
    "expires_at": "2027-01-15T10:00:00Z",
    "enabled": false
  }
]
필드필수설명
principal_id예서비스 토큰의 ID. 개인 API 토큰의 ID는 거부됨
command_pattern예사전 승인할 명령 패턴
username예명령을 실행할 계정. 모든 계정은 *
server_ids예항목을 적용할 서버 ID. 모든 서버에 적용하려면 []
groupname아니요명령을 실행할 그룹
expires_at아니요미래 시각의 RFC 3339 형식
enabled아니요false이면 비활성 상태로 발급. 기본값은 true
principal_type아니요service_token만 가능

모르는 필드가 있으면 거부합니다. 그래서 필드 이름을 잘못 써서 의도보다 넓은 항목이 조용히 발급되는 일이 없습니다.

최종 수정: