> ## 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 설정

> 회사 수준의 Desktop Agent 구성: access key, fail-safe 동작, 그리고 미할당 기본 정책.

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

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

## 액세스 자격 증명

* **Company Access Key** — 직원이 Agent를 [등록](/ko/v1.2/desktop/register)하기 위해 입력합니다. 이를 \*\*교체(rotate)\*\*하면 새 키가 발급되고 **기존의 모든 등록이 한 번에 무효화됩니다**: 모든 디바이스가 작동하려면 새 키로 다시 등록해야 합니다. 교체는 [Audit Log](/ko/v1.2/admin/audit-log)에 기록됩니다.
* **Exit Password** — 사용자가 Agent를 종료하기 위해 입력해야 하는 회사 전체 공통 코드 하나입니다. 올바르게 입력하면 **현재 세션에 한해서만** Agent가 중지됩니다 — 다음 재부팅 시 **자동으로 다시 시작됩니다**. 이것은 일시 중지이지 제거가 아닙니다. 영구 제거는 Uninstaller나 [Hard Delete](/ko/v1.2/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.2/admin/agent-users)의 최대 수입니다. 현재 사용량 이상으로만 낮출 수 있으며, 시스템 허용치를 초과할 수는 없습니다.

## Network Fail-Safe

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

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

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

등록되었지만 프로젝트에 **아직 할당되지 않은** Agent는 거버넌스되는 모든 엔드포인트를 즉시 차단합니다 — 디바이스를 프로젝트에 [할당](/ko/v1.2/admin/agent-users#assign-users)하기 전까지는 사용자가 거버넌스되는 AI 서비스에 도달할 수 없습니다. 할당되면 프로젝트의 [Control Profile](/ko/v1.2/admin/control-profiles)이 이를 넘겨받습니다.

이 Settings 화면에는 Agent가 프로젝트에 할당되기 전 동작을 제어하는 **Unassigned Default Policy**(Open / Close) 토글도 있습니다. **Open**으로 설정하면 미할당 Agent가 할당될 때까지 모든 트래픽을 허용하고, **Close**로 설정하면 할당될 때까지 모든 트래픽을 차단합니다.

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