쿼리 명령어
쿼리 명령어로 텍스트나 로그 레코드를 Starfort로 검사할 수 있습니다. 로그에 개인정보가 남아 있는지 점검하거나, 가드레일에 적용하기 전에 특정 데이터의 판정을 대량으로 확인할 때 사용합니다.
| 명령어 | 형태 | 용도 |
|---|---|---|
starfort-guard | 드라이버 | 텍스트 하나를 검사합니다 |
starfort-guard-batch | 파이프 | 입력 레코드의 text 필드를 하나씩 검사합니다 |
두 명령어 모두 사용할 수 있는 AIM Starfort 접속 프로파일이 하나뿐이면 profile을 생략할 수 있습니다. 여러 개이면 profile로 하나를 지정해야 합니다.
텍스트 검사 - starfort-guard
텍스트 하나를 검사하여 결과 레코드 1건을 출력합니다.
출력 레코드에는 profile, text와 아래 공통 출력 필드가 들어 있습니다.
레코드 검사 - starfort-guard-batch
입력 레코드가 들어오는 대로 text 필드를 하나씩 검사하고, 결과 필드를 붙여 바로 내보냅니다. 다른 필드를 검사하려면 eval로 text에 옮깁니다.
text가 비어 있는 레코드는 검사하지 않고 그대로 내보냅니다- 입력 레코드에 출력 필드와 같은 이름의 필드(예: 방화벽 로그의
action)가 있으면 검사 결과로 덮어씁니다 - 레코드 하나가 API 호출 하나입니다. 큰 테이블은 기간이나 조건으로 입력을 줄인 뒤 연결하십시오
공통 출력 필드
| 필드 | 설명 |
|---|---|
action | PASS, MASK, BLOCK 중 하나. 판정을 받지 못하면 null |
processed_content | MASK 판정일 때의 마스킹된 내용 |
detected_items | 탐지 항목 목록(policy_name, rule_name, mask_word, matched_text, alert_message, action) |
mask_mappings | 마스킹 대응 목록(seq, original_text, masked_text, mask_word, mode) |
request_id | Starfort의 X-Request-ID |
http_status | HTTP 상태 코드 |
latency_ms | 호출 지연 시간(밀리초) |
error | 판정을 받지 못한 경우의 오류 코드와 메시지 |
error가 있는 레코드는 action이 null입니다. 이는 통과가 아니므로, 결과를 필터링할 때 search action == "PASS"처럼 판정을 직접 확인하십시오.
옵션과 출력 필드의 상세 설명은 명령어 매뉴얼의 starfort-guard와 starfort-guard-batch를 참고하십시오.