search
Knowledge BaseRelease NotesRequest Demo

Panther API

REST 및 GraphQL API를 사용하여 Panther 엔터티와 상호작용하기

hashtag
개요

Panther는 다음을 제공합니다 REST API 및 GraphQL-over-HTTP API. 다음을 사용할 수 있습니다 API Playground Panther 콘솔에서 두 API를 탐색하려면. API 호출을 하기 전에, 당신은 API 토큰 생성.

다음을 확인하세요 여기에서 REST API 스키마그리고 여기의 GraphQL 스키마.

hashtag
지원되는 작업

Panther API는 보안 워크플로를 구축할 수 있도록 점점 더 많은 작업 집합을 지원합니다:

REST API

GraphQL API

hashtag
Panther API 토큰 생성 방법

circle-info

API 토큰을 성공적으로 생성한 후에는 주기적으로 교체하는 것을 잊지 마세요. 토큰 교체에 대한 지침은 API 토큰 교체아래를 참조하세요.

  1. Panther 콘솔의 오른쪽 상단에서 기어 아이콘을 클릭하세요. 드롭다운 메뉴에서 API 토큰.

  2. 클릭 API 토큰 생성. The image shows the API Tokens page in the Panther Console. The screen says "You haven't created any tokens yet" and there is a red circle around the "Create an API Token" button at the bottom.

    • 이미 토큰이 존재하는 경우 클릭하세요 새 토큰 생성.

  3. 제공하세요 이름(Name), 그런 다음 이 토큰에 부여할 권한을 선택하세요.

  4. 위의 IP 제한 섹션, CIDR 블록 필드에 토큰 사용을 제한하려는 하나 이상의 IP 주소를 입력하세요(있는 경우).

    • IP 주소를 CIDR 표기법으로 입력하세요. 예: 10.0.0.0/8 또는 8.8.8.8/32.

    • IP 주소가 지정되지 않으면 토큰은 모든 IP 주소에서 사용할 수 있습니다.

  5. 클릭 API 토큰 생성.

The image shows the success screen after you create an API Key. At the top, it says "API Key Created". There is a drawing of two people holding up a green checkmark. The API Key in this screen shot is blurred out. Beneath the key there is a blue button labeled "Done."

hashtag
API 토큰을 검증하는 중

circle-info

API 토큰을 추가한 후 전파 지연이 30~60초가 있을 수 있습니다.

API 토큰을 생성한 후에는 API Playground 또는 PAT를 사용하여 정상 작동하는지 확인할 수 있습니다.

Panther 콘솔의 API Playground에서 API 토큰을 테스트하려면:

  1. API 토큰 생성 성공 화면에서 클릭하세요 Playground에서 시도해 보세요.

  2. Playground 화면의 왼쪽 하단에서 다음을 찾으세요 요청 헤더 탭. 이 탭에서 기본값인 X-API-Key 헤더를 <ENTER_YOUR_KEY_HERE> 에서 API 토큰 값으로 변경하세요.

  3. 왼쪽 상단에서 "재생" 아이콘을 눌러 테스트를 실행하세요.

The image shows the API Playground from the Panther Console. At the top, a play icon button is circled. On the left, a code box contains an example query. Beneath that, the header "Request Header" is circled. On the right, there is a section labeled "Documentation Explorer".

hashtag
API 토큰 교체

API 토큰은 Panther의 공개 API에 대한 인증 및 권한 부여에 사용됩니다. 사용자 이름 및 비밀번호 자격 증명과 마찬가지로 API 토큰을 안전하게 보관하여 악의적인 행위자로부터 보호해야 합니다. 토큰을 주기적으로 교체하면 탈취될 가능성을 줄일 수 있습니다. CIS(인터넷 보안 센터)와 NIST(미국 국립표준기술연구소)는 API 토큰을 90일마다 교체할 것을 권장합니다.

Panther 콘솔에서 또는 Panther의 API를 호출하여 API 토큰을 교체할 수 있습니다. 토큰을 교체하면 이전 토큰은 더 이상 유효하지 않습니다.

Panther 콘솔에서 API 토큰 교체

Panther 콘솔에서 API 토큰을 교체하려면:

  1. Panther 콘솔의 오른쪽 상단에서 톱니바퀴 아이콘을 클릭한 다음 API 토큰.

  2. 교체하려는 토큰을 찾으세요. 해당 타일의 오른쪽 상단에서 점 세 개 아이콘을 클릭한 다음 교체.

    The API Tokens page in the Console shows a token called "Example Key." It has info about who created and modified the token, as well as when it expires. The three dot menu is open, and three options are displayed: Edit, Rotate, and Delete.

  3. 팝업되는 확인 모달에서 클릭하세요 계속. A modal titled "Rotate Example Key" asks the user if they're sure they want to refresh the key. There are Cancel and Continue buttons.

  4. 모달에 새 API 토큰이 표시됩니다. 이 화면은 한 번만 보이므로 복사하여 안전한 장소에 저장하세요. The key rotation modal displays the new API token. There is a note saying "Please copy it since we won't show it to you again."

hashtag
Panther API 문제 해결

Panther 지식 기반을 방문하여 Panther API에 대한 문서를 확인하세요arrow-up-right 자주 묻는 질문에 답하고 일반적인 오류 및 문제를 해결하는 데 도움을 줍니다.

PreviousCI/CD 워크플로우로 마이그레이션NextREST API(베타)

Last updated

Was this helpful?