REST API(베타)
Panther REST API를 사용하여 Panther 엔터티와 상호작용하기
개요
Panther는 Panther 인스턴스의 특정 부분과 상호작용하기 위한 REST API를 제공합니다. 현재 REST API를 통해 다음 엔티티와 상호작용할 수 있습니다:
추가 작업은 GraphQL API.
Panther REST API 스키마 알아보기
OpenAPI 명세 파일을 다운로드하여 REST API 스키마를 확인하세요:
Panther 콘솔에서 API 플레이그라운드를 탐색하여 API 스키마를 확인할 수 있습니다. 자세한 내용은 API 플레이그라운드.
Panther REST API 사용 방법
1단계: Panther REST API URL 식별
REST API URL을 찾으려면:
Panther 콘솔의 오른쪽 상단에서 톱니바퀴 아이콘을 클릭한 다음 API 토큰페이지 상단에서 API URL.
만약 당신이 AI 분류 내용을 수신하도록 구성할 수 있습니다. 형태로 Panther를 배포한 경우, REST URL은 아래에 표시된 부분이 됩니다:

만약 당신이 Slack Bot 경고 대상 로그/리소스 유형별로 규칙을 폴더로 그룹화하는 것을 권장합니다(예: 셀프 호스팅 형태로 Panther를 배포한 경우, URL은 아래에 표시된 부분(포함하여
/v1):

모든 REST URL은 /public/graphql 로 끝나는 값을 제외한다는 점에 유의하세요.
2단계: API 토큰 생성
참조 API 토큰을 생성하는 방법에 대한 이러한 지침. 각 엔티티 페이지(이 페이지의 하위 항목)에서 각 REST API 작업에 필요한 권한을 확인할 수 있습니다.
3단계: Panther REST API 호출
콘솔의 API 플레이그라운드 로 테스트하는 것 외에도 Swagger, Postman 또는 이 문서를 사용하여 REST API를 호출할 수 있습니다:
REST API에 접근하기 위해 Swagger 사용하기
웹 브라우저에서 Swagger 편집기.
왼쪽의 코드 편집기에 위의 Panther REST OpenAPI 명세 파일( Panther REST API 스키마 알아보기.
오른쪽에서, 아래에 서버 변수에서 사용할 예제 SQL 쿼리를 참조하세요, api_host에서 프로토콜을 제외한(즉,
https://).
를 클릭하세요 권한 부여.

에서 사용 가능한 권한 부여 모달:
다음에 따라 매치 표현식을 닮았습니다:에 API 토큰 값을 입력하세요.
를 클릭하세요 권한 부여.
를 클릭하세요 닫기.

이제 API 호출을 시도할 수 있습니다:
엔드포인트를 선택하고 아래를 향한 화살표를 클릭하여 확장하세요.
를 클릭하세요 시도해 보기.

를 클릭하세요 실행.
REST API에 접근하기 위해 Postman 사용하기
Panther Postman 컬렉션을 가져오고, URL 및 API 변수가 포함된 새 환경을 만든 다음 요청을 시도합니다.
다음을 다운로드하세요
Panther_REST_API_postman_collection.json이 탭 하단의 파일.Postman 애플리케이션에서 파일 > 가져오기.
다음을 선택하세요
Panther_REST_API_postman_collection.json파일을 클릭하세요.다음에 따라 컬렉션에서 이제 Panther Rest API 컬렉션이 표시됩니다.
를 클릭하세요 환경에서 플러스 기호(+).

환경 이름을 입력하세요 — 예: "Panther."
오른쪽 테이블에 다음 두 변수를 입력하세요:
restHost: 현재 값에 전체 Panther REST API URL을 입력하세요.에서 지침을 따라 찾을 수 있습니다.: 현재 값restApiToken 유형 에 Panther API 토큰을 입력하세요. 에서 열에서.\
테스트를 생성(create a test) 우측 상단에서.
비밀
이제 요청을 시도할 수 있습니다:

를 클릭하세요 컬렉션.
오른쪽 상단에서 환경 드롭다운을 클릭하고 이전 단계에서 생성한 환경을 선택하세요. Panther Rest API 컬렉션을 확장한 다음 요청을 선택하세요.
를 클릭하세요 보내기.
REST API에 접근하기 위해 Panther 문서 사용하기
REST API 엔티티 페이지(이 페이지의 하위 항목) 중 하나로 이동하여 수행하려는 작업을 찾으세요.
작업의 오른쪽 하단에서 요청 타일에서 ▶테스트하기.

팝업되는 모달에서 상단에 표시된 엔드포인트에서
{api_host}.
에서 api_host 필드에 2단계에서 식별한 REST API URL(프로토콜 제외, 즉 1단계없이)을 입력하세요.
https://).
에서 인증 섹션에서 인증 유형 드롭다운.
다음에 따라 필요한 인증에서 ApiKeyAuth.

다음에 따라 인증, 이름(Name) 및 매치 표현식을 닮았습니다: 옆의 상자를 체크하면 필드가 채워집니다. 매치 표현식을 닮았습니다:에서 2단계에서 생성한 API 토큰을 입력하세요. 2단계.
에서 변수 섹션에서, 작업에 {id}와 같은 필수 경로 변수가 있는 경우
{id}값을값열의 값을 확인하세요.
에 제공하세요. 쿼리 매개변수 섹션에 값이 있고 이 호출에 적용하려면 오른쪽 열의 체크박스를 클릭하세요.

요청에 요청 본문이 필요하면 본문.
를 클릭하세요 요청 전송.
Last updated
Was this helpful?

