설치 매뉴얼
웹 보안 앱은 웹 서버의 접근 로그에서 API 매개변수를 추출해 봇, 오류, 객체 ID 크롤링을 모니터링하고, 객체 단위 권한 우회(BOLA)를 탐지합니다. 앱은 로그를 직접 수집하지 않고, web 로그 스키마로 이미 수집하고 있는 웹 로그를 읽습니다.
- 웹 로그가 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 |
method | HTTP 메서드 |
path | 요청 경로 |
query | 쿼리 문자열 |
status | 응답 상태 코드 |
user_agent | User-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 에이전트 템플릿 설치 (선택)
- AI 어시스턴트(또는 에이전틱 SOC) 앱의 AI 에이전트 메뉴를 엽니다.
- 에이전트 목록의 템플릿을 누르고 웹 보안 총괄 분석가를 설치합니다. 관리자만 설치할 수 있습니다.
- 하위 에이전트인 웹 경로 프로파일러가 함께 설치됩니다.
설치하면 웹 보안 앱 화면 오른쪽에 AI 어시스턴트 패널을 열 수 있습니다. 패널에서 "web_access 테이블의 URL 템플릿을 등록하고 매개변수 타입을 정해 줘"처럼 요청하면 총괄 분석가가 웹 경로 프로파일러에게 맡겨 템플릿을 등록합니다.
5. BOLA 탐지 켜기
기준선은 URL 템플릿으로 정규화된 과거 30일 웹 로그로 만듭니다. 템플릿을 등록한 뒤 다음을 진행하세요.
- 정책 → 행위 프로파일에서
websec-bola-baseline-5m과websec-bola-baseline-1h의 지금 빌드를 누릅니다. 이후에는 매일 04:00에 자동으로 다시 빌드됩니다. - 빌드가 끝나면 정책 → 배치 탐지에서 다음 두 규칙을 활성화합니다.
| 규칙 | 주기 | 탐지 |
|---|---|---|
| BOLA 객체 열거 의심 (5분) | 5분마다 | 최근 5분의 빠른 객체 열거 |
| BOLA 객체 열거 의심 (1시간) | 매시 정각 | 5분 기준을 피해 천천히 진행하는 객체 열거 |
기준선 빌드는 30일치 웹 로그를 읽으므로 로그가 많으면 오래 걸릴 수 있습니다. 템플릿을 크게 바꾼 뒤에는 기준선을 다시 빌드해야 판정이 맞습니다.
6. 설치 확인
- 웹 모니터링을 열고 테이블과 기간(예: 최근 1시간)을 고릅니다. 봇과 오류 탭에 차트가 그려지면 웹 로그를 읽고 있는 것입니다.
- URL 정규화 → 테스트에서 실제 요청 경로 하나를 입력하고 테스트를 누릅니다. 등록한 템플릿과 매개변수 값이 나오면 노드에 템플릿이 배포된 것입니다.
- 웹 모니터링 → 크롤링 탭에 객체 ID 요청이 보이면, 객체 식별자 매개변수가 제대로 지정된 것입니다.
문제가 발생할 때
| 증상 | 원인 | 조치 |
|---|---|---|
| 웹 모니터링의 테이블 목록이 비어 있음 | web 로그 스키마로 수집하는 수집기가 없음 | 수집기의 로그 스키마를 web으로 지정합니다 |
| 크롤링 탭이 비어 있음 | 객체 식별자 타입 매개변수가 없음 | URL 템플릿의 매개변수 타입을 객체 식별자로 지정합니다 |
| 템플릿을 저장했는데 테스트 결과에 반영되지 않음 | 노드에 아직 배포되지 않음 | URL 정규화 → 동기화 상태에서 상태를 확인하고, 필요하면 재빌드를 누릅니다 |
| 템플릿 추가 버튼이 비활성 | 관리자 권한 없음 | 관리자 계정으로 로그인합니다 |
| BOLA 이벤트가 전혀 생기지 않음 | 배치 탐지 규칙이 비활성이거나 기준선이 빌드되지 않음 | 5단계를 확인합니다 |
| AI 어시스턴트 패널이 보이지 않음 | AI 어시스턴트 또는 에이전틱 SOC 앱이나 라이선스 기능 없음 | 앱과 라이선스를 확인합니다 |