본문으로 건너뛰기

현장 IP 화이트리스트

빠른 설정

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

현장 IP 화이트리스트는 얼굴 인증과 셀프 체크인을 포함한 현장 체크인 단계를 완료할 수 있는 네트워크를 제어합니다. 키오스크 기반 체크인만 허용하고 원격 체크인을 막고 싶을 때 사용하세요.

찾는 위치​

Settings → Check-In → IP Whitelist

빠른 개요​

설정설명사용 목적
IP Whitelist허용 IP 주소특정 위치에서만 체크인 제한
Current IP현재 접속 IP빠른 추가 참고
CIDR Blocks네트워크 범위여러 장치를 한 번에 허용

게스트 & 직원 영향​

  • 게스트: 다른 네트워크에서는 사전 등록(문서 업로드)만 가능하며, 화이트리스트 네트워크에 연결하거나 호텔 QR 코드를 스캔해야 체크인을 완료할 수 있습니다.
  • 직원: 어떤 키오스크와 네트워크가 체크인을 완료할 수 있는지 통제하여 무단 접근을 줄입니다.

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. 화이트리스트에 추가
  3. 화이트리스트 활성화

✓ 이제 키오스크에서만 체크인 가능

여러 위치​

상황: 로비, 주차장, 비즈니스 센터에 키오스크가 있음.

설정:

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

직원 전용 체크인 단말​

상황: 프런트 데스크 단말기에서만 체크인 허용.

설정:

  1. 프런트 데스크 PC IP 확인
  2. 화이트리스트에 추가
  3. 지정된 단말 사용 교육

호텔 Wi-Fi 네트워크​

상황: 호텔 Wi-Fi에서 어디서든 체크인 가능하게 허용.

설정:

  1. Wi-Fi 네트워크 범위 확인(예: 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단계: 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. 참고용 라벨 입력

3단계: 항목 활성/비활성​

  • Active 토글로 항목별 적용 여부 설정
  • 비활성화된 항목은 목록에 남지만 접근을 제한하지 않음
  • 일시 변경 시 삭제 대신 비활성화 권장

4단계: 변경 사항 저장​

  1. 모든 항목 검토
  2. Save whitelist 클릭
  3. 허용/차단 위치에서 테스트

5단계: 테스트​

허용 위치에서:

  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 할당 정보

일반적인 구성 예시​

시나리오화이트리스트 대상예시
로비 키오스크 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 전체CIDR192.168.0.0/16
원격 사전 체크인 허용비워둠화이트리스트 없음

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

어떤 IP에서도 체크인이 가능하게 하려면:

  1. 모든 IP 항목을 제거(또는 비활성화)
  2. Save whitelist 클릭

✓ 이제 어디서든 셀프 체크인 가능

원격 체크인

집에서 사전 체크인을 허용하려면 화이트리스트를 비워두거나 비활성화하세요.

모범 사례​

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

✅ 사용 권장:

  • 고정된 키오스크 위치가 있음
  • 원격 체크인을 막고 싶음
  • 온프레미스 체크인 규정이 있음
  • 정적 IP 또는 고정된 네트워크가 있음

❌ 비권장:

  • 원격 사전 체크인을 허용해야 함
  • IP가 자주 변경됨
  • 키오스크에 모바일 핫스팟을 사용함
  • 최대 유연성이 필요함

보안 모범 사례​

  • 키오스크/프런트 장치에 정적 IP 사용
  • 적용 전 호텔 Wi-Fi와 키오스크 네트워크 등록
  • 분기별 검토로 폐기 장치/서브넷 정리
  • 여러 장치에는 CIDR 사용
  • 모든 항목에 라벨 지정
  • 운영 적용 전 충분히 테스트

네트워크 아키텍처​

권장 구성:

  1. 키오스크 전용 VLAN
  2. 체크인 단말에 정적 IP
  3. 객실 체크인을 허용한다면 게스트 Wi-Fi 분리
  4. 방화벽 규칙과 화이트리스트 병행

문제 해결​

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

증상: 키오스크에서 체크인이 되지 않음

해결:

  1. 키오스크에서 Current IP 확인
  2. 화이트리스트에 해당 IP가 있는지 확인
  3. IP 오타 여부 확인
  4. Active가 ON인지 확인
  5. Save whitelist 다시 클릭

IP 주소가 계속 바뀜​

증상: 키오스크 IP가 매일/매주 바뀜

원인:

  • DHCP 동적 할당
  • ISP 공인 IP 변경

해결:

  1. IT 담당자 문의
  2. 키오스크용 정적 IP 요청
  3. 정적 IP로 화이트리스트 업데이트
  4. 또는 DHCP 범위에 CIDR 적용

IP 추가 불가​

증상: Save 버튼이 비활성화되거나 오류 발생

확인:

  • IP 형식이 올바른지 (xxx.xxx.xxx.xxx)
  • CIDR 표기가 맞는지 (xxx.xxx.xxx.xxx/xx)
  • 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 아님)
  • 테스트 장치가 범위 안에 있는지
  • Active가 ON인지
  • 저장했는지 확인

다른 보안과 함께 사용​

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

  • 디바이스 지문
  • 세션 타임아웃
  • 사용자 인증
  • 얼굴 인증(화이트리스트는 인증 가능한 위치를 제어)
  • 문서 진위 확인

관련 설정​

도움이 필요하신가요?​

다음 상황이면 success@vouch-technologies.com으로 문의하세요:

  • ❌ 키오스크 IP를 찾을 수 없음
  • ❌ 정적 IP를 요청했는데도 IP가 변경됨
  • ❌ 화이트리스트가 정상 사용자를 차단함
  • ❌ CIDR 설정 도움이 필요함
  • ❌ 네트워크 아키텍처 문의

문의 시 포함하면 좋은 정보:

  • 화이트리스트에 추가하려는 IP/CIDR 목록
  • 네트워크 구성(Wi-Fi, 유선, 모바일)
  • 게스트가 보는 오류 스크린샷
  • 네트워크 다이어그램(가능한 경우)