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, --command | string | 사전 승인할 명령 패턴. * 와일드카드 지원 | — |
--disabled | bool | 비활성 상태로 발급 | false |
--expires-at | string | RFC 3339 형식의 만료 시각 | 만료 없음 |
--file | string | 이 JSON 파일의 항목을 모두 발급 | — |
--groupname | string | 명령을 실행할 그룹 | 제한 없음 |
-h, --help | bool | 명령 도움말 표시 | false |
--server | strings | 항목을 적용할 서버의 이름 또는 ID. 반복하거나 쉼표로 구분 | 모든 서버 |
--token | string | 명령을 사전 승인할 서비스 토큰(이름 또는 ID) | — |
--username | string | 명령을 실행할 계정. 모든 계정은 "*" | — |
--output | string | 출력 형식: table 또는 json | table |
예제
서버 하나에 명령 하나 사전 승인
alpacon acl entry add --token deploy-bot --command "systemctl restart nginx" \
--username root --server web-01서버 두 대에 패턴을 지정한 시각까지 사전 승인
alpacon acl entry add --token deploy-bot --command "docker compose *" \
--username deploy --server web-01,web-02 --expires-at 2027-01-15T10:00:00Z파일로 여러 항목 추가
alpacon acl entry add --file entries.json파일로 항목 추가
--file은 항목의 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만 가능 |
모르는 필드가 있으면 거부합니다. 그래서 필드 이름을 잘못 써서 의도보다 넓은 항목이 조용히 발급되는 일이 없습니다.