websec-score-bola-batch
주체, 시간 범위, URL 템플릿, 객체 ID 매개변수별로 집계한 입력 행을 기준선 행위 프로파일과 비교해 판정합니다.
objects 필드에는 주체가 그 시간 범위에 접근한 서로 다른 객체 수가 담겨 있어야 합니다. 임계값은 기준선의 log(1 + 객체 수)에서 구한 exp(평균 + sigma × 표준편차) - 1이며, min-objects보다 작아지지 않습니다. 입력 행에는 프로파일의 키 필드가, 프로파일 행에는 samples, log_objects_avg, log_objects_stddev가 있어야 합니다. 기준선에 없거나 기준선 표본 수가 min-samples보다 적은 행도 버리지 않고 min-objects로 판정합니다.
websec-score-bola-batch baseline=값 [min-objects=값] [sigma=값] [min-samples=값]
- baseline=값
- 필수. 기준선 행위 프로파일 이름. 예: websec-bola-baseline-5m
- min-objects=값
- 선택. bola로 판정하는 데 필요한 시간 범위당 최소 객체 수. 기본값은 10입니다.
- sigma=값
- 선택. 임계값을 로그 스케일에서 기준선 평균보다 표준편차 몇 배 위에 둘지 정합니다. 기본값은 3입니다.
- min-samples=값
- 선택. 기준선 통계를 쓰는 데 필요한 최소 표본 수. 주체별 시간 범위 하나가 표본 하나입니다. 이보다 적으면 min-objects로 판정합니다. 기본값은 30입니다.
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| objects_p99 | 실수 | 기준선 p99 | 기준선의 시간 범위당 객체 수 99백분위. 기준선에 없으면 null |
| objects_max | 64비트 정수 | 기준선 최댓값 | 기준선의 시간 범위당 최대 객체 수. 기준선에 없으면 null |
| samples | 64비트 정수 | 기준선 표본 수 | 기준선을 만든 표본 수. 주체별 시간 범위 하나가 표본 하나입니다. |
| log_objects_avg | 실수 | 기준선 로그 평균 | 기준선의 log(1 + 객체 수) 평균. 기준선에 없으면 null |
| log_objects_stddev | 실수 | 기준선 로그 표준편차 | 기준선의 log(1 + 객체 수) 표준편차. 기준선에 없으면 null |
| threshold | 64비트 정수 | 임계값 | exp(log_objects_avg + sigma × log_objects_stddev) - 1을 올림한 값과 min-objects 중 큰 값. 기준선에 없거나 기준선 표본 수가 min-samples보다 적으면 min-objects |
| z_score | 실수 | 표준 점수 | (log(1 + objects) - log_objects_avg) / log_objects_stddev. 기준선에 없거나 표준편차가 0이면 null. 예: 8.4 |
| verdict | 문자열 | 판정 | objects가 임계값을 넘으면 bola, 아니면 normal |