# 데스크탑 앱 보안 차단 해결

사내 보안 소프트웨어(백신, 방화벽, 프록시 등)에 의해 라운드HR 데스크탑 앱이 차단될 수 있습니다. 아래 설정을 IT 관리자에게 전달하여 문제를 해결할 수 있습니다.

{% hint style="info" %}
이 가이드는 **IT 관리자** 또는 **보안 담당자**에게 전달하기 위한 문서입니다.
{% endhint %}

***

## 1. 허용 도메인 등록 (방화벽 / 보안 솔루션)

***

사내 방화벽, 프록시, 또는 보안 소프트웨어에서 아래 도메인들의 **HTTPS(443) 아웃바운드** 접근을 허용해주세요.

| 도메인                                       | 용도                    |
| ----------------------------------------- | --------------------- |
| `*.roundhr.com`                           | 라운드 웹 서비스 (앱 화면, API) |
| `roundhr.s3.ap-northeast-2.amazonaws.com` | 앱 자동 업데이트             |

{% hint style="warning" %}
위 도메인이 차단되면 앱 로그인, 데이터 로딩, 자동 업데이트가 정상적으로 작동하지 않습니다.
{% endhint %}

***

## 2. 백신 / 보안 프로그램 예외 등록

***

앱 설치 경로를 백신 및 보안 프로그램의 **예외(신뢰) 목록**에 추가해주세요.

{% tabs %}
{% tab title="Windows" %}

* 아래 경로를 백신 프로그램의 예외 목록에 추가합니다.

```
C:\Users\{사용자명}\AppData\Local\Programs\@rounddesktop-app\
```

{% hint style="info" %}
`{사용자명}`은 Windows 로그인 계정명으로 대체해주세요.
{% endhint %}
{% endtab %}

{% tab title="macOS" %}

* 아래 경로를 보안 프로그램의 예외 목록에 추가합니다.

```
/Applications/roundHR.app
```

{% endtab %}
{% endtabs %}

***

## 3. Windows Defender 예외 확인 (Windows)

***

라운드HR 데스크탑 앱 설치 시 자동으로 Windows Defender 예외가 등록되지만, **사내 보안 정책에 의해 초기화**될 수 있습니다. 아래 단계로 직접 예외를 추가해주세요.

1. **\[Windows 보안]** 앱을 실행합니다.
2. **\[바이러스 및 위협 방지]** > \*\*\[설정 관리]\*\*를 클릭합니다.
3. **\[제외]** 항목에서 **\[제외 추가]** > \*\*\[폴더]\*\*를 선택합니다.
4. 아래 경로를 입력하여 예외 폴더로 등록합니다.

```
C:\Users\{사용자명}\AppData\Local\Programs\@rounddesktop-app\
```

{% hint style="success" %}
예외 등록 후 라운드HR 데스크탑 앱을 **재시작**하면 정상적으로 사용할 수 있습니다.
{% endhint %}

***

## 4. 프록시 환경인 경우

***

사내 프록시를 사용하는 환경에서는 시스템 프록시 설정을 확인해주세요. 라운드HR 데스크탑 앱(Electron 기반)은 **시스템 프록시 설정을 자동으로 따릅니다.**

* 프록시에서 아래 도메인이 **허용 목록**에 포함되어 있는지 확인합니다.
  * `*.roundhr.com`
  * `roundhr.s3.ap-northeast-2.amazonaws.com`
* **SSL 검사**(**SSL Inspection**)를 사용하는 경우, 아래 도메인을 **SSL 검사 예외**로 등록합니다.
  * `*.roundhr.com`
  * `*.amazonaws.com`

{% hint style="warning" %}
SSL 검사 예외가 등록되지 않으면 인증서 오류로 앱이 정상 작동하지 않을 수 있습니다.
{% endhint %}

***

## 자주 발생하는 문제

<details>

<summary>위 설정을 모두 적용했는데도 앱이 실행되지 않아요.</summary>

* 앱을 완전히 종료한 뒤 **재시작**해주세요.
* 보안 프로그램의 **실시간 보호 로그**에서 라운드HR 관련 차단 이력이 있는지 확인해주세요.
* 문제가 지속되면 [라운드HR 고객지원](mailto:support@roundhr.com)으로 문의해주세요.

</details>

<details>

<summary>어떤 보안 프로그램이 차단하는지 모르겠어요.</summary>

* Windows: **이벤트 뷰어** > **Windows 로그** > **응용 프로그램**에서 차단 로그를 확인할 수 있습니다.
* macOS: **시스템 설정** > **개인 정보 보호 및 보안**에서 차단된 앱 목록을 확인해주세요.
* 사내 IT 관리자에게 문의하여 사용 중인 보안 소프트웨어를 확인하는 것이 가장 빠릅니다.

</details>