경고 및 오류

Panther API 경고 작업

개요

Panther API는 다음 경고 작업을 지원합니다:

• 선택적 필터로 경고 및 오류 목록 조회

• 특정 경고의 세부 정보 가져오기

• 경고와 연관된 로그 이벤트 가져오기

• 하나 이상의 경고 상태 업데이트

• 경고에 댓글 추가

• 다음 항목을 제공하여 하나 이상의 경고에 사용자 지정 또는 해제:

  • 사용자 ID

  • 사용자 이메일 주소

Console의 API Playground 또는 GraphQL-over-HTTP API를 사용하여 Panther의 API를 호출할 수 있습니다. 이러한 방법에 대해 자세히 알아보려면 Panther API.

아래 섹션에서 GraphQL 쿼리, 뮤테이션 및 핵심 경고 및 오류 작업에 대한 엔드투엔드 워크플로 예제를 참조하세요.

일반적인 경고 및 오류 작업

아래는 Panther에서 가장 일반적인 GraphQL 경고 및 오류 작업의 일부입니다. 이 예제들은 GraphQL 클라이언트(또는)로 전송해야 하는 문서를 보여줍니다. curl)을 사용하여 Panther의 GraphQL API를 호출하기 위해 전송해야 하는 문서를 보여줍니다.

경고 목록 조회

를 입력하세요 경고 쿼리는 다음을 필요로 합니다 입력 다음을 포함하는 객체 createdAtAfter 및 createdAtBefore.

모든 경고의 첫 번째 페이지

# `FirstPageOfAllAlerts`는 작업의 별칭입니다
query FirstPageOfAllAlerts {
    alerts(input: { 
      createdAtAfter: "2022-01-01T00:00:00.000Z"
      createdAtBefore: "2023-01-01T00:00:00.000Z"
    }) {
      edges {
        node { # 여기서 경고 관련 필드를 더 요청할 수 있습니다
          id
          제목
          심각도
          status
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }

다음 페이지의 경고

필터된 경고 페이지

경고 설명

query AlertDetails {
    alert(id: "FAKE_ALERT_ID") {
       id
       제목
       심각도
       status
    }
  }

경고에서 탐지 또는 시스템 오류 정보 가져오기

query AlertDetails {
    alert(id: "FAKE_ALERT_ID") {
       id
       제목
       심각도
       origin {
         ... on Detection {
           id
           name
         }
         ... on SystemError {
           relatedComponent
           유형
         }
       }
    }
  }

경고와 연관된 로그 이벤트 가져오기

query FirstPageOfAlertEvents {
  alert(id: "FAKE_ALERT_ID") {
    id,
    events(input: {
      cursor: "",
      pageSize: 25
    }) {
      edges {
        node
      }
      pageInfo {
        endCursor
      }
    }
  }
}

하나 이상의 경고 상태 업데이트

mutation UpdateAlertStatus {
    updateAlertStatusById(
       input: {
          ids: ["FAKE_ALERT_ID_1","FAKE_ALERT_ID_2"]
          status: CLOSED # 하드코딩된 경우 문자열이 아니라 `enum`임에 유의하세요
       }
    ) {
       alerts {
         id
         status
       }
    }
  }

경고에 댓글 추가

mutation CreateAlertComment {
    createAlertComment(
       input: {
          alertId: "FAKE_ALERT_ID"
          body: "<p>This is HTML</p>"
          format: HTML # HTML 파싱을 비활성화하려면 PLAIN_TEXT로도 설정할 수 있습니다
       }
    ) {
       comment {
         id
       }
    }
 

사용자 ID를 제공하여 하나 이상의 경고에 사용자 지정 또는 해제

mutation UpdateAlertsAssigneeById {
  updateAlertsAssigneeById(
    input: {
      assigneeId: "FAKE_USER_ID"
      ids: ["FAKE_ALERT_ID_1","FAKE_ALERT_ID_2"]
    }
  ) {
    alerts {
      assignee {
        email
        givenName
        familyName
        id
      }
    }
  }
}

사용자 이메일 주소를 제공하여 하나 이상의 경고에 사용자 지정 또는 해제

mutation UpdateAlertsAssigneeByEmail {
  updateAlertsAssigneeByEmail(
    input: {
      assigneeEmail: "[email protected]"
      ids: ["FAKE_ALERT_ID_1","FAKE_ALERT_ID_2"]
    }
  ) {
    alerts {
      assignee {
        email
        givenName
        familyName
        id
      }
    }
  }
}

엔드투엔드 예제

아래에서는 일반 작업 예제를 기반으로 엔드투엔드 흐름을 보여줍니다.

특정 경고 집합을 찾아 다음으로 표시 해결됨:

NodeJS

// npm install graphql graphql-request

import { GraphQLClient, gql } from 'graphql-request';

const client = new GraphQLClient(
  'YOUR_PANTHER_API_URL', 
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } 
});

// `FindAlerts`는 쿼리의 별칭입니다. 완전히 생략할 수 있습니다.
const findAlerts = gql`
  query FindAlerts($input: AlertsInput!) {
  alerts(input: $input) {
    edges {
      node {
        id
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
`;

// `UpdateAlerts`는 쿼리의 별칭입니다. 완전히 생략할 수 있습니다.
const updateAlerts = gql`
  mutation UpdateAlerts($input: UpdateAlertStatusByIdInput!) {
    updateAlertStatusById(input: $input) {
      alerts {
        id
      }
    }
  }
`;

(async () => {
  try {
    
    // 모든 페이지에서 가져온 모든 경고를 보관하는 누산기
    let allAlerts = [];
    // 루프 종료 시점을 알기 위한 도우미
    let hasMore = true;
    // 페이지네이션 커서
    let cursor = null;

    // 더 이상 페이지가 없을 때까지 계속 페이지를 가져옵니다
    do {
      const queryData = await client.request(findAlerts, {
        input: {
          심각도: ["LOW"],
          createdAtAfter: "2022-02-01T00:00:00.000Z",
          createdAtBefore: "2022-03-01T00:00:00.000Z",
          cursor
        }
      });

      allAlerts = [
        ...allAlerts,
        ...queryData.alerts.edges.map((edge) => edge.node)
      ];
      
      hasMore = queryData.alerts.pageInfo.hasNextPage;
      cursor = queryData.alerts.pageInfo.endCursor;
    } while (hasMore);

    // 이제 경고를 업데이트합니다
    if (!allAlerts.length) {
      console.log("해결할 경고를 찾을 수 없습니다");
      return;
    }
    const mutationData = await client.request(updateAlerts, {
      input: {
        ids: allAlerts.map((alert) => alert.id),
        status: "RESOLVED"
      }
    });

    console.log(
      `Resolved ${mutationData.updateAlertStatusById.alerts.length} alert(s)!`
    );
  } catch (err) {
    console.error(err.response);
  }
})();

Python