SOAR 웹훅 설정

다음에서 지원:

웹훅은 조직의 알림을 Google Security Operations SOAR 플랫폼으로 수집하는 간단한 솔루션입니다.

웹훅으로 수집된 알림은 커넥터를 사용하여 수집된 알림과 동일한 정보로 플랫폼에 표시됩니다.

중복 케이스가 생성되지 않도록 동일한 소스의 커넥터 또는 웹훅 중 하나를 사용하는 것이 좋으며 둘 다 사용하는 것은 권장하지 않습니다.

웹훅은 기본 매핑 로직이 필요한 시나리오에 가장 적합하며 커넥터는 고급 및 유연한 매핑에 더 적합합니다.

알림을 수집하도록 웹훅 설정

알림을 수집하도록 웹훅을 설정하려면 다음 단계를 따르세요.

  1. SOAR 설정 > 수집 > 웹훅 으로 이동합니다.
  2. add 수신 웹훅 추가 를 클릭합니다.
  3. 새 웹훅의 이름을 입력하고 환경을 선택합니다.
  4. 저장 을 클릭합니다. 저장하면 새 웹훅이 기본 페이지에 표시됩니다.
  5. 웹훅 URL을 복사하고 나중에 사용할 수 있도록 기록해 둡니다. 소스 플랫폼에 웹훅 대상으로 입력해야 합니다.

데이터 매핑

JSON 샘플을 업로드한 후 데이터 매핑 섹션을 사용하여 소스 JSON의 필드를 Google Security Operations SOAR의 적절한 필드에 매핑할 수 있습니다. 시스템은 원시 JSON을 처리하고 사용자 인터페이스 (UI)를 사용하여 매핑을 설정합니다.

  1. 데이터 매핑 섹션에서 JSON 샘플 업로드 를 클릭합니다. 웹훅에서 전송하는 JSON 페이로드의 대표 샘플을 제공합니다.
  2. Google Security Operations 필드를 JSON 샘플의 해당 필드에 매핑합니다. 예를 들어 필수 StartTime 필드를 매핑하려면 JSON에서 Detections.Last.Update와 같은 타임스탬프 필드를 선택할 수 있습니다.
  3. 표현식 빌더를 사용하여 데이터를 세부적으로 조정합니다. 예를 들어 날짜 형식 함수를 사용하여 타임스탬프를 필요한 Unix epoch 밀리초 형식으로 변환할 수 있습니다. 자세한 내용은 표현식 빌더 사용을 참고하세요.
  4. 표현식 빌더에서 실행 을 클릭하여 매핑을 테스트하고 결과를 확인합니다. 녹색 체크표시는 매핑이 성공했음을 나타냅니다.
  5. 웹훅 JSON 페이로드에는 케이스 생성 및 알림 수집에 필요한 필드가 포함되어야 합니다. 자세한 내용은 웹훅 JSON 스키마 이해를 참고하세요.
  6. 필요한 필드를 모두 매핑한 후 저장을 클릭하고 웹훅을 사용 설정합니다.

매핑 대상 필드 이해

JSON 데이터를 매핑할 때는 Google Security Operations SOAR 내의 표준화된 필드에 매핑합니다. 이러한 필드는 수신 데이터를 정규화하고 구조화하는 데 도움이 되도록 카테고리로 구성됩니다. 데이터 매핑 UI에서 사용할 수 있는 필드는 내부 시스템 온톨로지를 기반으로 합니다. 주요 카테고리는 다음과 같습니다.

  • 항목 필드: 시스템에서 IP 주소, 도메인 이름, 파일 해시, 사용자 이름과 같은 항목을 자동으로 추출하고 모델링할 수 있는 데이터 포인트에 이러한 필드를 사용합니다. 이러한 필드에 매핑하면 알림이 풍부해지고 상관관계 및 피벗이 개선됩니다.
  • 일반 이벤트 필드: 타임스탬프 (StartTime, EndTime), 이벤트 설명 또는 메시지, 기타 일반적인 이벤트 속성과 같은 일반 이벤트 메타데이터에 사용합니다.
  • 기술 및 기기 메타데이터: 보고 기기의 공급업체 및 제품 (DeviceVendor, DeviceProduct), 이벤트 심각도, 기타 유사한 기술 속성과 같은 이벤트 소스에 대한 기술 세부정보에 이러한 필드를 사용합니다.

Google Security Operations SOAR UI의 데이터 매핑 도구 내에서 사용 가능한 필드를 탐색하여 JSON 페이로드의 각 데이터에 가장 적합한 대상 필드를 찾습니다.

웹훅 JSON 스키마 이해

Google Security Operations SOAR에서 알림을 올바르게 수집하고 처리하려면 웹훅 JSON 페이로드가 특정 구조를 따라야 합니다. 다음 표에는 JSON 페이로드에서 예상되는 기본 필드가 자세히 설명되어 있습니다.

기본 케이스 및 알림 필드

이러한 필드는 생성되는 알림 또는 케이스의 최상위 속성을 나타냅니다.

필드 유형 권장 형식 필수 설명 예시
TicketId 문자열 UUID 예
  • SOAR 플랫폼 내 케이스의 내부 전역적으로 고유한 식별자 (GUID)입니다.
  • TicketId의 고유성 요구사항은 조건부이며 DisplayId에 따라 다릅니다.
    • 고유한 DisplayId가 제공되면 TicketId가 고유할 필요가 없습니다.
    • DisplayId가 제공되지 않으면 TicketId가 고유해야 합니다.
  • TicketId는 DisplayId와 동일한 값을 갖는 경우가 많습니다.
 "f7167971-f641-432f-a06f-ebca3caaa9dd"
SourceSystemName 문자열 텍스트 예 원래 알림을 SOAR로 보낸 외부 시스템 (예: SIEM 또는 엔드포인트 탐지 및 대응 (EDR) 시스템)의 이름입니다. "Splunk"
Name 문자열 텍스트 예 케이스의 제목 또는 이름으로, 소스 알림 유형 또는 요약에서 가져오는 경우가 많습니다. "Suspicious Login Attempt"
DeviceVendor 문자열 텍스트 예 알림을 생성한 기기 또는 제품의 공급업체입니다. 이벤트 데이터에서 매핑할 수도 있습니다. "Palo Alto Networks"
RuleGenerator 문자열 텍스트 예 알림을 생성한 소스 시스템 (예: SIEM 상관관계 규칙)의 규칙 이름입니다. "Brute Force Attempt Detected"
StartTime 문자열 또는 정수 Epoch 밀리초 (UTC) 또는 ISO8601 문자열 (예: '2026-04-09T14:30:00Z') 예 케이스에서 가장 오래된 이벤트의 시작 시간입니다. 정수를 제공하는 경우 Unix epoch 밀리초 단위여야 합니다. 1670000000000 또는 "2026-04-09T14:30:00Z"
Environment 문자열 텍스트 아니요 이 알림이 속한 SOAR 환경의 이름입니다. SOAR 설정에 정의된 환경과 일치해야 합니다. "Default Environment"
Description 문자열 텍스트 아니요 케이스 또는 알림에 대한 간략한 설명입니다. "Failed login followed by success from new IP"
DisplayId 문자열 UUID 또는 문자열 아니요
  • SOAR UI 내에서 표시 목적으로 사용되는 식별자입니다.
  • 이 필드는 시스템에서 중복 알림을 감지하기 위해 확인하는 기본 키입니다.
  • DisplayId가 고유하지 않으면 알림이 중복으로 거부됩니다. DisplayId에 대한 이 고유성 검사는 TicketId보다 우선합니다.
  • DisplayId는 TicketId와 동일한 값을 갖는 경우가 많습니다.
 "f7167971-f641-432f-a06f-ebca3caaa9dd"
Reason 문자열 텍스트 아니요 알림이 생성되거나 트리거된 이유입니다. "Unusual file access patterns detected."
DeviceProduct 문자열 텍스트 아니요 알림을 생성한 공급업체의 제품 이름입니다. 이벤트 데이터에서 매핑할 수도 있습니다. "Cortex XDR"
EndTime 문자열 또는 정수 Epoch 밀리초 (UTC) 또는 ISO8601 문자열 (예: '2026-04-09T14:30:00Z') 아니요 케이스에서 가장 최근 이벤트의 종료 시간입니다. 정수를 제공하는 경우 Unix epoch 밀리초 단위여야 합니다. 1670000060000 또는 "2026-04-09T14:31:00Z"
Priority 정수 0~100 아니요 케이스의 우선순위 수준입니다. 제공되지 않으면 기본값은 40입니다. (0~19: 정보 제공, 20~39: 낮음, 40~59: 중간, 60~79: 높음, 80~100: 위험) 80
EventsList 배열 JSON 객체 배열 아니요 소스에서 수신한 대로 하나 이상의 원시 이벤트 객체를 포함하는 배열입니다. 원시 이벤트 데이터 전송을 참고하세요. [ { ... }, { ... } ]
EventProduct 문자열 텍스트 아니요 이벤트를 생성한 제품입니다. "Cortex XDR"
EventName 문자열 텍스트 아니요 이벤트의 제목 또는 이름으로, 소스 알림 유형 또는 요약에서 가져오는 경우가 많습니다. "Suspicious Login Attempt"

원시 이벤트 데이터 전송 - EventsList 배열

이벤트를 나타내는 원시 JSON 페이로드를 EventsList 배열 내에서 소스 시스템에서 가져온 대로 전송해야 합니다. 이 객체는 EventsList 배열의 한 요소입니다. 그런 다음 데이터 매핑 UI를 사용하여 source_ip 및 timestamp와 같은 필드를 매핑합니다.

EventsList 배열의 이벤트 객체 예

{
  "event_id": "9a8b7c-1234-5678",
  "timestamp": "2026-07-01T07:29:50Z",
  "signature": "UserLoginFailed",
  "severity": "Medium",
  "user_name": "administrator",
  "source_ip": "192.168.1.50",
  "destination_ip": "10.0.0.10",
  "domain": "CORP",
  "status": "Failure",
  "Reason": "Wrong Password",
  "EventProduct": "Acme Firewall",
  "EventName": "Failed Login Attempt"
}

주요 고려사항 및 권장사항

  • 타임스탬프: 최상위 수준의 모든 StartTime 및 EndTime 필드에 Unix epoch 밀리초를 정수로 사용합니다. 이벤트 데이터 내에서 타임스탬프를 소스에서 가져온 대로 제공합니다. 데이터 매핑 UI에서 변환합니다.
  • 필수 필드: 필수 열에서 '예'로 표시된 모든 필드가 JSON 페이로드에 있는지 확인합니다.
  • EventsList 배열: 이 배열은 매우 중요합니다. 알림이 단일 이벤트를 나타내더라도 EventsList 배열로 래핑해야 합니다.
  • 데이터 매핑 UI: 웹훅 구성 UI의 데이터 매핑 도구를 사용하여 원시 JSON의 필드를 적절한 Google Security Operations SOAR 필드에 매핑합니다.
  • 고유성: 중복 삭제를 방지하려면 각 새 알림에 대해 DisplayId가 고유해야 합니다. DisplayId가 제공되지 않으면 TicketId가 고유해야 합니다.
  • 테스트: SOAR의 웹훅 구성 페이지 내에서 JSON 샘플 업로드 및 테스트 탭을 사용하여 페이로드 구조와 매핑을 검증합니다.

웹훅 테스트

테스트 탭에서 웹훅의 엔드 투 엔드 기능을 테스트하고 자세한 오류 설명을 볼 수 있습니다.

  1. 테스트 탭에서 웹훅 URL을 복사합니다.
  2. 관련 데이터가 포함된 JSON 파일을 업로드합니다.
  3. 실행 을 클릭합니다. 결과가 출력과 함께 표시됩니다.

CrowdStrike 플랫폼 구성

이 사용 사례에서는 웹훅이 Google SecOps 플랫폼으로 알림 수집을 시작하기 위한 CrowdStrike의 단계를 안내합니다.

  1. CrowdStrike Falcon 대시보드에서 Falcon 스토어로 이동하여 웹훅 부가기능을 설치합니다.
  2. Google SecOps 플랫폼에서 복사한 이름과 웹훅 URL로 웹훅을 구성한 후 저장 을 클릭합니다.
  3. 워크플로 섹션으로 이동합니다.
  4. 워크플로 만들기 를 클릭합니다.
  5. 새 탐지 와 같은 트리거를 선택하고 다음 을 클릭합니다.
  6. 작업 추가 를 선택합니다.
  7. 작업 맞춤설정 섹션의 작업 유형 메뉴에서 알림 을 선택하고 작업 메뉴에서 웹훅 호출 을 선택합니다.
  8. 초기 단계에서 추가한 이름과 필요한 모든 필드를 선택한 후 완료 를 클릭합니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.