> ## 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.
# Agent User
> Desktop Agent를 실행하도록 등록된 직원을 관리합니다.
**Agent User**는 회사에서 [Desktop Agent](/ko/v1.2/desktop/how-it-works)를 실행하도록 등록된 직원입니다. **Desktop Agent › Agent Users**를 열어 관리합니다.
## 사용자 등록 방법
직원은 **Company Access Key**([Desktop Agent 설정](/ko/v1.2/admin/desktop-agent-settings)에서 발급)로 Agent를 등록합니다 — [Desktop Agent 등록](/ko/v1.2/desktop/register)을 참고하세요. 각 디바이스는 Company Access Key와, Agent가 첫 실행 시 스스로 생성하는 **Agent ID**로 식별됩니다. 새로 등록된 사용자는 여기에 **Unassigned**로 나타나며, 여기에서 프로젝트에 할당합니다.
## 사용자 할당
하나 이상의 Unassigned 사용자를 선택하고, 매핑 정보 — 이름, 이메일, 사번, 조직, 프로젝트 — 를 **일괄로 또는 하나씩** 입력하여 프로젝트에 할당합니다. 그 순간부터 프로젝트의 [Control Profile](/ko/v1.2/admin/control-profiles)이 자동으로 적용됩니다. 별도의 권한 단계는 없습니다.
회사 내에서 Agent User의 **이메일**과 **사번**은 각각 고유해야 합니다.
## 모드의 의미
각 Agent User는 (할당 여부와 일시 중지 여부에 따라 도출되는) **모드**를 표시합니다:
| 모드 (레이블) | 시점 | Agent의 동작 |
| --------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Unassigned** (Off) | 등록되었으나 아직 프로젝트에 할당되지 않음 | 회사의 Control Profile에 정의된 모든 엔드포인트를 **차단**합니다 — 디바이스를 할당하기 전까지는 거버넌스되는 서비스에 도달할 수 없습니다. 트레이스는 기록되지 않습니다. |
| **Assigned** (On) | 프로젝트에 할당됨 | 프로젝트의 Guard Policy를 정상적으로 시행하고, 트레이스를 기록합니다. |
| **Inactive** (Paused) | 명시적으로 일시 중지함(선택적으로 지정 시간 동안) | 모든 요청을 **통과**시킵니다 — Guard가 꺼져 있습니다. 트레이스 없음. 타이머가 만료되면 자동으로 재개됩니다. |
별도로, **Health** 표시기(Online / Offline / Uninstalled)는 디바이스의 연결 상태를 보여줍니다 — 모드와는 독립적입니다.
## 사용자 제거
* **Self-deregister** — 사용자가 (Uninstaller를 통해) Agent를 제거하면, 디바이스가 제거되고, 그 슬롯이 수 제한에서 회수되며, 토큰이 무효화됩니다. Health는 **Uninstalled**가 됩니다.
* **Hard Delete** — 어떤 상태에서든 Agent User를 직접 영구 제거할 수 있습니다 — 분실/폐기된 디바이스나 GDPR 정리에 유용합니다. 슬롯을 회수하고 토큰을 무효화합니다.
두 작업 모두 [Audit Log](/ko/v1.2/admin/audit-log)에 기록됩니다. **재설치** 시, Agent ID를 유지한 디바이스는 동일한 레코드를 되살리고, Agent ID를 잃은 디바이스는 다시 할당해야 하는 새 Agent User로 등록됩니다.
## 제한
Agent User의 수는 [Desktop Agent 설정](/ko/v1.2/admin/desktop-agent-settings)에서 구성하는 회사의 **Agent User Count Limit**에 의해 제한됩니다. 한도에 도달하면 새 등록이 차단됩니다.