# 에이전트 1.0.0 전환 가이드

## 에이전트 1.0.0 전환 가이드

심플리 에이전트가 1.0.0으로 정식 출시되었습니다. 더 쉽게 설치하고, 더 안정적으로 동작하며, 보안이 한층 강화되었습니다. 앞으로 비인가 소프트웨어 강제 종료와 같은 강력한 제어 기능은 모두 1.0.0 위에서 제공됩니다.

***

#### 한눈에 보는 변화

| 항목           | 기존 에이전트        | 에이전트 1.0.0                 |
| ------------ | -------------- | -------------------------- |
| **설치 후 사용**  | 구성원이 직접 로그인 필요 | 로그인 불필요 (심플리에서 호스트 연결)     |
| **실행 방식**    | 화면에 띄워지는 앱     | 백그라운드에서 자동 실행              |
| **시작 시점**    | 사용자 로그인 후      | 운영체제 시작과 동시에               |
| **중단 시 복구**  | 앱 내부에서 재시도     | 운영체제가 자동 재시작 + 문제 버전 자동 복구 |
| **업데이트 안전성** | 자동 업데이트        | 위·변조 검증 + 문제 발생 시 자동 복구    |
| **신규 기능**    | 추가되지 않음        | 모든 신규 기능 우선 제공             |

***

### 주요 개선 사항

#### 1. 로그인이 사라졌습니다

기존에는 에이전트 설치 후 구성원이 직접 로그인해야 사용이 시작됐습니다. 1.0.0에서는 설치만 하면 호스트가 심플리에 자동 등록되고, 관리자가 기기와 연결하기만 하면 됩니다.

{% hint style="info" %}
**구성원 입장에서 더 쉬워졌습니다** 별도의 로그인 절차나 웹 브라우저 인증이 필요하지 않습니다. 설치만 하면 끝입니다.
{% endhint %}

#### 2. 백그라운드에서 안정적으로 동작합니다

화면에 띄워지는 앱이 아니라, 운영체제와 함께 자동으로 실행되는 백그라운드 프로그램입니다. 사용자가 임의로 종료할 수 없으며, 어떤 이유로 중단되더라도 운영체제가 자동으로 재시작합니다.

#### 3. 보안이 한층 강화되었습니다

| 보안 기능        | 설명                                              |
| ------------ | ----------------------------------------------- |
| **무결성 검증**   | 업데이트 파일이 위·변조되지 않았는지 자동으로 확인합니다                 |
| **자동 복구**    | 문제가 생긴 버전은 자동으로 이전 안정 버전으로 되돌리고, 다시 설치되지 않습니다   |
| **기기 단위 인증** | 사용자 계정이 아닌 기기 자체로 인증되어, 사용자 비밀번호 유출과 무관하게 보호됩니다 |

{% hint style="success" %}
**관리가 중단되지 않습니다** 업데이트 과정에서 문제가 생기더라도 자동으로 이전 버전으로 복구되어 자산 수집이 끊기지 않습니다.
{% endhint %}

#### 4. 관리 사각지대 제거

기존에는 사용자가 로그인한 뒤에야 동작했지만, 1.0.0은 부팅 직후부터 동작하여 근무 시간 외 자산 현황까지 추적합니다.

#### 5. 앞으로 추가될 1.0.0 전용 기능

* **비인가 소프트웨어 강제 종료** — 정책 위반 소프트웨어 자동 종료
* **사용자 경고 알림** — 비인가 소프트웨어 실행 시 사용자에게 안내
* **정책 기반 제어** — 다양한 IT 통제 시나리오

{% hint style="warning" %}
**기존 에이전트는 신규 기능이 추가되지 않습니다** 보안과 제어 측면의 새로운 기능은 모두 1.0.0에서만 제공됩니다. 빠른 전환을 권장드립니다.
{% endhint %}

***

### 전환 방법

**단계 1: 기존 에이전트 제거**

1. 심플리 웹에서 **설정 > 에이전트 관리**로 이동합니다.
2. 전환할 기기의 기존 에이전트를 찾아 **삭제** 버튼을 클릭합니다. 삭제 즉시 해당 기기에서 사용자가 로그아웃됩니다.
3. 기기에서도 SMPLY Agent를 직접 제거합니다.
   * macOS: 응용 프로그램 폴더에서 SMPLY Agent를 삭제합니다.
   * Windows: 제어판 > 프로그램 추가/제거에서 SMPLY Agent를 제거합니다.

{% hint style="info" %}
**양쪽 모두 정리해야 합니다** 심플리 웹에서 삭제만 하고 기기에 앱이 남아 있으면 잔여 데이터가 계속 수집될 수 있습니다.
{% endhint %}

**단계 2: 신규 에이전트 1.0.0 설치**

1. 심플리 메인 메뉴의 **호스트** 페이지로 이동합니다.
2. 화면 우측 상단의 **에이전트 다운로드** 버튼을 클릭합니다.
3. 사용 중인 OS에 맞는 설치 파일을 다운로드합니다.
4. 설치 파일을 실행하여 설치합니다 (관리자 권한 필요).

{% hint style="info" %}
**MDM으로 일괄 배포할 수 있습니다** Jamf, Intune 등 MDM 솔루션을 사용하시는 경우, 무인(Silent) 설치로 다수 기기에 동시 배포가 가능합니다. 자세한 배포 옵션과 명령어는 채널톡으로 문의해 주세요.
{% endhint %}

**단계 3: 호스트 연결**

1. 설치가 완료되면 잠시 후 심플리의 **호스트** 목록에 자동으로 등록됩니다.
2. 등록된 호스트를 클릭하여 기기와 연결합니다.
3. 일련번호가 일치하는 등록 기기가 있으면 자동으로 연결됩니다.

{% hint style="info" %}
**기존 데이터는 그대로 유지됩니다** 기기 매칭 이력, 소프트웨어 사용 기록 등 모든 데이터가 보존됩니다. 재설치로 인한 데이터 손실은 없습니다.
{% endhint %}

***

#### 자주 묻는 질문

**Q: 기존 에이전트는 언제까지 사용할 수 있나요?**

강제 종료 일정은 없습니다. 기존 에이전트도 계속 동작합니다. 다만 신규 기능 업데이트가 제공되지 않으므로 빠른 전환을 권장합니다.

**Q: 일부 기기만 먼저 전환해도 되나요?**

가능합니다. 호스트 단위로 점진적 전환이 가능하며, 두 버전이 같은 워크스페이스에 공존해도 문제없이 동작합니다.

**Q: 전환 시 구성원이 해야 할 일이 있나요?**

설치 외에는 없습니다. 1.0.0은 로그인이 필요 없으며, 설치 완료 후 별도 조작 없이 자동으로 동작합니다.

**Q: 지원 OS는 동일한가요?**

네. macOS와 Windows를 동일하게 지원합니다.

**Q: 사용자가 에이전트를 임의로 중단시킬 수 있나요?**

아니요. 백그라운드 프로그램으로 동작하기 때문에 관리자 권한 없이는 중단시킬 수 없으며, 중단되더라도 운영체제가 자동으로 재시작합니다.

**Q: 자동 업데이트가 실패하면 어떻게 되나요?**

업데이트 파일의 위·변조 여부가 자동으로 확인되며, 문제가 생긴 버전은 자동으로 이전 안정 버전으로 되돌아갑니다. 한번 문제가 확인된 버전은 다시 설치되지 않습니다.

**Q: 브라우저 사용 데이터도 수집되나요?**

기존 에이전트와 동일하게 포그라운드 앱 사용 시간을 수집합니다. 1.0.0은 추가로 SaaS 발견 정확도 향상을 위해 브라우저의 도메인 정보를 수집합니다. 파일 내용이나 개인 데이터는 수집하지 않습니다.

***

#### 도움이 필요하신가요?

전환 과정에서 문제가 발생하면 채널톡으로 문의해 주세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/agent/v1-migration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.