본문으로 건너뛰기

현장 IP 화이트리스트

빠른 설정

셀프 체크인을 특정 IP 주소로 제한합니다. 현장 키오스크에서만 체크인을 허용할 때 유용합니다.

얼굴 인증과 셀프 체크인을 포함하여 현장 체크인 단계를 완료할 수 있는 네트워크를 제어합니다. IP 화이트리스트를 사용하면 키오스크 기반 체크인만 허용하려는 경우 게스트의 원격 체크인을 방지할 수 있습니다.

찾는 위치​

Settings → Check-In → IP Whitelist

빠른 개요​

설정제어하는 항목사용 사례
Enable on-property IP whitelist적용 여부를 켜거나 끔일시적으로 모든 네트워크에서 체크인 허용
IP Whitelist허용된 IP 주소특정 위치에서만 체크인하도록 제한
Current IP현재 IP 주소추가할 때 빠르게 확인
CIDR Blocks전체 네트워크 범위여러 장치를 한 번에 화이트리스트에 추가

게스트 및 직원에게 미치는 영향​

  • 게스트: 다른 네트워크의 게스트는 도착 전에 문서를 업로드할 수 있지만, 화이트리스트에 등록된 네트워크에 연결하거나 호텔의 QR 코드를 스캔하기 전에는 체크인을 완료할 수 없습니다.
  • 직원: 체크인을 완료할 수 있는 키오스크와 직원 네트워크를 제어하여 무단 접근을 줄일 수 있습니다.

IP 화이트리스트 동작 방식​

IP 화이트리스트에는 두 가지 계층이 있습니다.

  • 마스터 토글: 해당 시설의 적용을 활성화하거나 비활성화합니다.
  • 항목 토글: 항목을 삭제하지 않고 특정 IP를 켜거나 끕니다.

마스터 토글이 활성화되면:

  • ✅ 허용: 화이트리스트에 등록된 IP에서의 체크인
  • ❌ 차단: 다른 IP에서의 체크인 시도
차단 동작

화이트리스트에 등록되지 않은 IP의 게스트에게는 오류가 표시되며 셀프 체크인을 완료할 수 없습니다.

허용 형식​

IPv4 주소와 CIDR 범위만 지원합니다. IPv4-mapped IPv6 값은 허용되며 IPv4로 정규화됩니다.

형식예시설명
IPv4 Address192.168.1.5특정 장치
CIDR Block10.0.0.0/24전체 서브넷(256개 주소)
CIDR /16 Block192.168.0.0/16대규모 서브넷(65,536개 주소)
IPv4-mapped IPv6::ffff:192.168.1.5IPv4로 정규화됨
IPv4만 지원

현재 IPv4 주소만 지원합니다. IPv6 지원은 추후 제공될 예정입니다.

사용 사례​

키오스크 전용 체크인​

상황: 로비에 전용 키오스크가 있고 게스트가 객실이나 집에서 체크인하는 것을 원하지 않습니다.

설정:

  1. 키오스크의 IP 주소 확인(Current IP 기능 사용)
  2. 키오스크 IP를 화이트리스트에 추가
  3. 화이트리스트 활성화

✓ 이제 키오스크에 있는 게스트만 체크인할 수 있습니다.

여러 위치​

상황: 로비, 주차 구역, 비즈니스 센터에 키오스크가 있습니다.

설정:

  1. 각 위치의 IP 주소 확인
  2. 모든 IP를 화이트리스트에 추가(같은 네트워크에 있다면 CIDR 블록 사용)
  3. 각 위치에서 테스트

직원 전용 체크인 단말​

상황: 프런트 데스크 단말에서만 게스트 체크인을 처리할 수 있어야 합니다.

설정:

  1. 프런트 데스크 컴퓨터의 IP 주소 확인
  2. 화이트리스트에 추가
  3. 지정된 단말 사용 방법을 직원에게 교육

호텔 Wi-Fi 네트워크​

상황: 호텔 Wi-Fi 네트워크 어디에서나 체크인을 허용합니다.

설정:

  1. Wi-Fi 네트워크의 IP 범위 확인(예: 192.168.1.0/24)
  2. CIDR 블록을 화이트리스트에 추가
  3. 호텔 Wi-Fi를 사용하는 게스트는 객실에서도 체크인할 수 있음

IP 화이트리스트 설정​

1단계: IP 주소 확인​

  1. Settings → Check-In → IP Whitelist로 이동

  2. Current IP 표시 확인

  3. 표시된 IP 주소 기록

    ✓ 이 주소는 현재 AVA에 접속할 때 사용 중인 IP 주소입니다.

Current IP 기능

"Current IP" 기능은 현재 IP 주소를 표시하므로, 지금 사용 중인 주소를 쉽게 추가할 수 있습니다.

2단계: 화이트리스트 켜기​

  1. Enable on-property IP whitelist를 찾습니다.

  2. 토글을 On으로 설정합니다.

    ✓ IP 목록과 항목 입력란이 표시됩니다.

3단계: IP 주소 또는 CIDR 블록 추가​

옵션 A: 개별 IP 추가

  1. IP Whitelist 필드에 IP 주소 입력
  2. (선택 사항) 소유자 라벨 추가(예: "Lobby Kiosk 1")
  3. Add IP 클릭

옵션 B: CIDR 블록 추가

  1. CIDR 범위 입력(예: 192.168.1.0/24)
  2. (선택 사항) 소유자 라벨 추가(예: "Front Desk VLAN")
  3. Add IP 클릭

옵션 C: 현재 IP 추가

  1. Add my current IP 버튼 클릭
  2. 시스템이 IP를 자동으로 감지하여 추가
  3. 참고용 라벨 추가

4단계: 항목 활성화/비활성화​

  • Active를 토글하여 각 항목의 적용을 켜거나 끕니다.
  • 비활성화된 항목은 목록에 남아 있지만 접근을 제한하지 않습니다.
  • 항목을 삭제하지 않고 일시적으로 변경할 때 유용합니다.

5단계: 변경 사항 저장​

  1. 모든 화이트리스트 항목 검토
  2. Save whitelist를 클릭하여 업데이트 적용
  3. 허용된 위치와 차단된 위치에서 테스트
저장 전 편집 내용도 표시됩니다

저장하기 전에 여러 항목을 추가, 제거 또는 비활성화할 수 있습니다. Save whitelist를 클릭할 때까지 목록에 모든 편집 내용이 유지됩니다.

6단계: 화이트리스트 테스트​

화이트리스트에 등록된 위치에서:

  1. 체크인 랜딩 페이지 열기
  2. 체크인 시작 시도
  3. ✓ 정상적으로 작동해야 합니다.

화이트리스트에 등록되지 않은 위치에서:

  1. 다른 장치 또는 네트워크 사용
  2. 체크인에 액세스 시도
  3. ✓ 오류 메시지와 함께 차단되어야 합니다.

화이트리스트 관리​

항목 추가​

여러 IP 주소(쉼표로 구분):

192.168.1.10, 192.168.1.11, 192.168.1.12

라벨이 있는 개별 IP:

  • IP: 192.168.1.100 → Label: "Reception Desk 1"
  • IP: 192.168.1.101 → Label: "Lobby Kiosk"
  • IP: 192.168.1.102 → Label: "Parking Kiosk"

네트워크용 CIDR 블록:

  • 192.168.1.0/24 → Label: "Front Desk VLAN"
  • 10.0.0.0/16 → Label: "Hotel Wi-Fi Network"

항목 제거​

  1. 제거할 항목 찾기

  2. Remove 버튼 클릭

  3. Save whitelist 클릭

    ✓ 접근 권한이 즉시 취소됩니다.

일시적 비활성화​

항목을 제거하는 대신 일시적으로 비활성화할 수 있습니다.

  1. Active를 OFF로 전환
  2. Save whitelist 클릭
  3. 항목은 남아 있지만 접근을 제한하지 않음

IP 주소 찾기​

키오스크 장치​

  1. 키오스크 장치에서 웹 브라우저 열기
  2. "what is my ip" 검색
  3. 표시된 공인 IP 주소 기록
  4. 화이트리스트에 추가

사무실 컴퓨터​

Windows:

  1. 명령 프롬프트 열기
  2. ipconfig 입력
  3. "IPv4 Address" 찾기

Mac:

  1. 시스템 환경설정 열기
  2. 네트워크로 이동
  3. 표시된 IP 주소 기록

네트워크 범위(CIDR)​

IT 관리자에게 다음 정보를 요청하세요.

  • 네트워크 범위(예: 192.168.1.0/24)
  • 서브넷 정보
  • 정적 IP 할당

일반적인 구성​

시나리오화이트리스트에 추가할 IP예시
로비 키오스크 1대IP 1개192.168.1.100
여러 키오스크(동일 네트워크)CIDR 블록 1개192.168.1.0/24
키오스크 및 프런트 데스크여러 IP 또는 CIDR192.168.1.0/24, 10.0.5.0/24
호텔 Wi-Fi 네트워크CIDR 블록192.168.0.0/16
원격 사전 체크인 허용비워 둠화이트리스트 없음(공개 액세스)

IP 화이트리스트 비활성화​

모든 IP 주소에서 체크인을 허용하려면:

  1. Enable on-property IP whitelist 토글을 Off로 설정
  2. Save whitelist 클릭

✓ 이제 어디서나 셀프 체크인이 작동합니다.

나중에 사용할 수 있도록 항목 유지

마스터 토글을 끄면 IP 목록은 유지됩니다. 다시 사용할 준비가 되면 토글을 켜세요.

원격 체크인

게스트가 집에서 사전 체크인하도록 하려면 IP 화이트리스트를 비워 두거나 비활성화하세요.

권장 사항​

IP 화이트리스트를 사용할 때​

✅ 다음과 같은 경우 사용하세요:

  • 키오스크 위치가 고정되어 있는 경우
  • 원격 체크인을 방지하려는 경우
  • 규정 준수를 위해 현장 체크인이 필요한 경우
  • 고정 IP 주소 또는 정의된 네트워크가 있는 경우

❌ 다음과 같은 경우 사용하지 마세요:

  • 게스트의 원격 사전 체크인을 허용해야 하는 경우
  • IP가 자주 변경되는 경우
  • 키오스크에 모바일 핫스팟을 사용하는 경우
  • 최대한의 유연성이 필요한 경우

보안 권장 사항​

  • 키오스크와 프런트 데스크 장치에 고정 IP 사용
  • 적용을 활성화하기 전에 호텔 Wi-Fi와 키오스크 네트워크를 화이트리스트에 추가
  • 사용 중지된 장치와 오래된 서브넷을 제거하도록 분기별 검토
  • 여러 장치를 더 쉽게 관리하려면 CIDR 블록 사용
  • 각 IP/범위가 무엇을 나타내는지 알 수 있도록 모든 항목에 라벨 지정
  • 운영 환경에서 활성화하기 전에 철저히 테스트

네트워크 아키텍처​

권장 설정:

  1. 키오스크 전용 VLAN
  2. 모든 체크인 단말에 고정 IP 사용
  3. 게스트 Wi-Fi를 허용하는 경우 게스트 Wi-Fi용 별도 네트워크
  4. IP 화이트리스트를 보완하는 방화벽 규칙

문제 해결​

화이트리스트가 정상 사용자를 차단함​

표시되는 현상: 키오스크의 게스트가 체크인할 수 없음

해결 방법:

  1. 키오스크에서 Current IP 확인
  2. 이 IP가 화이트리스트에 있는지 확인
  3. IP 주소에 오타가 없는지 확인
  4. 항목이 Active로 설정되어 있는지 확인
  5. Save whitelist를 다시 클릭

IP 목록이 표시되지 않음​

표시되는 현상: 토글만 보이고 IP 목록은 보이지 않음

해결 방법:

  1. Enable on-property IP whitelist 켜기
  2. 목록이 표시될 때까지 기다리기
  3. IP를 추가하고 Save whitelist 클릭

이전 화이트리스트 편집 내용이 사라짐​

표시되는 현상: 다른 항목을 편집한 후 새 IP, 제거 또는 토글 변경이 계속 표시되지 않음

해결 방법:

  1. 페이지를 새로 고친 후 Settings → Check-In → IP Whitelist를 다시 엽니다.

  2. 각 변경 사항을 다시 적용합니다.

  3. 모든 변경 사항이 목록에 표시되는지 확인합니다.

  4. 모든 편집 내용을 검토한 후 Save whitelist를 한 번 클릭합니다.

    ✓ 저장된 목록에는 적용한 모든 변경 사항이 포함되어야 합니다.

IP 주소가 계속 변경됨​

표시되는 현상: 키오스크 IP가 매일 또는 매주 변경됨

원인:

  • 동적 IP 할당(DHCP)
  • ISP가 공인 IP를 변경함

해결 방법:

  1. IT 부서에 문의
  2. 키오스크 장치에 고정 IP 요청
  3. 화이트리스트를 고정 IP로 업데이트
  4. 또는 전체 DHCP 범위에 CIDR 블록 사용

IP 주소를 추가할 수 없음​

표시되는 현상: 저장 버튼이 비활성화되거나 오류가 표시됨

확인할 항목:

  • IP 형식이 올바른지 확인(xxx.xxx.xxx.xxx)
  • CIDR 표기가 올바른지 확인(xxx.xxx.xxx.xxx/xx)
  • IP 앞뒤에 공백이 없는지 확인
  • 옥텟 사이에 쉼표가 아닌 마침표(.)를 사용하는지 확인
  • IP가 0.0.0.0 또는 255.255.255.255가 아닌지 확인

Current IP가 표시되지 않음​

표시되는 현상: "Current IP" 필드가 비어 있음

해결 방법:

  1. 페이지 새로 고침
  2. 브라우저 콘솔에서 오류 확인
  3. 브라우저 VPN/프록시 비활성화
  4. 다른 브라우저로 시도

CIDR 블록이 작동하지 않음​

표시되는 현상: 범위 내 장치가 계속 차단됨

확인할 항목:

  • CIDR 표기가 올바른지 확인(예: /24 표기를 사용하고 /255.255.255.0 표기는 사용하지 않는지 확인)
  • IP 범위에 테스트 중인 장치가 포함되는지 확인
  • 항목이 Active로 설정되어 있는지 확인
  • 변경 사항이 저장되었는지 확인

다른 보안 기능과 함께 사용​

IP 화이트리스트는 다음 기능과 함께 작동합니다.

  • 장치 지문 인식
  • 세션 시간 초과
  • 사용자 인증
  • 얼굴 인증(IP 화이트리스트는 인증을 수행할 수 있는 위치를 제어함)
  • 문서 진위 확인

관련 설정​

도움이 필요하신가요?​

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

  • ❌ 키오스크의 IP 주소를 찾을 수 없음
  • ❌ 고정 IP를 요청했는데도 IP가 계속 변경됨
  • ❌ 화이트리스트가 사용자를 잘못 차단함
  • ❌ CIDR 블록 설정에 도움이 필요함
  • ❌ 네트워크 아키텍처에 대한 질문이 있음

다음 정보를 함께 제공하면 도움이 됩니다:

  • 화이트리스트에 추가하려는 IP 주소 또는 CIDR 블록 목록
  • 네트워크 설정(WiFi, 이더넷, 모바일)
  • 게스트에게 표시되는 오류의 스크린샷
  • 네트워크 다이어그램(있는 경우)