> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/data_management/security/ip_whitelist.md).

# 허용 IP 설정

## 개요

**허용 IP** 설정을 통해 특정 IP 주소에서만 라운드HR에 접근할 수 있도록 제한합니다. 사무실 네트워크의 IP만 등록하면 외부에서의 비인가 접근을 효과적으로 차단할 수 있습니다.

### 핵심 이점

* **접근 통제:** 허용된 IP에서만 서비스에 접근 가능
* **보안 강화:** 외부 네트워크에서의 비인가 접속 차단
* **유연한 설정:** CIDR 표기법을 지원하여 IP 대역 단위로 관리 가능

## 사전 준비

* **권한:** 관리자
* **플랜:** 엔터프라이즈

***

## 1. 허용 IP 설정하기

***

<figure><img src="/files/ZGoI0KgRloJNBhyf3HqF" alt="보안 설정 화면의 허용 IP 영역. 현재 접속 IP 안내 문구와 [+ IP 추가] 버튼"><figcaption><p>허용 IP 영역과 \[+ IP 추가] 버튼</p></figcaption></figure>

* 상단 메뉴에서 `[설정]` > `[보안 및 데이터]` > `[보안 설정]`으로 이동합니다.
* **허용 IP** 섹션에서 현재 접속 중인 IP 주소를 확인할 수 있습니다.

{% hint style="info" %}
**현재 IP 확인**

허용 IP 섹션 상단에 `(현재 IP: xxx.xxx.xxx.xxx)` 형태로 현재 접속 중인 IP가 표시됩니다. 이 IP를 참고하여 등록하세요.
{% endhint %}

***

## 2. IP 주소 추가하기

***

* `[IP 추가]` 버튼을 클릭하면 새로운 IP 입력 필드가 추가됩니다.
* IP 주소를 입력합니다.
  * **단일 IP:** `192.168.1.100`
  * **IP 대역 (CIDR):** `192.168.1.0/24`
* 여러 IP를 등록하려면 `[IP 추가]` 버튼을 반복하여 클릭합니다.
* 설정을 완료한 후 `[저장]` 버튼을 클릭하여 변경 사항을 반영합니다.

### CIDR 표기법 안내

IP 대역을 한 번에 등록할 때 사용합니다.

| 표기               | 허용 범위                               | 설명      |
| ---------------- | ----------------------------------- | ------- |
| `192.168.1.100`  | 192.168.1.100 (1개)                  | 단일 IP   |
| `192.168.1.0/24` | 192.168.1.0 \~ 192.168.1.255 (256개) | C클래스 대역 |
| `192.168.0.0/16` | 192.168.0.0 \~ 192.168.255.255      | B클래스 대역 |
| `10.0.0.0/8`     | 10.0.0.0 \~ 10.255.255.255          | A클래스 대역 |

{% hint style="warning" %}
**주의사항**

* 허용 IP를 설정하면 **등록되지 않은 IP에서는 접속이 차단**됩니다.
* 반드시 **현재 접속 중인 IP를 포함**하여 등록하세요. 본인의 IP를 등록하지 않으면 저장 즉시 접속이 차단될 수 있습니다.
* VPN을 사용하는 경우 VPN 서버의 IP를 등록해야 합니다.
  {% endhint %}

***

## 3. IP 주소 삭제하기

***

* 삭제할 IP 주소 옆의 `[삭제]`를 클릭합니다.
* `[저장]` 버튼을 클릭하여 변경 사항을 반영합니다.

{% hint style="success" %}
**팁: 모든 IP 허용으로 되돌리기**

등록된 IP를 모두 삭제하고 저장하면, IP 제한 없이 모든 네트워크에서 접근 가능한 상태로 돌아갑니다.
{% endhint %}

***

## 자주 발생하는 문제 (Troubleshooting)

<details>

<summary>허용 IP를 설정한 후 접속이 안 됩니다</summary>

현재 접속 중인 IP가 허용 목록에 포함되어 있는지 확인하세요. 접속이 차단된 경우, 허용된 IP 환경(예: 사무실 네트워크)에서 접속하여 설정을 수정해야 합니다. 해결이 어려운 경우 라운드HR 고객 지원팀에 문의해 주세요.

</details>

<details>

<summary>재택근무 시 접속이 안 됩니다</summary>

허용 IP 설정이 되어 있다면, 재택근무 시 사용하는 IP가 허용 목록에 없을 수 있습니다. 관리자에게 요청하여 해당 IP를 추가하거나, 회사 VPN을 통해 접속하세요.

</details>

<details>

<summary>CIDR 표기법을 어떻게 확인하나요?</summary>

회사 네트워크의 IP 대역은 IT 부서에 문의하면 확인할 수 있습니다. 일반적으로 사무실 네트워크는 `/24` 또는 `/16` 대역으로 설정됩니다.

</details>