> ## 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 문제와 대처 방법.

<Note>
  **Windows 전용.** 이 가이드는 추후 문서 업데이트에서 주석이 달린 스크린샷과 함께 보강될 예정입니다.
</Note>

| 증상                  | 추정 원인                                                                                                                                                                                                          | 대처 방법                                                                                                                                     |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 모든 것이 차단됨           | Agent가 아직 [프로젝트에 할당되지 않았거나](/ko/v1.2/desktop/register#before-you-re-assigned-to-a-project)(기본 거부), [Kill Switch](/ko/v1.2/admin/kill-switch)가 활성화되어 있거나, 회사가 *fail-closed*를 사용하는데 Agent가 Starfort에 연결할 수 없습니다. | 관리자에게 Agent 할당을 요청하거나 Kill Switch를 확인하고, 네트워크 연결을 확인하세요.                                                                                  |
| AI 도구가 아무 보호 없이 작동함 | Agent가 실행되지 않았거나 등록되지 않았거나, 회사가 *fail-open*을 사용하는데 Agent가 Starfort에 연결할 수 없거나, 할당된 프로젝트에 활성 [Control Profile](/ko/v1.2/admin/control-profiles)이 없습니다.                                                          | Agent를 다시 실행하고, 메시지가 표시되면 다시 [등록](/ko/v1.2/desktop/register)하세요. 그래도 안 되면 관리자에게 확인하세요.                                                    |
| "등록 중"에서 멈춤         | Agent가 Starfort에 연결할 수 없거나, **또는** 등록이 거부되었습니다 — 예를 들어 회사의 Agent 한도에 도달했거나 Desktop Agent 기능이 비활성화된 경우입니다.                                                                                                      | 거부 사유가 표시되면 관리자가 해결해야 합니다(재시도해도 소용없음). 그렇지 않으면 네트워크를 확인하고 다시 시도하세요. [등록 거부](/ko/v1.2/desktop/register#if-registration-is-refused)를 참고하세요. |
| 민감한 데이터가 마스킹되지 않음   | 이를 다루는 PII 정책이 없거나, 엔드포인트가 거버넌스 대상 캡처 대상이 아니거나, 해당 엔드포인트에서 마스킹 알림이 억제되어 있습니다(마스킹은 그래도 이루어졌을 수 있음).                                                                                                             | 관리자에게 보고하세요 — 정책 적용 범위와 알림 설정은 Console에서 구성됩니다.                                                                                           |

문제가 지속되면, 관리자가 [Opticon 모니터링](/ko/v1.2/admin/monitoring-opticon)에서 관련 트레이스를 조회하여 Guardian이 무엇을 어떻게 판단했는지 정확히 확인할 수 있습니다.

## Agent 제거

제공된 제거 프로그램으로 Agent를 제거합니다. 제거 프로그램은 **먼저 서버에서 Agent의 등록을 해제한 다음** PC에서 제거합니다 — 따라서 네트워크를 사용할 수 없으면 제거가 진행되지 않습니다. 다시 연결한 후 제거 프로그램을 재실행하세요. Agent를 제거하면 로컬에 저장된 Agent ID도 삭제되므로, 이후 재설치 시 새로운 ID가 생성됩니다.

<Note>Agent를 종료하거나 일시 중지하려면 관리자가 설정한 **Exit Password**가 필요할 수 있습니다.</Note>