# Web Console 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;">**관리자를 위한 웹 콘솔 사용 방법**</mark>에 대한 설명입니다.

***

## 1. Key4C 통합 회원 가입 및 로그인

### **1)  회원가입**

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

1. <https://dev-landing.cloudhsm.kr/login> Key4C 로그인 화면에 접속 후 \[회원가입] 버튼을 선택합니다.
2. 기관, ID(이메일), 비밀번호, 비밀번호 확인란을 입력한 후 가입을 완료합니다.
3. 입력한 이메일로 접속하여 아래와 같이 수신된 메일을 확인합니다.\
   \- ID, 비밀번호, OTP QR 코드

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

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

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

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

### 2) 로그인

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

1. 로그인 화면에서 ID, PW, OTP 번호를 입력 후 \[로그인] 버튼을 선택합니다.
2. 정상 로그인 시 '랜딩 페이지' 화면이 제공됩니다.

### 3) 비밀번호 재설정

<figure><img src="/files/5kCnsMTf3KO5Sxj1AxBF" alt=""><figcaption></figcaption></figure>

1. 로그인 화면에서 \[비밀번호 재설정] 버튼을 선택합니다.
2. 이전에 가입한 정보와 새로운 비밀번호를 입력합니다.
3. 스마트폰에서 이전에 등록한 OTP 계정의 인증번호를 확인 후 입력하고 \[확인] 버튼을 선택합니다.

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

* 정식 버전에서는 비밀번호를 직접 설정하지 않고, OTP 인증 시 임시 비밀번호 발송 기능으로 대체됩니다.
  {% endhint %}

***

## 2. 랜딩페이지 및 서비스 구독

### 1) 랜딩페이지

<figure><img src="/files/8NlWXp7aliwstL0mFoj4" alt=""><figcaption></figcaption></figure>

1. 로그인 완료 시, 랜딩 페이지가 제공됩니다.\
   \- 상단 '**서비스**' 메뉴에서는 Key4C에서 제공하는 다양한 보안 서비스 목록을 확인 할 수 있습니다.\
   \- 상단 '**설정**' 메뉴에서는 기업 내 관리자를 추가하거나 관리할 수 있습니다. \
   &#x20;  <mark style="color:$primary;">Demo 버전에서는 '설정' 메뉴를 생략합니다.</mark>

### 2) 서비스 구독

1. 고객(관리자)은 서비스를 구독 후 사용할 수 있습니다.\
   \-  서비스 목록에서 \[구독] 버튼을 선택하여 서비스를 구독합니다.\
   &#x20;   <mark style="color:$primary;">Demo 버전에서는 '구독' 절차를 생략하고</mark>\
   &#x20;   <mark style="color:$primary;">Secure Folder 서비스를 구독한 것으로 가정합니다.</mark>

***

## 3. Secure Folder 대시보드 이용

### 1) 서비스 시작

1. 랜딩 페이지에서 Secure Folder 서비스의 \[시작] 버튼을 선택하면 **대시보드** 화면이 제공됩니다.
2. 상단 SF(Secure Folder) 메뉴에서는 Agent를 사용할 사용자를 등록하고 관리할 수 있습니다.

<figure><img src="/files/8M507KMNZtnV84jZRaGo" alt=""><figcaption></figcaption></figure>

3. 상단 Guide 메뉴를 선택 시 Secure Folder 서비스를 설명하는 페이지가 제공됩니다.\
   \- 정식 버전에는 웹 콘솔과 Agent의 사용자 매뉴얼이 제공됩니다.

### 2) Agent 사용자 등록

관리자는 웹 콘솔을 통해 Secure Folder Agent를 사용할 사용자를 등록하고 관리합니다.

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

1. 등록할 사용자의 이메일을 입력 후 중복을 확인합니다.

{% hint style="warning" %}
**Q. 사용자를 Key4C 통합 회원으로 가입한 관리자 이메일로 사용해도 되나요?**\
**A. 네, 가능합니다.**

관리자는 웹 콘솔을 통해 **사용자를 관리하는 주체**이며,\
사용자는 본인 PC에서 **Secure Folder Agent를 통해 보안 폴더를 사용하는 주체**입니다.

1인이 Secure Folder를 사용하는 경우, **관리자와 사용자가 동일할 수 있습니다.**

<mark style="color:$danger;">**Demo 버전에서는 회원가입한 관리자를 사용자로 자동 등록하고 있습니다.**</mark> \ <mark style="color:$danger;">**- 웹 콘솔에서 사용한 이메일, 비밀번호, OTP를 동일하게 사용 가능**</mark>
{% endhint %}

2. 키 생성 타입을 선택합니다.&#x20;

{% hint style="info" %}
대부분의 경우 **‘자동 생성’ 방식을 사용**하지만, 기업 인프라 환경에서 **기존에 사용 중인 키를 반드시 활용해야 하거나 외부 키를 가져와야 하는 경우**에는 **수동 생성 방식**을 사용할 수 있습니다.

수동 생성 방식은 **다수의 Component 값을 조합하여 새로운 암호화 키를 생성**하고, 해당 키를 보호하기 위한 **키 암호화 키(KEK, Key Encryption Key)를 HSM에서 생성·관리하여 안전하게 보호하는 기능**입니다.
{% endhint %}

2. Label, 길이(bits) 입력 후 \[생성] 버튼을 선택하여 키를 생성합니다.

### 3) 사용자 상세 정보 조회

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

1. Agent 사용자 관리 메뉴 선택 시 등록한 사용자 목록을 확인할 수 있습니다.
2. 사용자 이메일 영역을 선택하면 사용자 상세정보를 조회할 수 있습니다.

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

3. 사용자 정보, 키 정보, Agent 정보를 확인할 수 있습니다.\
   \- OTP 메일을 재발송하거나 Agent 상태를 변경할 수 있습니다.

### 4) 사용자 상세 기능

#### 4-1) OTP 재발송

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

사용자 상세정보 화면에서 \[사용자 정보, 키 정보, Agent 정보]를 확인할 수 있습니다.\
\- 사용자 정보 : 사용자가 Agent에서 로그인 시 필요한 OTP 계정을 분실한 경우,\
&#x20;  관리자는 해당 사용자의 OTP 계정 QR 코드를 사용자 이메일로 다시 발송할 수 있습니다.

#### 4-2) Agent 상태 변경 및 삭제

<figure><img src="/files/kOy1u3gt35scn9XRvJ4A" alt="" width="297"><figcaption></figcaption></figure>

사용자 상세정보 화면에서 사용자가 이용하는 Agent를 관리할 수 있습니다.

* **등록대기중**: Agent가 아직 사용자 PC에 등록되지 않은 상태
* **초기화**: Agent 초기 설정이 필요한 상태
* **사용중**: Secure Folder Agent가 정상적으로 사용 중인 상태
* **일시중지**: Agent 사용이 일시적으로 중단된 상태
* **삭제**: Agent 정보 삭제 (Agent 삭제 시 사용자 및 키 정보도 함께 삭제됩니다.)   &#x20;

<mark style="color:$primary;">정식 버전에서는 Agent 상태 변경을 고도화할 예정입니다.</mark>&#x20;


---

# 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/web-console-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.