# Agent Demo 사용 안내

Key4C 서비스는 **KT Cloud(공공·민간)** 및 **AWS** 환경에 구축되어 개발·운영되고 있습니다.

Key4C는 대표 핵심 서비스로 **HSM 서비스**와 **KMS 서비스**를 제공하며,\
이와 함께 **OTP, JWT, Kubernetes(K8S), 보안 토큰, E2E 암호화, Private CA** 등\
다양한 보안 특화 서비스를 제공합니다.

현재 Key4C는 **랜섬웨어 차단에 특화된 서비스로 Secure Folder를 연구·개발 중**입니다.\
본 Demo 버전은 Key4C 특화 서비스 중 하나인 **Secure Folder 서비스의 상용화를 위해 개발된 데모 환경**입니다.

***

## **Demo 버전 실행 안내**

Key4C 회원은 Key4C에서 제공하는 다양한 보안 서비스를 구독하여 사용할 수 있습니다.\
본 Demo 버전은 Key4C의 **Secure Folder 서비스 기능과 동작 방식을 이해하기 위한 데모 환경**입니다.

Demo에서는 다음 두 가지 구성 요소를 제공합니다.\
(1) 관리자를 위한 **웹 콘솔**   /  (2) 사용자를 위한 **Agent**

아래 내용은 <mark style="color:$primary;">**사용자를 위한 Agent 사용 방법**</mark>에 대한 설명입니다.

{% hint style="info" %}
**참고사항**

* Secure Folder 서비스를 구독하지 않은 경우, [<mark style="color:green;">**웹 콘솔 Demo 사용 안내**</mark>](https://key4c.gitbook.io/key4c_sf/manual/demo) 페이지를 먼저 확인해주세요.\
  Key4C 통합 회원 가입 후 Secure Folder 서비스를 구독하여 이용하실 수 있습니다.
* Secure Folder 서비스 이용 안내 메일을 수신 받지 못한 경우, 관리자에게 문의해주세요.
  {% endhint %}

***

## 1. Agent 다운로드 및 로그인

### 1) 다운로드

관리자가 웹 콘솔에서 사용자를 등록하면, 입력한 메일주소로 아래와 같은 메일이 발송됩니다.\
사용자는 메일 주소로 접속하여 수신된 메일을 확인합니다.\
&#x20;\- ID, 임시비밀번호, OTP Secret, Agent download Url, OTP QR 코드\
&#x20;\- <mark style="color:$danger;">**Demo 버전에서 자동으로 등록된 사용자인 경우,**</mark> \
&#x20;   <mark style="color:$danger;">**웹콘솔에서 사용하는 이메일, 비밀번호, OTP를 동일하게 사용할 수 있습니다.  (2026.02.02 정책 추가)**</mark>

<figure><img src="/files/JuJiCtvOqUFj81nBJ5M0" alt=""><figcaption></figcaption></figure>

1. Agent 다운로드 URL에 접속하여 Agent 파일을 다운로드 합니다.
2. 스마트폰으로 OTP APP 설치 후 OTP 계정을 등록합니다.\
   &#x20;\- 앱스토어 > 'Google Authenticator' 검색 후 설치 (AOS, iOS 모두 가능) \
   AOS : <https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=ko> \
   iOS : <https://apps.apple.com/us/app/google-authenticator/id388497605>\
   &#x20;\- 앱 실행 후 \[QR 스캔] 버튼 선택 \
   \- 메일에 보이는 QR 코드 촬영 > 계정 생성 완료 > 비밀번호 확인

{% hint style="info" %}
**참고사항**

* 정식 버전에서는 임시 비밀번호 기능으로 대체되며,\
  기관명 중복 체크, 비밀번호 입력 조건 체크, 입력 오류 횟수 체크 기능이 추가됩니다.
* 가입된ID(이메일)은 중복으로 가입할 수 없습니다.
  {% endhint %}

<figure><img src="/files/miFVisIQHIAH8K1VfPBP" alt="" width="375"><figcaption></figcaption></figure>

3. 다운로드한 Agent 파일을 실행합니다.

<figure><img src="/files/0GrW7s8AMnwta2q3fGCx" alt="" width="375"><figcaption></figcaption></figure>

4. 설치 화면에서 설치 폴더를 확인 후 \[설치] 버튼을 선택합니다.

### 2) 로그인

<figure><img src="/files/PvtzHxcdkI4PMvCpOTnJ" alt=""><figcaption></figcaption></figure>

1. 로그인 화면에서 수신 받은 이메일, 비밀번호, OTP 인증 코드를 입력 후 \[로그인] 버튼을 선택합니다.
2. 정상 로그인 시, 최초 로그인 하는 경우 '비밀번호 변경' 팝업이 노출됩니다.\
   로그인한 이력이 있는 경우 'PIN 설정' 팝업이 노출됩니다.

### 3) 초기 비밀번호 변경

최초 로그인 시 비밀번호 변경 팝업이 노출됩니다. 비밀번호를 변경한 후 서비스를 이용하실 수 있습니다.

<figure><img src="/files/sPebMUUcvCWIPiu4ZQty" alt="" width="354"><figcaption></figcaption></figure>

1. 변경하실 새 비밀번호, 비밀번호 확인, OTP 인증 코드를 입력 후 \[확인] 버튼을 선택합니다.
2. 비밀번호 변경 성공 시, 변경한 비밀번호로 로그인을 다시 진행합니다.

### 4) PIN 번호 설정

<figure><img src="/files/HpaPuUjybs5v0hxqQgNX" alt="" width="354"><figcaption></figcaption></figure>

1. PIN 번호를 6자리 숫자로 설정합니다. \
   PIN 번호는 프로그램 필터 관리 및 보안 폴더에 접근할 때 사용됩니다.

### 5) 자주 사용하는 프로그램 설정

<figure><img src="/files/1719zWwNiJBIgjVL1Z1v" alt="" width="563"><figcaption></figcaption></figure>

대중적으로 많이 사용하는 프로그램과 윈도우 시스템 기능이 PC에 설치되어 있는지 확인합니다.

1. 프로그램 목록을 확인한 후 \[검색 시작] 버튼을 선택합니다.

<figure><img src="/files/aCbys35HXDA5gTo35y5P" alt="" width="563"><figcaption></figcaption></figure>

2. 검색 결과를 확인한 후 \[확인] 버튼을 선택합니다.\
   찾은 프로그램은 허용된 프로그램 필터에 추가됩니다.

## 2. Secure Folder Agent 이용

### 1) 서비스 시작

정상 로그인 시 아래와 같은 메인 화면이 제공됩니다.\
로그아웃을 진행하기 전까지는 PC 재부팅 시에도 로그인 상태가 유지됩니다.

<figure><img src="/files/vy8UDX8mmcOIK7PicoN1" alt=""><figcaption></figcaption></figure>

1. 응용 프로그램 접근 제어에서 \[접근 관리] 버튼을 선택하는 경우 초기에 설정한 PIN 번호 입력 창이 제공됩니다.
2. 보안 폴더 접근에서 \[연결] 버튼을 선택하는 경우 초기에 설정한 PIN 번호 입력 창이 제공됩니다.

<figure><img src="/files/P2w31BPo401Y6fGGZCW2" alt="" width="375"><figcaption></figcaption></figure>

3. 초기에 설정한 PIN 번호를 입력 후 \[확인] 버튼을 선택하세요.
4. PIN 번호 정상 입력 시 선택한 메뉴 화면, 또는 기능이 제공 됩니다.\
   \- 응용 프로그램 접근 제어 > \[접근 관리] 버튼 선택 > 프로그램 필터 화면 제공\
   \- 보안 폴더 접근 > \[연결]  버튼 선택 > 보안 폴더 연결

### 2) 보안 폴더 접근 (Mount)

#### 보안 폴더연결 및 해제

<figure><img src="/files/u73LLT7uqjwQS0wKDuar" alt=""><figcaption></figcaption></figure>

1. 메인 화면에서 보안 폴더 접근 \[연결] 버튼을 선택합니다.
2. PIN 번호 정상 인증 시 보안 폴더에 연결되며 메인 화면에 아래와 같이 노출됩니다.

<figure><img src="/files/r4EvLXCxqJ4AGu3pQiSX" alt=""><figcaption></figcaption></figure>

3. 보안 폴더에  마운트 된 상태에서 \[열기] 버튼을 선택합니다.

<figure><img src="/files/C00IAKAVB7AWWv8PeSQY" alt=""><figcaption></figcaption></figure>

4. 마운트 된 드라이브 경로로 파일 탐색기가 실행됩니다.
5. \[연결 해제] 버튼을 선택하는 경우, 보안 폴더의 연결이 해제됩니다.\
   보안 폴더의 연결이 해제되면 보안 폴더는 파일 탐색기에서 노출되지 않습니다.

<figure><img src="/files/VKmFnNUBFej9e26zjBAp" alt=""><figcaption></figcaption></figure>

#### 보안 폴더 사용

보안 폴더에 연결하면 보안 폴더 내에 파일을 넣어 보관하실 수 있습니다. \
사용 가능한 파일은 허용된 프로그램이어야 사용 가능합니다.

&#x20;

<figure><img src="/files/5sxAwZyVIJLxxIqMGXry" alt="" width="375"><figcaption></figcaption></figure>

보안 폴더로 파일을 옮기거나 저장하는 경우 위에 엑서스가 노출된다면 \
Secure Folder의 안내를 확인해 주세요.

<figure><img src="/files/z3wzfZYM6K0aaHOP1ymr" alt="" width="375"><figcaption></figcaption></figure>

1. 허용되지 않은 프로그램이 접근하는 경우, 프로그램 감지 안내 팝업이 노출됩니다.
2. \[허용] 버튼을 눌러 사용하시려는 프로그램을 허용 합니다.
3. 해당 프로그램의 보안폴더 사용을 원치 않는 경우 \[차단] 버튼을 눌러 프로그램 접근을 차단합니다.
4. 허용 또는 차단된 프로그램은 프로그램 필터 설정해서 추가 또는 삭제가 가능합니다.

### 3) 프로그램 필터 설정

1. 메인 화면에서 응용 프로그램 접근 제어 \[접근 관리] 버튼을 선택합니다.
2. PIN 번호 정상 인증 시 '프로그램 필터' 화면이 아래와 같이 노출됩니다.\
   기본적으로 허용된 프로그램을 보여줍니다.

<figure><img src="/files/Qc5btJnRAILMEwWwpk5T" alt=""><figcaption></figcaption></figure>

3. \[추가] 버튼을 선택하여 파일 탐색기에서 실행 파일을 추가 할 수 있습니다.
4. \[삭제] 버튼을 선택하여 등록된 프로그램을 삭제 할 수 있습니다.
5. 프로그램 추가 및 삭제 후 \[저장] 버튼을 선택합니다.
6. 좌측에 \[차단] 탭을 선택하여 차단할 프로그램을 추가하거나 삭제 할 수 있습니다.


---

# 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://key4c.gitbook.io/key4c_sf/manual/agent-demo.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.