REST API
Panther REST API를 사용하여 Panther 엔터티와 상호 작용하기
개요
Panther는 Panther 인스턴스의 일부와 상호작용할 수 있는 REST API를 제공합니다. 현재 REST API를 통해 다음 엔터티와 상호작용할 수 있습니다:
추가 작업은 다음에서 사용할 수 있습니다 GraphQL API.
Panther REST API 스키마를 확인해 보세요
다음 OpenAPI 사양 파일을 다운로드하여 REST API 스키마를 확인할 수 있습니다:
Panther Console의 API Playground를 탐색하여 API 스키마를 확인할 수 있습니다. 자세한 내용은 다음을 참조하세요. API 플레이그라운드.
Panther REST API 사용 방법
1단계: Panther REST API URL 식별
REST API URL을 찾으려면:
Panther Console의 왼쪽 탐색 모음 하단에서 설정를 클릭한 다음 개발자 도구 > API 토큰. 페이지 상단에서 다음을 확인하세요 API URL.
Panther를 실행 중인 SaaS 배포의 REST URL은 아래에 표시된 부분이 됩니다:

Panther를 실행 중인 Cloud Connected 또는 자체 호스팅 Panther 배포의 URL은 아래에 표시된 부분(다음을 포함)입니다:
/v1):

모든 REST URL에는 /public/graphql 가 끝부분에 포함되지 않는다는 점에 유의하세요.
2단계: API 토큰 생성
참고 API 토큰 생성 방법에 대한 이 지침. 각 엔터티 페이지(이 페이지 아래에 중첩됨)에서 각 REST API 작업에 필요한 권한을 찾을 수 있습니다. 다음을 참조하세요. 콘솔 및 API의 권한 이름 에서 추가 정보를 확인하세요.
3단계: Panther REST API 호출
다음을 사용한 테스트 외에도 API 플레이그라운드 콘솔에서 Swagger, Postman 또는 이 문서를 사용하여 REST API를 호출할 수 있습니다:
Swagger를 사용하여 REST API에 액세스하기
웹 브라우저에서 다음으로 이동하세요. Swagger Editor.
왼쪽 코드 편집기에 위에서 찾은 Panther REST OpenAPI 사양 파일을 붙여넣습니다. 위치는 Panther REST API 스키마를 확인해 보세요.
오른쪽에서, 아래의 서버 변수에서 사용할 예제 SQL 쿼리를 참조하세요. api_host, 프로토콜을 제외한 Panther REST API URL을 입력합니다(즉, 다음을 제외하고
https://).
클릭합니다 권한 부여.

다음 사용 가능한 인증 모달:
아래 값, API 토큰 값을 입력합니다.
클릭합니다 권한 부여.
클릭합니다 닫기.

이제 API 호출을 시도할 수 있습니다:
엔드포인트를 선택한 다음, 아래쪽 화살표를 클릭하여 확장합니다.
클릭합니다 직접 사용해 보기.

클릭합니다 실행.
Postman을 사용하여 REST API에 액세스하기
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을 입력합니다.이 값은 다음의 지침을 따르면 찾을 수 있습니다 1단계: Panther REST API URL 식별.
restApiToken: 현재 값, Panther API 토큰을 입력합니다. 유형 열에서 선택합니다 secret.
오른쪽 상단에서 다음을 클릭하세요: 저장.
이제 요청을 시도할 수 있습니다:
오른쪽 위 모서리에서 환경 드롭다운을 클릭하고 이전 단계에서 만든 환경을 선택합니다.

클릭합니다 컬렉션.
다음을 확장합니다 Panther Rest API 컬렉션을 선택한 다음 요청을 선택합니다.
클릭합니다 보내기.
Panther 문서를 사용하여 REST API에 액세스하기
이 페이지 아래에 중첩된 REST API 엔터티 페이지 중 하나로 이동하여 수행하려는 작업을 찾습니다.
작업의 오른쪽 하단 모서리에서 요청 타일을 클릭하세요: ▶ 테스트해 보기.

표시되는 엔드포인트 상단의 모달에서
{api_host}.
다음 api_host 필드에 REST API URL을 입력합니다. 3단계에서 식별한 값으로, 1단계, 프로토콜을 제외한 (즉, 다음을 제외하고
https://).
다음 인증 섹션에서 인증 유형 드롭다운을 클릭합니다.
아래 필수 인증, 다음 옆의 상자를 선택합니다 ApiKeyAuth.

아래 인증, 이름 및 값 필드가 채워집니다. 값에 API 토큰을 입력합니다. 2단계.
다음 변수 섹션에서 작업에 필요한 경로 변수가 있으면, 예를 들어
{id}, 다음의 값(들)을 제공합니다.값열.
값이 쿼리 매개변수 섹션에 있으면, 이 호출에 적용하려면 오른쪽 열의 확인란을 클릭합니다.

요청 본문이 요청에 필요하면, 다음 안에 내용을 추가하세요 본문.
클릭합니다 요청 보내기.
마지막 업데이트
도움이 되었나요?

