본문 바로가기

보안 설정

보안 설정에서 관리자 접근 IP, 로그인 보호, 새 기기 승인, 관리자 2단계 인증 필수 여부, 일반 API 요청 제한을 설정합니다. 관련 항목을 여덟 카드로 묶어 한 화면에서 변경하고 저장합니다.


시작하기 전에

  • 필요 권한: 보안 설정 권한이 있는 관리자

보안 설정 화면 열기

  1. 관리자 페이지에 접속합니다.
  2. 왼쪽 메뉴에서 보안 관리를 선택합니다.
  3. 보안 설정을 선택합니다.

상단의 메뉴·설정 검색에서 카드나 항목 이름을 검색해 이동할 수도 있습니다. 검색 결과로 이동하면 해당 카드가 펼쳐지고 항목이 잠시 강조됩니다.

보안 설정

카드 오른쪽의 화살표를 선택하면 세부 항목이 열립니다. 접힌 카드에는 현재 설정이 요약됩니다.

카드함께 설정하는 항목
IP 접근 제한관리자 페이지에 접근할 IP 주소와 대역
보안 동작·알림전체 보안 필터와 관리자 알림
로그인 보호실패 횟수·집계 기간·차단 시간과 반복·분산 공격 탐지
새 기기 로그인새 기기의 로그인 허용·알림·승인
관리자 2단계 인증모든 관리자에게 인증 앱 2단계 인증을 필수로 적용할지와 내 2단계 인증 상태
로그인 요청 속도 제한짧은 시간에 몰리는 로그인 요청
일반 API IP별 요청 제한일반 API의 지속 요청 수와 순간 버스트
로그인 예외·공유 네트워크로그인 보호 예외와 여러 사용자가 함께 사용하는 네트워크

IP 접근 제한

관리자 페이지에 접근할 수 있는 IP를 제한합니다. IP 접근 제한 활성화를 켜고 현재 접속 IP가 허용 목록에 있는지 확인합니다. 입력·저장 절차와 주의 사항은 IP 접근 제한을 참고합니다.

이 목록은 로그인 예외 목록과 별개입니다. 화이트리스트 IP에 등록해도 관리자 페이지 접근은 허용되지 않습니다.

보안 동작·알림

전체 보안 필터 기능 사용은 로그인 보안 검사와 자동 차단을 켜거나 끕니다. 기본값은 활성화입니다. 끄면 로그인 실패·로그인 요청 제한·패턴 감지에 따른 차단이 중단됩니다. 실패 기록은 계속 남습니다.

IP 접근 제한, 새 기기 로그인, 일반 API IP별 요청 제한은 이 토글과 관계없이 적용됩니다. 같은 카드에서 관리자 알림도 설정합니다.

항목기본값 · 허용 범위설명
관리자 알림 활성화켜짐보안 이벤트의 관리자 실시간 알림을 켭니다.
알림 임계값50 · 1–100000실패 시간 윈도우 안의 실패 시도가 이 횟수 이상이면 경고 알림을 보냅니다. 같은 경고는 10분 단위로 묶습니다.

자동 차단 알림은 임계값과 관계없이 보냅니다. 새 기기 로그인 알림은 이 알림 설정과 별개입니다.

보안 동작·알림

로그인 보호

실패 횟수와 집계 기간, 차단 시간을 같은 카드에서 설정합니다. 계정 잠금에서 최근 로그인 위치를 제외할지도 함께 정합니다.

항목기본값 · 허용 범위설명
사용자당 최대 실패 시도5 · 1–100같은 계정의 로그인 실패가 기준에 도달하면 계정을 일시적으로 잠급니다.
IP·로그인 ID 조합 실패5 · 1–100같은 IP에서 같은 로그인 ID로 실패한 횟수의 기준입니다.
IP당 최대 실패 시도50 · 10–10000같은 IP 전체의 실패 횟수 기준입니다.
핑거프린트당 최대 실패 시도15 · 1–1000같은 기기 지문의 실패 횟수 기준입니다.
최근 로그인한 곳은 계정 잠금에서 제외 (권장)켜짐최근 로그인에 성공한 IP를 계정 잠금 대상에서 제외합니다. IP·로그인 ID 조합 제한은 계속 적용됩니다.
최근 로그인으로 인정하는 기간 (일)30 · 1–365최근 로그인으로 인정할 기간(일)입니다. 위의 제외 설정을 켜야 입력할 수 있습니다.

실패 집계 기간과 차단 시간

항목기본값 · 허용 범위설명
실패 시간 윈도우60 · 1–1440실패 횟수를 집계할 기간(분)입니다.
차단 시간30 · 1–10080기본 차단 유지 시간(분)입니다. 최대 7일입니다.

로그인 보호

반복 차단·고급 탐지

반복 차단·고급 탐지를 펼치면 누진 차단, 패턴 감지, 여러 IP에서의 로그인 실패 탐지가 표시됩니다. 누진 차단과 패턴 감지는 기본값이 활성화입니다. 각 토글을 끄면 해당 숫자 항목은 비활성화됩니다.

항목기본값 · 허용 범위설명
누진 차단 배수2 · 1–10반복 차단에 적용할 배수입니다. 0.1 단위로 입력합니다.
최대 차단 시간24 · 1–720누진 차단의 최대 유지 시간(시간)입니다. 최대 30일입니다.
의심스러운 패턴 임계값20 · 2–10000같은 IP의 실패가 이 값 이상이고 서로 다른 아이디가 10개를 넘거나 User-Agent가 5개를 넘으면 패턴 차단합니다.
User-Agent당 최대 실패 시도30 · 5–10000같은 User-Agent가 여러 IP에서 실패할 때의 기준입니다.
User-Agent 차단 최소 IP 수3 · 2–1000User-Agent 차단에 필요한 서로 다른 IP 수입니다.

누진 차단은 차단 시간 × 배수^(이전 자동 차단 횟수)로 계산하며 최대 차단 시간을 넘지 않습니다. User-Agent는 브라우저나 앱의 식별 정보이며, 일반 브라우저와 신뢰된 공식 앱은 User-Agent 실패 집계에서 제외됩니다.

반복 차단·고급 탐지 항목

새 기기 로그인

처음 보는 기기에서 로그인할 때의 처리 방법을 선택합니다. 기본값은 통제 안 함입니다.

선택동작
통제 안 함기기 승인 조건을 적용하지 않습니다. 계정 상태와 다른 로그인 보호 조건은 계속 적용됩니다.
허용하고 알림처음 보는 기기에서 로그인하면 허용하되, 관리자 보안 알림과 인증 기록에 남깁니다.
관리자 승인 필요관리자가 승인한 기기만 로그인할 수 있습니다. 미승인 기기는 승인 대기로 접수됩니다.

관리자 승인 필요를 선택하고 상단 오른쪽의 저장으로 적용합니다. 이 방식은 Team 이상에서 선택할 수 있습니다. 요청은 관리자 홈의 지금 처리할 항목과 보안 관리 > 승인 대기 기기에서 승인하거나 거부합니다. 자세한 절차는 승인 대기 기기 처리하기를 참고합니다.

  • 일반 계정은 첫 기기와 화이트리스트 IP에서도 관리자 승인이 필요합니다.
  • 통제 안 함·허용하고 알림에서 자동 등록된 기기도 승인 정책을 켠 뒤에는 관리자 승인을 다시 받아야 합니다.
  • 최고관리자와 전체 관리자는 정책 복구를 위해 기기 승인 대상에서 제외됩니다.
  • 역프록시를 사용한다면 실제 접속 IP가 전달되는지 확인합니다. 접속 IP를 확인할 수 있어도 일반 계정의 기기 승인은 생략되지 않습니다.

새 기기 로그인

관리자 2단계 인증

관리자 2단계 인증 필수를 켜면 모든 관리자 계정이 인증 앱 2단계 인증을 등록해야 합니다. 기본값은 꺼짐입니다. 등록하지 않은 관리자는 로그인 뒤 등록 화면으로 이동하며, 등록을 마칠 때까지 관리자 페이지와 파일, 실시간 연결을 쓸 수 없습니다.

같은 카드의 내 2단계 인증에 현재 계정의 상태가 표시됩니다. 정책을 켜는 관리자가 아직 등록하지 않았다면 먼저 설정 화면 열기로 자기 계정에 등록합니다. 등록 절차와 복구 방법은 관리자 2단계 인증 설정하기를 참고합니다.

로그인 요청 속도 제한

단시간에 몰리는 로그인 요청을 제한합니다. 기본값은 활성화이며, 끄면 이 카드의 숫자 입력이 비활성화됩니다.

항목기본값 · 허용 범위설명
속도 제한 윈도우60 · 1–3600로그인 요청 수를 집계할 기간(초)입니다.
IP·로그인 ID 요청 제한10 · 1–1000같은 IP와 로그인 ID 조합에 허용할 요청 수입니다.
IP 전체 요청 제한120 · 10–10000사내 공용 네트워크로 등록하지 않은 IP 전체에 허용할 로그인 요청 수입니다.

일반 API IP별 요청 제한

파일 WebSocket 연결 요청을 포함한 일반 API 전체의 IP별 처리량을 설정합니다. 로그인 보호와 Webspace 동시 연결 한도와는 독립적입니다.

항목기본값 · 허용 범위설명
초당 지속 요청 수60 · 10–10000한 IP에서 지속적으로 허용할 일반 API 요청 수입니다.
순간 버스트 요청 수300 · 20–100000초기 데이터를 불러올 때 순간적으로 허용할 요청 수입니다. 초당 지속 요청 수 이상으로 설정합니다.

사내 NAT에서는 여러 사용자와 탭의 초기 로딩이 한 IP에서 겹칠 수 있습니다. 순간 버스트를 포함해 설정하고, 실제 피크 트래픽과 HTTP 429 지표를 확인하며 조정합니다.

일반 API IP별 요청 제한

로그인 예외·공유 네트워크

+ IP 주소 추가, + 사용자 추가, + 공용 네트워크 추가로 항목을 추가하고 휴지통 아이콘으로 삭제합니다. IP 주소는 203.0.113.10, 대역은 203.0.113.0/24처럼 CIDR로 입력합니다. 빈 입력줄은 저장할 때 제거됩니다. 아래 기본값은 기본값 복원 기준이며, 이미 저장된 빈 목록이 자동으로 채워지지는 않습니다.

항목기본값 · 허용 범위설명
화이트리스트 IP127.0.0.1, ::1이 주소나 CIDR에서 오는 로그인은 로그인 보호 검사를 건너뜁니다.
화이트리스트 사용자—이 사용자 아이디의 로그인은 로그인 보호 검사를 건너뜁니다.
사내 공용 네트워크—IP 전체 요청 제한과 IP·기기 지문 기준의 실패 제한을 완화합니다. 계정 잠금, IP·로그인 ID 조합, User-Agent, 패턴 감지는 유지됩니다.

사내 공유 IP는 필요한 범위만 사내 공용 네트워크로 등록합니다. 관리자 페이지의 허용 IP 목록은 이 목록과 따로 관리합니다.

로그인 예외·공유 네트워크

저장과 기본값 복원

  1. 상단 오른쪽의 저장을 선택합니다.
  2. 확인 창에서 확인을 선택합니다.
  3. 저장 완료 안내와 변경 사항 표시가 사라졌는지 확인합니다.

카드별 저장 버튼은 없으며, 화면의 변경 사항을 한 번에 저장합니다. 허용 범위를 벗어난 숫자는 입력란 아래에 안내가 표시됩니다. 저장할 때 오류가 발견되면 해당 카드와 고급 항목이 펼쳐지고 수정할 입력란으로 이동합니다.

다른 보안 설정은 저장되고 IP 접근 제한만 저장되지 않으면 부분 저장 안내가 표시됩니다. 이때는 남은 변경 사항을 다시 저장합니다.

기본값 복원을 선택하고 확인하면 화면의 값이 기본값으로 바뀝니다. IP 접근 제한도 꺼지고 허용 목록이 비워집니다. 적용하려면 저장을 선택합니다.

저장하지 않은 변경 사항이 있으면 저장하지 않은 변경사항이 있습니다가 표시됩니다. 이 상태에서 다른 페이지로 이동하면 변경 사항을 버릴지 묻고, 취소하면 현재 값을 유지합니다.

알아두기

  • 실패 횟수 기준이 낮으면 비밀번호를 잊은 사용자도 쉽게 차단됩니다. 최근 로그인한 곳은 계정 잠금에서 제외 (권장)의 적용 범위를 확인합니다.
  • 로그인 예외는 필요한 IP·사용자만 등록합니다. 새 기기 관리자 승인과 관리자 IP 접근 제한은 로그인 화이트리스트로 생략되지 않습니다.
  • 설정을 저장한 뒤 일반 테스트 계정으로 로그인 실패·새 기기 승인·차단 해제가 의도대로 동작하는지 확인합니다.
  • 보안 개요의 보안 진단 실행은 현재 접속 세션 기준의 점검입니다. 일반 계정이나 외부 접속의 동작은 별도로 확인합니다.
  • 이미 차단된 대상은 차단 관리에서 확인하고 해제합니다.

관련 문서