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

# Desktop Agent 설정

> 회사 레벨 데스크톱 에이전트 설정으로 Company Access Key, 네트워크 단절 시 페일세이프, 미할당 사용자 기본 정책을 구성합니다 (Starfort v1.4 문서)

**Desktop Agent › 설정**을 열어 회사 전반에서 [Desktop Agent](/ko/v1.4/desktop/how-it-works)가 동작하는 방식을 구성합니다.

<Frame caption="Desktop Agent 설정 (자격 증명 마스킹됨) — Network Fail-Safe 강조 표시">
  <img src="https://mintcdn.com/aimintelligence/-3ie4No4rGti8Jbz/images/v1.3/admin/desktop-agent-settings.png?fit=max&auto=format&n=-3ie4No4rGti8Jbz&q=85&s=8a478c6648f9577ccf127adc94c4ecba" alt="Network Fail-Safe 섹션이 강조 표시되고 자격 증명이 가려진 Desktop Agent 설정" width="1200" height="1980" data-path="images/v1.3/admin/desktop-agent-settings.png" />
</Frame>

## 액세스 자격 증명

* **Company Access Key** — 직원이 Agent를 [등록](/ko/v1.4/desktop/register)하기 위해 입력합니다. 이를 \*\*교체(rotate)\*\*하면 새 키가 발급되고 **기존의 모든 등록이 한 번에 무효화됩니다**: 모든 디바이스가 작동하려면 새 키로 다시 등록해야 합니다. 교체는 [감사 로그](/ko/v1.4/admin/audit-log)에 기록됩니다.
* **Exit Password** — 사용자가 Agent를 종료하기 위해 입력해야 하는 회사 전체 공통 코드 하나입니다. 올바르게 입력하면 **현재 세션에 한해서만** Agent가 중지됩니다 — 다음 재부팅 시 **자동으로 다시 시작됩니다**. 이것은 일시 중지이지 제거가 아닙니다. 영구 제거는 Uninstaller나 [Hard Delete](/ko/v1.4/admin/agent-users#remove-a-user)를 통해 이루어집니다.

<Warning>
  Access Key와 Exit Password는 비밀 정보로 다루세요. Access Key를 교체하면 모든 Agent가 다시 인증해야 합니다.
</Warning>

## 할당량

* **Desktop Agent Project Count** — 회사가 생성할 수 있는 Desktop Agent 프로젝트의 수입니다. `current projects ≤ new value ≤ system allowance` 범위 내에서 조정할 수 있습니다.
* **Agent User Count Limit** — 등록된 [Agent User](/ko/v1.4/admin/agent-users)의 최대 수입니다. 현재 사용량 이상으로만 낮출 수 있으며, 시스템 허용치를 초과할 수는 없습니다.

## Network Fail-Safe

설치된 Agent가 **Starfort에 연결할 수 없을 때** 수행할 동작을 제어합니다. 이는 **회사 전체에 적용되는 단일 값**입니다 — 아직 어느 프로젝트에도 할당되지 않은 디바이스도 네트워크가 끊겼을 때 보호되도록 정확히 그 목적으로 (프로젝트별이 아니라) 회사 수준에서 설정됩니다. 연결이 복구되면 자동으로 복구됩니다.

| 옵션                  | 동작                        |
| ------------------- | ------------------------- |
| **Fail-Open** (기본값) | 가로챈 모든 요청을 허용합니다(가용성 우선). |
| **Fail-Closed**     | 가로챈 모든 요청을 차단합니다(보안 우선).  |

## 디바이스가 할당되기 전

등록되었지만 프로젝트에 **아직 할당되지 않은** Agent의 동작은 이 화면의 **미할당 기본 정책**(Open / Close)로 설정됩니다:

| 옵션             | 동작                                       |
| -------------- | ---------------------------------------- |
| **Open** (기본값) | 미할당 Agent는 할당될 때까지 모든 AI 서비스 요청을 통과시킵니다. |
| **Close**      | 미할당 Agent는 할당될 때까지 모든 AI 서비스 요청을 차단합니다.  |

어느 쪽이든 디바이스를 프로젝트에 [할당](/ko/v1.4/admin/agent-users#assign-users)하기 전까지는 어떤 Guard Policy도 집행되지 않습니다 — 할당되면 프로젝트의 [Control Profile](/ko/v1.4/admin/control-profiles)이 이를 넘겨받습니다.

이 설정들은 시스템 전체 Desktop Agent 기능과 회사 Desktop Agent 기능이 **모두** 활성화된 경우에만 표시됩니다.
