웹 보안

다운로드 0
업데이트 2026. 11. 23.

설치 매뉴얼

웹 보안 앱은 웹 서버의 접근 로그에서 API 매개변수를 추출해 봇, 오류, 객체 ID 크롤링을 모니터링하고, 객체 단위 권한 우회(BOLA)를 탐지합니다. 앱은 로그를 직접 수집하지 않고, web 로그 스키마로 이미 수집하고 있는 웹 로그를 읽습니다.

Note
  • 웹 로그가 web 로그 스키마로 수집되고 있어야 합니다. 모니터링과 탐지는 모두 log schema=web으로 읽은 로그만 봅니다.
  • URL 템플릿을 등록하고 고치려면 관리자 권한이 필요합니다. 일반 사용자는 조회만 할 수 있습니다.
  • AI 패널과 에이전트 템플릿을 쓰려면 AI 어시스턴트 또는 에이전틱 SOC 앱과 해당 라이선스 기능이 필요합니다. 없어도 나머지 기능은 그대로 동작합니다.

순서대로 진행하세요.

1. 웹 로그 수집 확인

웹 로그를 web 로그 스키마로 저장하는 수집기가 있는지 쿼리로 확인합니다.

sonar-loggers | explode log_schemas | search log_schemas == "web" | stats values(name) as loggers by table_name

결과의 table_name이 웹 보안 앱이 다루는 테이블입니다. 결과가 없으면 웹 서버 로그 수집기를 먼저 만들고 로그 스키마를 web으로 지정하세요. web 로그 스키마에는 다음 필드가 있습니다.

필드설명
_time요청 시각
src_ip출발지 IP
methodHTTP 메서드
path요청 경로
query쿼리 문자열
status응답 상태 코드
user_agentUser-Agent
referer레퍼러

web 로그 스키마에는 호스트 필드가 없습니다. 그래서 웹 보안 앱은 테이블 이름을 호스트로 씁니다. 사이트마다 테이블을 나눠 수집하면 사이트별로 URL 템플릿을 따로 관리할 수 있습니다.

2. 앱 설치

앱 스토어에서 웹 보안을 설치합니다.

설치가 끝나면 좌측 메뉴에 웹 모니터링과 URL 정규화가 나타납니다. 첫 기동에서 앱이 다음을 준비합니다.

  • URL 템플릿을 저장할 테이블을 만듭니다.
  • URL 템플릿을 모든 노드에 배포하는 행위 프로파일 websec-path-templates를 만듭니다.
  • BOLA 탐지용 기준선 행위 프로파일 2개와 배치 탐지 규칙 2개를 등록합니다. 배치 탐지 규칙은 비활성 상태로 설치됩니다.

URL 정규화 → 동기화 상태에서 상태가 표시되면 준비가 끝난 것입니다.

3. URL 템플릿 등록

BOLA 탐지와 크롤링 모니터링은 URL 템플릿에 객체 식별자로 지정한 매개변수만 봅니다. 템플릿이 없으면 웹 모니터링의 봇, 오류 탭만 동작합니다. 템플릿은 두 가지 방법으로 등록합니다.

  • 직접 등록: URL 정규화 → URL 템플릿 → 템플릿 추가에서 호스트(테이블 이름), 메서드, path 템플릿, 매개변수 타입을 입력합니다. 자세한 내용은 사용 매뉴얼의 URL 정규화를 참고하세요.
  • AI 에이전트로 등록: AI 어시스턴트 또는 에이전틱 SOC 앱이 있으면, 웹 경로 프로파일러 에이전트가 웹 로그를 조사해 템플릿과 매개변수 타입을 등록합니다. 아래 4단계를 먼저 진행하세요.

4. AI 에이전트 템플릿 설치 (선택)

  1. AI 어시스턴트(또는 에이전틱 SOC) 앱의 AI 에이전트 메뉴를 엽니다.
  2. 에이전트 목록의 템플릿을 누르고 웹 보안 총괄 분석가를 설치합니다. 관리자만 설치할 수 있습니다.
  3. 하위 에이전트인 웹 경로 프로파일러가 함께 설치됩니다.

설치하면 웹 보안 앱 화면 오른쪽에 AI 어시스턴트 패널을 열 수 있습니다. 패널에서 "web_access 테이블의 URL 템플릿을 등록하고 매개변수 타입을 정해 줘"처럼 요청하면 총괄 분석가가 웹 경로 프로파일러에게 맡겨 템플릿을 등록합니다.

5. BOLA 탐지 켜기

기준선은 URL 템플릿으로 정규화된 과거 30일 웹 로그로 만듭니다. 템플릿을 등록한 뒤 다음을 진행하세요.

  1. 정책 → 행위 프로파일에서 websec-bola-baseline-5m과 websec-bola-baseline-1h의 지금 빌드를 누릅니다. 이후에는 매일 04:00에 자동으로 다시 빌드됩니다.
  2. 빌드가 끝나면 정책 → 배치 탐지에서 다음 두 규칙을 활성화합니다.
규칙주기탐지
BOLA 객체 열거 의심 (5분)5분마다최근 5분의 빠른 객체 열거
BOLA 객체 열거 의심 (1시간)매시 정각5분 기준을 피해 천천히 진행하는 객체 열거

기준선 빌드는 30일치 웹 로그를 읽으므로 로그가 많으면 오래 걸릴 수 있습니다. 템플릿을 크게 바꾼 뒤에는 기준선을 다시 빌드해야 판정이 맞습니다.

6. 설치 확인

  1. 웹 모니터링을 열고 테이블과 기간(예: 최근 1시간)을 고릅니다. 봇과 오류 탭에 차트가 그려지면 웹 로그를 읽고 있는 것입니다.
  2. URL 정규화 → 테스트에서 실제 요청 경로 하나를 입력하고 테스트를 누릅니다. 등록한 템플릿과 매개변수 값이 나오면 노드에 템플릿이 배포된 것입니다.
  3. 웹 모니터링 → 크롤링 탭에 객체 ID 요청이 보이면, 객체 식별자 매개변수가 제대로 지정된 것입니다.

문제가 발생할 때

증상원인조치
웹 모니터링의 테이블 목록이 비어 있음web 로그 스키마로 수집하는 수집기가 없음수집기의 로그 스키마를 web으로 지정합니다
크롤링 탭이 비어 있음객체 식별자 타입 매개변수가 없음URL 템플릿의 매개변수 타입을 객체 식별자로 지정합니다
템플릿을 저장했는데 테스트 결과에 반영되지 않음노드에 아직 배포되지 않음URL 정규화 → 동기화 상태에서 상태를 확인하고, 필요하면 재빌드를 누릅니다
템플릿 추가 버튼이 비활성관리자 권한 없음관리자 계정으로 로그인합니다
BOLA 이벤트가 전혀 생기지 않음배치 탐지 규칙이 비활성이거나 기준선이 빌드되지 않음5단계를 확인합니다
AI 어시스턴트 패널이 보이지 않음AI 어시스턴트 또는 에이전틱 SOC 앱이나 라이선스 기능 없음앱과 라이선스를 확인합니다