# 비인가 소프트웨어 관리하기

## 비인가 소프트웨어 관리하기

사이드바의 **`비인가`** 그룹 아래에 두 개의 페이지가 있습니다. 각 페이지는 역할이 명확히 분리되어 있습니다.

| 페이지       | 경로                       | 용도                                    |
| --------- | ------------------------ | ------------------------------------- |
| **정책 목록** | `/software/policy`       | 비인가 정책을 등록·관리 (어떤 소프트웨어가 비인가인지 규칙 정의) |
| **위반 내역** | `/software/policy-issue` | 탐지된 위반 건을 확인·해결                       |

***

### 주요 기능

| 기능        | 설명                                       |
| --------- | ---------------------------------------- |
| **자동 탐지** | 에이전트를 통해 비인가 소프트웨어 자동 탐지                 |
| **정책 관리** | 비인가 소프트웨어 정책 등록 및 관리 (검색으로 소프트웨어 빠르게 지정) |
| **알림 발송** | 위반 발생 시 담당자·관리자에게 알림                     |
| **해결 추적** | 위반 상태(신규/해결됨) 추적 및 일괄 처리                 |

***

### 사전 요구사항

비인가 소프트웨어 탐지를 위해 다음 조건이 필요합니다.

| 요구사항         | 설명                               |
| ------------ | -------------------------------- |
| **에이전트 설치**  | 구성원 기기에 SMPLY 에이전트가 설치되어 있어야 합니다 |
| **에이전트 활성화** | 에이전트가 정상적으로 실행 중이어야 합니다          |
| **관리자 권한**   | 정책 등록 시 관리자 권한이 필요합니다            |

{% hint style="warning" %}
**에이전트 필수** 에이전트가 설치되지 않은 기기에서는 비인가 소프트웨어를 탐지할 수 없습니다.
{% endhint %}

***

### 정책 목록 페이지 (`/software/policy`)

**제목**: *비인가 소프트웨어* **설명**: *비인가 소프트웨어 정책을 관리합니다.*

우측 상단의 **`정책 추가하기`** 버튼으로 새 정책을 등록합니다.

#### 컬럼

| 컬럼         | 의미                    |
| ---------- | --------------------- |
| **정책명**    | 정책 식별 이름              |
| **유형**     | 현재는 `금지`만 지원          |
| **비인가 사유** | 정책 등록 시 남긴 설명(내부 참고용) |
| **담당자**    | 위반 시 알림을 받는 담당자       |
| **전체 이슈**  | 지금까지 발생한 위반 건수        |
| **신규 이슈**  | 아직 해결되지 않은 위반 건수      |
| **마지막 발생** | 가장 최근에 위반이 기록된 시각     |

***

### 정책 등록 (소프트웨어 검색 지원)

**단계 1: 정책 추가 다이얼로그 열기**

1. **소프트웨어 > 비인가 > 정책 목록** 으로 이동합니다.
2. 우측 상단 **`정책 추가하기`** 버튼을 클릭합니다.

**단계 2: 소프트웨어 선택**

| 필드           | 필수 | 설명                                                                     |
| ------------ | -- | ---------------------------------------------------------------------- |
| **소프트웨어 제품** | ✅  | 정책 대상 소프트웨어. 검색창 *"이름으로 검색"* 에 소프트웨어명을 입력하면 실시간 필터링되며 로고와 함께 결과가 나타납니다 |
| **담당자**      |    | 위반 알림을 받을 담당자. 이름/이메일 검색 가능                                            |
| **설명**       |    | 왜 이 소프트웨어가 비인가인지 내부 참고용 메모                                             |

{% hint style="info" %}
**검색 기능 (PRD-5088)** 정책 추가 다이얼로그에는 **소프트웨어 제품 검색**이 포함되어 있어 수많은 제품 중에서 빠르게 찾을 수 있습니다. 타이핑하면 결과가 즉시 좁혀집니다.
{% endhint %}

**단계 3: 저장**

1. **`저장`** 버튼을 클릭합니다.
2. 저장 즉시 탐지가 시작됩니다.

{% hint style="warning" %}
**정책 수정은 소프트웨어 변경 불가** 정책을 저장한 뒤에는 대상 소프트웨어를 변경할 수 없습니다. 다른 소프트웨어에 대한 정책이 필요하면 신규 정책을 생성하세요. 설명·담당자는 수정할 수 있습니다.
{% endhint %}

***

### 위반 내역 페이지 (`/software/policy-issue`)

**제목**: *위반 내역* **설명**: *비인가 소프트웨어 위반 내역을 관리합니다.*

정책에 의해 탐지된 개별 위반 건이 이곳에 기록됩니다.

#### 컬럼

| 컬럼           | 의미                    |
| ------------ | --------------------- |
| **소프트웨어**    | 탐지된 비인가 소프트웨어         |
| **상태**       | `신규` (미해결) 또는 `해결됨`   |
| **출처**       | 탐지 소스 (에이전트 등)        |
| **영향받은 사용자** | 해당 소프트웨어가 탐지된 기기의 소유자 |
| **최근 발생일**   | 가장 최근 탐지 시각           |

#### 벌크 액션

체크박스로 여러 건을 선택하면 하단 Action Bar에서:

* **해결 처리** — 선택 건을 모두 `해결됨` 상태로 전환
* **삭제** (빨간색) — 선택 건을 목록에서 완전히 제거

***

### 위반 발생 시 알림

비인가 소프트웨어가 탐지되면 다음 대상에게 알림이 발송됩니다.

| 알림 대상      | 설명                   |
| ---------- | -------------------- |
| **정책 담당자** | 해당 정책에 지정된 담당자       |
| **관리자**    | SMPLY 관리자 권한을 가진 구성원 |

***

### 위반 해결하기

**단계 1: 위반 내역 확인**

1. **소프트웨어 > 비인가 > 위반 내역** 으로 이동합니다.
2. 상태가 `신규` 인 항목을 확인합니다.

**단계 2: 해결 처리**

1. 구성원과 협의해 해당 소프트웨어를 제거·교체합니다.
2. 해결된 항목에 체크 후 **`해결 처리`** 를 클릭합니다.

{% hint style="info" %}
**재탐지** 해결 처리 후에도 해당 소프트웨어가 다시 탐지되면 새로운 위반으로 기록되고 알림이 재발송됩니다.
{% endhint %}

***

### 자주 묻는 질문

#### Q: 특정 부서나 팀에만 정책을 적용할 수 있나요

현재 정책은 **조직 전체**에 적용됩니다. 부서별 예외 정책은 별도 지원되지 않으며, 필요 시 위반 내역에서 개별 건을 해결 처리로 관리하세요.

#### Q: 위반 알림 빈도를 조정할 수 있나요

최초 탐지 시 1회, 해결 후 재탐지 시 다시 발송되는 구조입니다. 알림 빈도 자체는 설정할 수 없습니다.

#### Q: 비인가 소프트웨어를 자동으로 삭제할 수 있나요

SMPLY는 모니터링 도구로, 소프트웨어를 강제 삭제하지 않습니다. 탐지된 위반에 대해 담당자가 직접 조치해야 합니다.

#### Q: 정책 추가 다이얼로그에서 우리 소프트웨어가 검색되지 않아요

* 소프트웨어가 아직 SMPLY의 **소프트웨어 카탈로그**에 등록되지 않았을 수 있습니다.
* 영문명/한글명을 바꿔서 검색해 보세요.
* 그래도 없으면 [소프트웨어 수동으로 추가하기](/software_management/manual_saas.md) 문서를 따라 먼저 등록한 뒤 정책을 만드세요.

#### Q: 에이전트 없이 SaaS 사용을 탐지할 수 있나요

비인가 소프트웨어 탐지는 **에이전트 기반**입니다. SSO 로그인 기반 탐지는 [소프트웨어 발견](/software_management/discovery.md) 기능을 활용하세요.


---

# 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/software_management/unauthorized-software.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.