웹 보안

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

AI 에이전트

웹 보안 앱은 AI 에이전트 템플릿 두 개를 제공합니다. 웹 보안 총괄 분석가가 요청을 받고, URL 템플릿 등록은 하위 에이전트인 웹 경로 프로파일러에게 맡깁니다.

Note
AI 에이전트를 쓰려면 AI 어시스턴트 또는 에이전틱 SOC 앱과 해당 라이선스 기능이 필요합니다.

템플릿 설치

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

템플릿은 관리자만 설치할 수 있습니다. 앱을 업데이트해도 이미 설치한 에이전트는 바뀌지 않습니다. 최신 정의로 바꾸려면 에이전트를 삭제한 뒤 다시 설치하세요.

AI 어시스턴트 패널

에이전트를 설치하면 웹 보안 앱 화면 오른쪽에서 AI 어시스턴트 패널을 열 수 있습니다. 패널은 웹 보안 총괄 분석가와 대화합니다. 웹 모니터링을 보면서 바로 질문할 수 있습니다.

웹 보안 총괄 분석가

요청을 둘 중 하나로 판단해 처리합니다.

  • 프로파일링: URL 템플릿을 등록하거나 고치고, 매개변수 타입을 정합니다. 직접 하지 않고 웹 경로 프로파일러에게 맡깁니다.
  • 이상징후 분석: 이미 쌓인 웹 로그에서 봇, 오류, 객체 ID 크롤링, 객체 열거(BOLA), 매개변수 이상을 직접 조사합니다. 결론에는 의심 주체마다 근거와 권고를 적습니다.

요청에 테이블이나 기간이 없으면, web 로그 스키마로 수집하는 테이블 목록을 보여 주고 고르게 합니다.

요청 예

  • web_access 테이블의 URL 템플릿을 등록하고 매개변수 타입을 정해 줘
  • 최근 1시간 web_access에서 객체 열거가 의심되는 IP를 찾아 줘
  • 어제 오류가 많았던 IP가 무엇을 했는지 분석해 줘

웹 경로 프로파일러

웹 로그를 조사해 URL 템플릿과 매개변수 타입을 등록합니다. 다음 단계를 반복합니다.

  1. 호스트, 메서드, 경로별 요청 수를 봅니다.
  2. 요청이 많은 고정 경로와 정적 리소스 디렉터리를 먼저 등록합니다.
  3. 등록된 템플릿으로 정규화되지 않은 요청만 남겨 경로 형태(숫자, UUID 등을 토큰으로 바꾼 경로)별로 묶습니다.
  4. 상위 경로 형태마다 실제 경로를 보고, 의미 있는 이름의 자리표시자로 템플릿을 등록합니다.
  5. 정규화된 요청 비율(커버리지)이 목표에 이를 때까지 3~4를 반복합니다.
  6. 매개변수마다 값 수, 주체 수, 주체당 값 수, 4xx 비율, 값 길이를 보고 타입과 길이 범위를 정합니다.
  • 응답이 대부분 404인 경로, .php, /.env, /.git/ 같은 스캐닝 노이즈는 등록하지 않습니다.
  • 등록과 삭제는 승인 없이 바로 저장됩니다. 잘못 묶인 템플릿을 삭제할 때는 결과에 근거를 남깁니다.
  • 결과로 추가, 갱신, 삭제한 템플릿 수, 커버리지, 객체 식별자로 지정한 매개변수와 근거, 남은 미등록 경로를 돌려줍니다.

총괄 분석가를 거치지 않고 웹 경로 프로파일러를 직접 실행할 때는 다음 입력을 줍니다.

입력설명
요청무엇을 할지. 예: web_access의 URL 템플릿을 등록해 줘
웹 로그 조회 쿼리조사할 로그. 예: log schema=web duration=7d source="수집기 GUID"
대상 호스트테이블 이름
목표 커버리지기본 0.98
주체 필드기본 src_ip. 로그에 사용자 ID나 세션 ID가 있으면 그 필드를 씁니다

에이전트가 쓰는 쿼리 명령어

명령어용도
websec-path-templates등록된 템플릿 조회
websec-add-path-template-batch입력 행의 템플릿 등록과 갱신
websec-remove-path-template-batch입력 행의 템플릿 삭제
websec-normalize-path-batch요청 경로를 템플릿으로 정규화
websec-parse-query-params-batch쿼리 문자열을 키와 값으로 분해
websec-extract-params-batch정규화한 요청을 매개변수마다 한 행으로 출력
websec-classify-user-agent-batchUser-Agent를 브라우저와 봇 종류로 분류
websec-score-bola-batch기준선과 비교한 BOLA 판정

각 명령어의 옵션과 출력 필드는 앱의 명령어 탭을 참고하세요.