저장된 및 예약된 검색
검색을 저장하고 선택적으로 예약하기
개요
Panther의 데이터 탐색기 및 검색 에서 동일한 검색을 반복적으로 생성하는 것을 방지하려면 검색을 저장하세요. 또한 데이터 탐색기에서 생성한 검색을 예약하여 규칙에 대해 결과를 실행할 수 있습니다. 이 워크플로에는 다음 기능이 포함됩니다:
저장된 검색 생성, 보존된 검색 식.
예약된 검색 생성, 지정된 간격으로 실행되도록 예약할 수 있는 저장된 검색.
예약된 룰 생성, 예약된 검색과 연결된 디텍션입니다. 검색이 실행될 때마다 반환된 데이터는 디텍션에 대해 실행되며 일치 항목이 발견되면 알러트를 발생시킵니다.
기본적으로 각 Panther 계정은 활성화된 예약된 검색 10개로 제한됩니다. 이 제한은 예방적이며 지원 요청을 통해 증가시킬 수 있습니다. Panther에서 이 제한을 올리는 데 추가 비용은 없지만 처리되는 데이터 양에 따라 데이터베이스 백엔드에서 추가 비용이 발생할 수 있습니다.
에서 CLI 워크플로에서는 저장된 검색 및 예약된 검색을 종종 쿼리라고 합니다.
저장된 검색을 생성하는 방법
저장된 검색은 보존된 검색 식입니다. 팀이 자주 실행하는 검색을 저장하면 중복 작업을 줄이는 데 도움이 됩니다. 저장된 검색은 Panther 콘솔(검색 또는 데이터 탐색기에서), CLI 워크플로(PAT) 또는 Panther API를 사용하여 생성할 수 있습니다.
저장된 검색에 변수를 추가하여 템플릿 쿼리를 만들 수도 있습니다. 자세한 내용은 템플릿 쿼리 및 매크로.
Panther 콘솔에서 저장된 검색을 생성하는 방법
Panther의 데이터 탐색기 또는 검색에서 검색을 저장할 수 있습니다. 두 도구에 저장된 검색은 저장된 검색으로 간주됩니다. 데이터 탐색기에서 검색을 저장하는 방법은 데이터 탐색기에서 검색을 저장하는 방법에 대한 이 지침및 검색에서 검색을 저장하는 방법에 대한 이 지침.
CLI 워크플로에서 저장된 검색을 생성하는 방법
저장된 검색을 로컬에서 작성한다는 것은 자신의 머신에서 SQL 쿼리를 정의하는 파일을 만든 다음 해당 파일을 Panther 인스턴스에 업로드하는 것을 의미합니다(일반적으로 Panther 분석 도구).
로컬 디텍션 파일을 GitHub 또는 GitLab과 같은 버전 관리 시스템에서 관리하는 것을 권장합니다.
Panther의 오픈 소스 분석 리포지토리를 포크하는 것이 모범 사례지만, 새로 리포지토리를 처음부터 생성할 수도 있습니다.
파일 설정
각 저장된 검색은 다음으로 구성됩니다:
YAML 파일 (
.yml또는.json확장자) 에 포함된 저장된 검색의 메타데이터 속성.
폴더 설정
쿼리를 폴더로 그룹화하는 경우 업로드( PAT 또는 콘솔의 대량 업로더 사용 시) 중에 검색을 찾으려면 각 폴더 이름에 queries 가 포함되어야 합니다.
로그/리소스 유형을 기준으로 검색을 폴더로 그룹화하는 것을 권장합니다. 참조용으로 오픈 소스 Panther Analysis 리포를 사용할 수 있습니다.
저장된 검색 작성
저장된 검색 파일(예: new-saved-search.yml)에서 아래 템플릿을 따라 저장된 검색을 작성하세요.
사용 가능한 전체 필드 목록은 저장된 검색 사양 참조.
AnalysisType: saved_query
QueryName: MySavedQuery
Description: PAT용 저장된 쿼리 예시
Query: |-
여기에 쿼리를 입력하세요
Tags:
- 귀하의 태그PAT로 콘텐츠 업로드
PAT 업로드 명령을 사용하세요:
panther_analysis_tool upload --path <path-to-your-search> --api-token <your-api-token> --api-host https://api.<your-panther-instance-name>.runpanther.net/public/graphql값을 다음으로 바꾸세요:
<api-token>: 당신이 생성한 API 키 .<your-panther-instance-name>: 인스턴스의 동화 같은 이름(예: carrot-tuna.runpanther.net).<path-to-your-query>: 로컬 머신에 있는 저장된 검색의 경로.
저장된 검색이 업로드되면 Panther 콘솔에서 일반적으로 입력하는 각 필드가 자동으로 채워집니다. 전체 필수 및 선택 필드 목록은 저장된 검색 사양 참조 를 참조하세요.
Panther API에서 저장된 검색을 생성하는 방법
을 참조하세요,
POST작업을 Queries.
예약된 검색을 생성하는 방법
예약된 검색은 예약에 따라 실행되도록 구성된 저장된 검색입니다. Panther 콘솔을 사용하면 현재 데이터 탐색기에서 생성된 저장된 검색만 예약할 수 있습니다—검색에서 생성된 저장된 검색( SQL 및 PantherFlow) 으로 생성된 검색 포함)은 예약할 수 없습니다. CLI 워크플로나 Panther API를 사용하여 예약된 검색을 생성하고 업로드할 수도 있습니다.
예약된 검색에서 p_occurs_since 를 사용하는 것이 강력히 권장됩니다—아래에서 자세히 알아보세요.
참고: 예약된 검색만 생성한다고 해서 반환된 데이터가 디텍션에 대해 실행되거나 신호가 생성되는 것은 아닙니다. 그렇게 하려면 예약된 룰을 생성하고 이를 예약된 검색과 연결해야 합니다.
고객 구성 Snowflake 계정: 예약된 검색이 실행될 때마다 데이터베이스 백엔드에서 비용이 발생합니다. 검색이 지정된 타임아웃 기간 내에 완료될 수 있는지 확인하세요. 이 내용은 Panther가 관리하는 Snowflake를 사용하는 계정에는 적용되지 않습니다.
데이터 탐색기에서 예약된 검색을 생성하는 방법
데이터 탐색기에서 생성한 저장된 검색을 예약하는 방법을 알아보려면 아래 지침 중 하나를 따르세요:
데이터 탐색기에서 아직 저장된 검색을 생성하지 않았다면, 데이터 탐색기에서 저장된 검색 또는 예약된 검색 생성 지침을 따라 4단계의 예약된 검색 생성 에 주의하세요.
데이터 탐색기에 이미 검색을 저장한 경우, 데이터 탐색기에서 저장된 검색 또는 예약된 검색 업데이트 지침을 따라 6단계에 주의하세요.
CLI 워크플로에서 예약된 검색을 생성하는 방법
예약된 검색을 로컬에서 작성한다는 것은 자신의 머신에서 SQL 쿼리를 정의하는 파일을 만든 다음 해당 파일을 Panther 인스턴스에 업로드하는 것을 의미합니다(일반적으로 Panther 분석 도구).
로컬 디텍션 파일을 GitHub 또는 GitLab과 같은 버전 관리 시스템에서 관리하는 것을 권장합니다.
Panther의 오픈 소스 분석 리포지토리를 포크하는 것이 모범 사례지만, 새로 리포지토리를 처음부터 생성할 수도 있습니다.
파일 설정
각 예약된 쿼리는 다음으로 구성됩니다:
YAML 파일 (
.yml또는.json확장자) 에 포함된 예약된 검색의 메타데이터 속성.
예시 예약된 검색 YAML 파일을 여기에 표시합니다 검색을 폴더로 그룹화하는 경우 각 폴더 이름에.
폴더 설정
가 포함되어야 합니다 queries 가 포함되어야 합니다.
로그/리소스 유형을 기준으로 검색을 폴더로 그룹화하는 것을 권장합니다. 참조용으로 오픈 소스 Panther Analysis 리포를 사용할 수 있습니다.
예약된 쿼리 작성
예약된 검색 파일(예: new-scheduled-search.yml)에서 아래 템플릿을 따라 예약된 검색을 작성하세요.
사용 가능한 전체 필드 목록은 예약된 검색 사양 참조.
PAT로 콘텐츠 업로드
PAT 업로드 명령을 사용하세요:
panther_analysis_tool upload --path <path-to-your-search> --api-token <your-api-token> --api-host https://api.<your-panther-instance-name>.runpanther.net/public/graphql값을 다음으로 바꾸세요:
<api-token>: 당신이 생성한 API 키 .<your-panther-instance-name>: 인스턴스의 동화 같은 이름(예: carrot-tuna.runpanther.net).<path-to-your-query>: 로컬 머신에 있는 저장된 쿼리의 경로입니다.
예약된 검색이 업로드되면 Panther 콘솔에서 일반적으로 입력하는 각 필드가 자동으로 채워집니다. 전체 필드 목록은 예약된 검색 사양 참조 를 참조하세요.
Panther API에서 예약된 검색을 생성하는 방법
을 참조하세요,
POST작업을 Queries.
루크백 창을 정의하기 위해 p_occurs_since 예약된 검색에서 루크백 창을 정의하려면 Panther SQL 매크로를 사용하는 것이 강력히 권장됩니다
p_occurs_since 예약된 검색에서 루크백 창을 정의하려면 Panther SQL 매크로를 사용하는 것이 강력히 권장됩니다예약된 검색이 실행될 때, p_occurs_since.
의 "now" 시간은 실제 현재 시간이 아니라 예약된 시간으로 대체됩니다. 이는 루크백 창을 정확하게 만듭니다. 각 실행에서 검색은 일정에 따라 시간적으로 앞으로 진행합니다.
p_occurs_since 를 사용하면 Snowflake 또는 클라우드 공급자 장애로 인한 중단에 대비할 수 있습니다. 장애로 인해 예약된 검색을 실행할 수 없는 경우 예약된 시간은 앞으로 진행되지 않습니다. 장애가 복구되어 쿼리를 다시 실행할 수 있게 되면 예약된 검색은 현재 일정에 따라 따라잡을 때까지 시간적으로 앞으로 진행합니다. p_occurs_since 예약된 검색 crontab 사용 방법
Panther의 예약된 검색 crontab은 분, 시, 일(월 내), 월, 요일의 다섯 필드로 이루어진 표준 crontab 표기법을 사용합니다. 또한 검색 타임아웃 선택기(현재 최대값은 10분)를 찾을 수 있습니다. 표현식은 UTC로 실행됩니다.
인터프리터는 표준 crontab 표기법의 하위 집합을 사용합니다:
┌───────── 분 (0 - 59)
는 월요일부터 금요일) 또는 쉼표로 구분할 수 있습니다. 예:1-5 의 0,1,4 요일 필드에 입력하면 명령은 일요일, 월요일 및 목요일에만 실행됩니다. 현재는 요일 이름이나 월 이름의 사용을 지원하지 않습니다. crontab을 사용하면 기간 빈도 옵션보다 일정에 대해 더 구체적으로 지정할 수 있습니다:
예약된 검색을 이메일 보고서 생성하도록 구성하는 방법

이메일 보고서는 Panther 버전 1.115부터 오픈 베타로 제공되며 모든 고객이 사용할 수 있습니다. 버그 리포트 및 기능 요청은 Panther 지원 팀에 공유하세요.
예약된 검색이 실행될 때마다 이메일 보고서를 보내도록 구성할 수 있습니다. 이메일 보고서에는 결과 다운로드 링크(결과가 하나 이상인 경우), 데이터 탐색기에서 검색으로 이동하는 링크, 선택적으로 검색 결과가 포함된 CSV 첨부 파일이 포함됩니다. 예약된 검색이 예약된 룰과 연결된 경우 해당 예약된 룰은 반환된 데이터를 평소대로 처리합니다.
이메일 보고서는
[email protected] 에서 발송됩니다.이 주소를 개인 또는 조직의 허용 목록에 추가하여 이메일이 스팸으로 분류되지 않도록 하는 것이 좋습니다.

이메일 보고서에 대한 다음 매개변수가 적용됩니다:
각 이메일 보고서는 최대 10명의 수신자에게 전송될 수 있습니다.
CSV 첨부파일의 최대 크기는 10MB입니다. 쿼리 결과가 커서 CSV가 이 크기를 초과하면 CSV는 이메일에 첨부되지 않습니다.
Panther 인스턴스의 모든 예약된 검색을 합쳐 하루에 최대 20개의 이메일 보고서를 보낼 수 있습니다.
하루에 전송되는 이메일 보고서 수는 예약된 검색이 실행되는 빈도에 따라 달라집니다.
예를 들어 하루에 15개의 이메일 보고서를 보내는 예약된 검색이 하나 있고 하루에 5개의 이메일 보고서를 보내는 다른 예약된 검색이 하나 있다면, 기존 구성의 빈도를 줄이지 않는 한 추가 예약된 검색을 이메일 보고서 생성용으로 구성할 수 없습니다.
이메일 보고서는 예약된 검색에 대해서만 구성할 수 있습니다— 검색 에서 PantherFlow 또는 필터 식 으로 만든 검색은 저장되지만 예약할 수는 없으므로이메일 보고서를 생성하도록 구성할 수 없습니다.
Panther 콘솔에서 예약된 검색을 이메일 보고서 생성하도록 구성하는 방법
지침을 따르고 데이터 탐색기에서 저장된 검색 또는 예약된 검색 생성 이메일로 예약된 검색 결과 토글이 ON 으로 설정되어 있는지 확인하세요..
기존 예약된 검색을 구성하려면 해당 검색의 검색 업데이트 모달에 액세스하려면 저장된 검색의 메타데이터 업데이트 지침을 따르고 토글을 토글이 다음으로 설정하세요: 으로 설정되어 있는지 확인하세요..

이메일 보고서 설정 구성:
수신자: 최대 10명의 수신자를 선택하거나 입력하세요. 드롭다운 목록의 값은 Panther 콘솔의 사용자이지만 추가 이메일 주소를 직접 입력할 수도 있습니다.
이메일에 CSV 데이터 첨부: 쿼리 결과가 포함된 CSV 첨부파일(최대 10MB)을 이메일 보고서에 포함하려면 으로 설정되어 있는지 확인하세요. 토글하세요.
검색이 0개의 결과를 반환해도 이메일 전송: 쿼리 결과가 포함된 CSV 첨부파일(최대 10MB)을 이메일 보고서에 포함하려면 으로 설정되어 있는지 확인하세요. 검색이 0개의 결과를 생성하더라도 이메일 보고서를 전송하려면

CLI 워크플로에서 예약된 검색을 이메일 보고서 생성하도록 구성하는 방법
YAML 파일의 루트 수준에 EmailConfig 객체를 추가하고 수신자, SendEmpty및 PreferAttachment 중첩 필드를 함께 포함하여 예약된 검색을 이메일 보고서용으로 구성할 수 있습니다. 아래의 필드에 대해 더 알아보세요, 예약된 검색 사양 참조.
Panther API에서 예약된 검색을 이메일 보고서 생성하도록 구성하는 방법
을 참조하세요,
POST작업을 Queries.
저장된 검색 및 예약된 검색 사용하기
저장된 검색을 삭제하거나 다운로드하는 방법
저장된 검색은 개별적으로 또는 일괄로 삭제할 수 있습니다. 저장된 검색이 예약되어 있는 경우(즉, 예약된 검색인 경우) 해당 검색을 삭제하려면 연결된 모든 예약된 룰과의 연결을 해제해야 합니다.
Panther 콘솔 왼쪽 탐색 바에서 조사 > 저장된 검색.
을 클릭하세요.
저장된 검색 목록에서 다운로드하거나 삭제하려는 검색을 찾습니다. 각 검색 이름 왼쪽의 체크박스를 선택하세요. 페이지 상단에서 또는 다운로드.

또는 페이지 상단에서삭제
를 클릭하세요.만약또는 다운로드을 클릭했다면, saved_queries.zip 파일이 다운로드됩니다. 만약.

을 클릭했다면,
Panther 콘솔 왼쪽 탐색 바에서 조사 > 저장된 검색.
주의!

모달이 나타납니다. 클릭하세요 확인.
에서 검색 업데이트 예약된 검색 비활성화 방법 비활성화하려는 예약된 검색을 찾은 다음, 해당 타일의 오른쪽 상단에서 점 세 개 아이콘을 클릭하세요. 드롭다운 메뉴에서 검색 메타데이터 편집 양식을 클릭하고 설정

활성 상태입니까? 를 OFF
저장된 검색의 메타데이터 업데이트
로 전환하여 쿼리를 비활성화하세요. 변경 사항을 저장하려면):
Panther 콘솔 왼쪽 탐색 바에서 조사 > 저장된 검색.
쿼리 업데이트

모달이 나타납니다. 클릭하세요 확인.
를 클릭하세요. 검색 업데이트 저장된 검색의 이름, 태그, 설명 및 기본 데이터베이스(및 예약된 검색의 경우 활성 여부, 빈도 및
활성 상태입니까? 검색 업데이트.
이메일 보고서 설정
)을 편집하려면 편집하려는 쿼리를 찾고 해당 타일의 오른쪽 상단에 있는 점 세 개 아이콘을 클릭하세요.
필요에 따라
양식에서 변경하세요.
저장된 검색 검색하기 저장된 검색 페이지에서 다음을 사용하여 쿼리를 검색할 수 있습니다: 쿼리 목록 상단의 검색 표시줄
오른쪽 상단의 날짜 범위 선택기오른쪽 상단의, 검색필터 옵션쿼리가 예약되었는지 여부, 활성 상태, 유형(

네이티브 SQL 오른쪽 상단의 , 또는 검색 및 옵션 PantherFlow 검색
), 또는 최대 100개의 태그로 필터링할 수 있습니다. 저장된 검색 이름을 클릭하면 쿼리가 채워진 상태로 데이터 탐색기(쿼리의 경우) 또는 검색(검색의 경우)으로 바로 이동합니다.예약된 검색에서
저장된 검색 이름을 클릭하면 쿼리가 채워진 상태로 데이터 탐색기(쿼리의 경우) 또는 검색(검색의 경우)으로 바로 이동합니다.예약된 검색에서LIMIT 저장된 검색 이름을 클릭하면 쿼리가 채워진 상태로 데이터 탐색기(쿼리의 경우) 또는 검색(검색의 경우)으로 바로 이동합니다. 사용하기
Panther 데이터 레이크 설정 페이지에서 예약된 검색에 절이 지정되어 있는지 확인하는 설정을 선택적으로 활성화할 수 있습니다. 예약된 검색이 의도치 않게 수천 개의 결과를 반환하여 알러트 지연, 하류 시스템에 대한 서비스 거부(DoS) 및 잘못 조정된 쿼리로 인한 일반적인 정리 오버헤드를 초래할 위험이 있다면 이 옵션을 사용하세요. 타임아웃이 발생한 예약된 검색은 실패했음을 식별하기 위해
시스템 오류 를 생성합니다..

Panther 콘솔 오른쪽 상단에서 톱니바퀴 아이콘을 클릭하세요. 나타나는 드롭다운 메뉴에서 일반 을 클릭하세요.
데이터 레이크 탭을 클릭하세요. 아래로 스크롤하여

예약된 쿼리
저장된 검색 이름을 클릭하면 쿼리가 채워진 상태로 데이터 탐색기(쿼리의 경우) 또는 검색(검색의 경우)으로 바로 이동합니다.헤더를 찾으세요. 헤더 아래에서 LIMIT 절 토글 설정을 볼 수 있습니다: 예약된 쿼리에 대한 으로 설정되어 있는지 확인하세요. 절
설정을 으로 설정되어 있는지 확인하세요.로 전환하여 예약된 쿼리에서 LIMIT를 적용하기 시작하세요.

로 설정되면, 원하는 경우 새로 활성으로 표시된 예약된 검색은 쿼리 정의에 LIMIT 절이 지정되지 않으면 저장할 수 없습니다.

이미지에는 쿼리 생성 화면이 표시됩니다. 상단에 빨간 배너가 있으며 "저장된 쿼리를 생성할 수 없습니다. 이 예약된 쿼리는 SQL 식에 LIMIT 절이 포함되어 있지 않습니다. 이 예약된 쿼리를 저장하려면 SQL 식을 업데이트하여 LIMIT 절을 추가하세요."라는 문구가 있습니다.
LIMIT 절이 없는 기존 예약된 검색은 저장된 검색 목록에 경고 메시지와 함께 표시되며 LIMIT 절을 포함하지 않으면 편집을 저장할 수 없습니다.
이 설정은 저장된 검색 어디에든 LIMIT 절의 존재만 확인합니다. 외부 LIMIT 절을 구체적으로 검사하지는 않습니다.
Panther 콘솔 왼쪽 탐색 바에서 Panther 콘솔에서 예약된 검색 내보내기.
콘솔에 있는 모든 디텍션 및 예약된 검색의 .zip 파일을 내보낼 수 있습니다: 디텍션.
에서 오른쪽 상단에서 업로드 대량 업로더.
저장된 검색 사양 참조
모달을 클릭한 다음 모든 엔터티 다운로드.
를 클릭하세요.
저장된 검색 사양 필드의 전체 목록:
필드 이름
설명
예상 값
AnalysisType
이 분석이 룰, 정책, 예약된 검색, 저장된 검색 또는 전역인지 여부를 나타냅니다.
saved_query
QueryName
UI에 표시할 친숙한 이름입니다.
굵게
문자열
이 분석이 룰, 정책, 예약된 검색, 저장된 검색 또는 전역인지 여부를 나타냅니다.
예약된 검색 사양 참조
모달을 클릭한 다음 모든 엔터티 다운로드.
문자열 목록
저장된 검색 사양 필드의 전체 목록:
필드 이름
룰에 대한 간단한 설명.
예상 값
AnalysisType
이 분석이 룰, 정책, 예약된 검색, 저장된 검색 또는 전역인지 여부를 나타냅니다.
Query
데이터 쿼리입니다. SQL로 작성되어야 합니다(즉,
예약된 검색 사양 필드의 전체 목록:
saved_query
QueryName
UI에 표시할 친숙한 이름입니다.
굵게
문자열
이 분석이 룰, 정책, 예약된 검색, 저장된 검색 또는 전역인지 여부를 나타냅니다.
Tags
scheduled_query
이 분석이 룰, 정책, 예약된 검색, 저장된 검색 또는 전역인지 여부를 나타냅니다.
Enabled
이 룰이 활성화되어 있는지 여부.
불리언
EmailConfig
데이터 쿼리입니다. Schedule 이 쿼리가 실행되어야 하는 일정입니다. CronExpression 또는 Rate Minutes로 표현됩니다. 예상보다 오래 걸릴 경우 쿼리를 해제하기 위해 TimeoutMinutes가 필요합니다. cron과 rate minutes는 상호 배타적입니다.
맵
수신자제공된 경우,예약된 검색에 대한 이메일 보고서 생성
PreferAttachment을 지원합니다. 세 가지 중첩 필드를 지원합니다:(필수): 이메일 보고서를 보낼 각 이메일 주소를 포함하는 문자열 배열입니다. 최대 10명의 수신자가 있습니다.(선택 사항): 기본값이예약된 검색에 대한 이메일 보고서 생성
SendEmpty을 지원합니다. 세 가지 중첩 필드를 지원합니다:(필수): 이메일 보고서를 보낼 각 이메일 주소를 포함하는 문자열 배열입니다. 최대 10명의 수신자가 있습니다.(선택 사항)false
불리언
마지막 업데이트
도움이 되었나요?

