> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 라이선스

> 라이선스 키 등록, 티어별 기능 확인, 기능 키 관리와 모듈별 활성 상태를 확인합니다

<Info>관리자 › 설정 › 라이선스</Info>

라이선스 키를 등록해 티어별 기능을 활성화하고, 모듈별 활성 상태를 확인합니다.

<Frame caption="라이선스 설정 탭">
  <img src="https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-license.png?fit=max&auto=format&n=Or1RjU_AzOVJRxuS&q=85&s=4dc53ec816b255fe69e520bdebe13ad8" alt="라이선스 설정 탭" width="2880" height="1800" data-path="images/admin/settings-license.png" />
</Frame>

***

## 티어 구성

| 티어               | 포함 기능                                                                                                                      |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Basic**        | 기본 채팅, 사용자 관리 (라이선스 모듈 미포함)                                                                                                |
| **Standard**     | Basic + 감사 로그, 용어 사전, 가드레일, 이미지 생성, KbSphere, 도구 (6개 모듈)                                                                   |
| **Professional** | Standard + 에이전트 플로우, 대시보드, 브랜딩, DbSphere, 문서 템플릿, 임베드 위젯, 자동 평가, 추적                                                        |
| **Enterprise**   | **전체 모듈 포함**(`has_all_features` — 향후 추가 모듈도 자동 포함). Professional 대비 추가: Code Gateway, 암호화, File Guardrail, 전역 가드레일, 지식 그래프 |

***

## 키 유형

| 유형         | 설명                             |
| ---------- | ------------------------------ |
| **라이선스 키** | 티어를 지정하며, 최대 사용자 수와 만료일을 포함합니다 |
| **기능 키**   | 특정 모듈을 티어와 무관하게 개별 활성화합니다      |

**기능 키로 활성화 가능한 모듈:**

<Accordion title="기능 키 모듈 전체 (19개)" icon="key">
  | 모듈                   | 설명               |
  | -------------------- | ---------------- |
  | `audit_log`          | 감사 로그            |
  | `glossary`           | 용어 사전            |
  | `guardrail`          | 가드레일             |
  | `image_generation`   | 이미지 생성           |
  | `kbsphere`           | 지식 기반 (KbSphere) |
  | `tools`              | 도구               |
  | `agent_flow`         | 에이전트 플로우         |
  | `ai_dashboard`       | 대시보드             |
  | `branding`           | 브랜딩              |
  | `dbsphere`           | DbSphere         |
  | `document_templates` | 문서 템플릿           |
  | `embed_widget`       | 임베드 위젯           |
  | `evaluation`         | 자동 평가            |
  | `trace`              | 추적               |
  | `code_gateway`       | Code Gateway     |
  | `encryption`         | 암호화(KMS)         |
  | `file_guardrail`     | File Guardrail   |
  | `global_guardrail`   | 전역 가드레일          |
  | `knowledge_graph`    | 지식 그래프           |
</Accordion>

***

## 라이선스 등록

<Steps>
  <Step title="키 발급">
    Cloocus 담당자에게 라이선스 키를 발급받습니다.
  </Step>

  <Step title="키 입력">
    **관리자 > 설정 > 라이선스** 탭에서 키를 입력합니다.
  </Step>

  <Step title="키 등록">
    **"키 등록"** (Register Key) 버튼을 클릭합니다. 라이선스 키와 기능 키 모두 동일한 입력란을 사용합니다.
  </Step>

  <Step title="상태 확인">
    등록 후 현재 라이선스 상태를 확인합니다.

    | 확인 항목                      | 설명                                                  |
    | -------------------------- | --------------------------------------------------- |
    | **티어**                     | 현재 활성 티어                                            |
    | **회사명**                    | 라이선스 발급 대상                                          |
    | **최대 사용자 수**               | 허용되는 최대 사용자 수                                       |
    | **만료일**                    | 라이선스 만료 일시                                          |
    | **기능 현황** (Feature Status) | 모듈별 Available / Not Licensed 상태 및 enforcement 설정 상태 |
  </Step>
</Steps>

***

## 라이선스 관리

등록된 라이선스 키와 기능 키는 목록에서 확인할 수 있으며, 개별 삭제가 가능합니다.

* 라이선스를 등록하면 **라이선스 상태**에 티어·회사명·최대 사용자 수·만료일이 표시되고, **기능 현황**에 모듈별 `Available` / `Not Licensed` 상태가 나타납니다.

<Note>
  라이선스를 등록하기 전에는 상태가 `미등록`으로 표시되며, 키 목록과 기능 현황은 비어 있습니다. 위 정보는 라이선스 키를 등록한 뒤에 나타납니다.
</Note>

<Note>
  `ENABLE_LICENSE_ENFORCEMENT` 환경 변수가 `false`이면 라이선스 없이 모든 기능을 사용할 수 있습니다.
  기업 환경에서 기능 제어가 필요한 경우 `true`로 설정하세요.
</Note>

<Warning>
  라이선스 키를 삭제하면 해당 티어의 기능이 즉시 비활성화됩니다.
  삭제 전 현재 사용 중인 기능에 영향이 없는지 확인하세요.
</Warning>