---
title: "alpacon acl"
description: "Alpacon CLI의 alpacon acl 명령으로 서비스 토큰의 사전 승인된 명령과 이를 변경할 수 있는 Command ACL 관리자를 관리합니다. 원장에는 별도 브라우저 인증이 필요합니다. 명령을 실행하기 전에 사용 구문과 플래그의 유형 및 기본값, 예제를 확인하세요."
---

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

# alpacon acl

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

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

## 사용법

```text
alpacon acl [flags]
alpacon acl [command]
```

## 핵심 사항

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

## 플래그

| 플래그 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| `-h, --help` | `bool` | 명령 도움말 표시 | `false` |
| `--output` | `string` | 출력 형식: `table` 또는 `json` | `table` |

## 예제

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

```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 서버는 별도의 환경 변수를 읽습니다. [원장 로그인](/reference/mcp/tools/security/#원장-로그인)을 참고하세요.

## 관련 명령

  
    사전 승인된 명령 항목 관리
  
  
    Command ACL 관리자 관리

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