---
title: "alpacon acl entry add"
description: "Alpacon CLI의 alpacon acl entry add 명령으로 서비스 토큰에 명령 패턴을 사전 승인합니다. 플래그로 하나를 추가하거나 JSON 파일로 여러 항목을 한 번에 추가할 수 있습니다. 명령을 실행하기 전에 사용 구문과 플래그의 유형, 예제를 확인하세요."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# alpacon acl entry add

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

## 사용법

```text
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` |

## 예제

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

```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`만 가능 |

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

Source: https://docs.alpacax.com/ko/reference/cli/acl/entry-add/
