맞춤 액션 만들기
맞춤 통합 빌드에서 Armis 통합의 Ping 액션을 만들었습니다. 이 문서에서는 항목을 보강하는 Armis 통합의 맞춤 액션을 만드는 방법을 설명합니다. Python 및 객체 지향 프로그래밍에 대한 실무 지식이 있다고 가정합니다. 기본 요건은 SDK 문서 및 맞춤 통합 절차를 참조하고 SDK 모듈을 살펴보세요.
맞춤 액션 만들기
맞춤 액션을 만들려면 다음 단계를 따르세요.
- 응답 > IDE로 이동합니다. IDE 페이지가 표시됩니다.
- 새 항목 만들기 를 클릭하고 액션 을 선택합니다. 이름을 입력하고 통합을 선택합니다.
- 만들기 를 클릭합니다. IDE는 코드 주석과 설명이 포함된 새 템플릿을 만듭니다.
Siemplify 액션 객체
Siemplify 액션에는 다음 단계가 필요합니다.
SiemplifyAction클래스에서 객체를 인스턴스화해야 합니다.- 객체는 클래스의
end메서드를 사용하여 출력 메시지와 결과 값을 반환해야 합니다.
결과 값
모든 액션에는 SiemplifyAction의 end 메서드에서 반환된 결과 값을 나타내는 출력 이름 이 있습니다. 기본적으로 is_success이지만 통합 개발 환경 (IDE)에서 변경할 수 있습니다. 액션이 실패할 때 기본 반환 값 을 설정할 수도 있습니다.
예를 들어 액션이 5분 후에 타임아웃되거나 다른 이유로 실패하면,
ScriptResult이 (가) Timeout으로 설정됩니다.
JSON 결과 값
플레이북에서 데이터를 피벗하거나 수동 분석에 유용한 JSON 결과를 추가할 수도 있습니다. 이렇게 하려면 add_result_json
메서드를 SiemplifyAction 결과 속성에서 사용하거나
add_entity_json 메서드를 사용하여 JSON 결과를 항목에 직접 연결합니다.
가져오기 및 상수
`SiemplifyAction` 모듈의 `SiemplifyAction` 클래스는 항상 가져옵니다. 일반적으로 가져오는 항목은 다음과 같습니다.
- 디버깅을 위한
SiemplifyUtils의output_handler - 데이터 변환을 위한
add_prefix_to_dict_keys및convert_dict_to_json_result_dict - 액션이 실행될 항목 유형을 결정하는
EntityTypes
이 액션은 맞춤 통합 절차에서 만든 `ArmisManager` 를 재사용하고 표준 `json` 라이브러리를 가져옵니다.
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.