CircleCI로 Panther 콘텐츠 관리하기

CircleCI를 사용한 CI/CD 워크플로로 Panther에서 탐지 콘텐츠 관리하기

개요

CircleCI를 구성하여 테스트를 자동화하고 소스 리포지토리에서 Panther 콘솔로 탐지 파이프라인을 업로드할 수 있습니다.

이 가이드에서는 다음을 설명합니다:

• 리포지토리가 CircleCI를 지원하도록 구성하는 방법.

• CircleCI가 리포지토리에 커밋한 탐지 콘텐츠를 Panther 인스턴스로 자동 업로드하도록 구성하는 방법.

참조 Panther 콘텐츠용 CI/CD Panther로 CI/CD 워크플로를 시작하는 방법에 대한 정보는

CircleCI 설정

CircleCI를 사용하여 탐지 콘텐츠를 Panther 인스턴스에 업로드하려면 리포지토리에 CircleCI 작업을 생성한 다음 Panther API 자격 증명에 대한 환경 변수를 구성합니다.

사전 요구 사항

• Panther 콘솔에서 API 토큰을 생성하세요.

  • 참조 API 토큰 생성에 대한 이 지침.

• 이미 CircleCI 계정이 없는 경우, 무료 계정을 생성하세요.

1단계: 탐지용 리포지토리 설정

• Panther 탐지 콘텐츠용 리포지토리가 아직 설정되어 있지 않다면 하나를 생성하세요. 다음 중 하나를 권장합니다: 비공개로 클론 또는 공개로 포크 Panther의 panther-analysis 리포지토리.

2단계: 리포지토리에 CircleCI 작업 추가

CircleCI가 커밋한 탐지 콘텐츠를 main 브랜치에 대해 panther-analysis 리포지토리에 대해 테스트하고 업로드하려면 CircleCI 작업을 생성해야 합니다.

1. 명령줄에서 로컬 비공개 리포지토리의 루트로 이동하세요: cd path/to/your/repository

2. CircleCI 구성용 새 디렉터리와 새 구성 파일을 생성하세요:

   mkdir .circleci && touch .circleci/config.yml

3. 다음 파일을 열기: config.yml 그리고 다음 내용을 붙여넣으세요:

   version: 2.1
   jobs:
     upload:
       docker:
         - image: 'cimg/python:3.11'
       steps:
         - checkout
         - run:
             name: 가상 환경 설정 및 종속성 설치
             command: make venv
         - run:
             name: 단위 테스트 실행
             command: pipenv run panther_analysis_tool test
         - run:
             name: 탐지 콘텐츠 업로드
             # (선택 사항) 아래 명령에 `--filter Enabled=true`를 추가하면 Enabled된 탐지만 업로드합니다
             command:  |
               PANTHER_API_HOST=$INTERNAL_API_HOST \
               PANTHER_API_TOKEN=$INTERNAL_API_TOKEN \
               pipenv run -- panther_analysis_tool upload
   workflows:
     panther:
       jobs:
         - upload:
             filters:
               branches:
                 only:
                   - main

4. 변경 사항을 추가하고 커밋한 다음 리포지토리에 푸시하세요:

   git add . && git commit -m 'adding initial circleci configuration' && git push

3단계: Panther API 자격증명을 환경 변수로 추가

다음 환경 변수들이 올바른 인증을 위해 설정되어 있는지 확인하세요. PANTHER_API_TOKEN 및 PANTHER_API_HOST 이 올바른 인증을 허용하도록 설정되어야 합니다.

1. 로그인하세요 CircleCI 그리고 프로젝트가 속한 조직을 선택하세요.

2. 왼쪽 탐색 메뉴에서 Projects.

3. 프로젝트 목록에서 해당 panther-analysis 리포지토리를 찾으세요. 프로젝트 오른쪽에서 ... 그런 다음 Project Settings.\

   
4. 왼쪽 탐색 메뉴에서 환경 변수.

5. 클릭하세요 Add Environment Variable그리고 다음을 추가하세요 INTERNAL_API_TOKEN 및 INTERNAL_API_HOST.

   

   • 자세한 내용은 CircleCI 문서의 환경 변수 사용 를 참조하세요.

참고하세요 Panther 분석 도구 명령 Panther 분석 도구에 대한 자세한 내용은.