CircleCI를 통한 Panther 콘텐츠 관리

CircleCI를 사용한 CI/CD 워크플로로 Panther에서 디텍션 콘텐츠를 관리합니다

개요

CircleCI를 구성하여 소스 저장소에서 Panther Console로 디택션 파이프라인을 자동으로 테스트하고 업로드할 수 있습니다.

이 가이드는 다음 방법을 설명합니다:

• CircleCI를 지원하도록 저장소를 구성합니다.

• CircleCI가 저장소에 커밋하는 디택션 콘텐츠를 Panther 인스턴스에 자동으로 업로드하도록 구성합니다.

참고 Panther Content용 CI/CD Panther로 CI/CD 워크플로를 시작하는 방법에 대한 정보는

CircleCI 설정하기

CircleCI를 사용하여 Panther 인스턴스에 디택션 콘텐츠를 업로드하려면, 저장소에 CircleCI 작업을 만들고 Panther API 자격 증명을 위한 환경 변수를 구성해야 합니다.

사전 요구 사항

• Panther Console에서 API 토큰을 생성합니다.

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

• 이미 CircleCI 계정이 없다면, 무료 계정을 만드세요.

1단계: 디택션 저장소 설정

• Panther 디택션 콘텐츠용으로 설정된 저장소가 아직 없다면, 하나 만드세요. 다음 중 하나를 권장합니다 비공개로 복제 또는 공개적으로 포크 Panther의 panther-analysis 저장소.

2단계: 저장소에 CircleCI 작업 추가

CircleCI가 main 브랜치에 커밋하는 디택션 콘텐츠를 테스트하고 업로드하려면 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:
             이름: 가상 환경 설정 및 종속성 설치
             command: make venv
         - run:
             이름: 단위 테스트 실행
             command: pipenv run panther_analysis_tool test
         - run:
             이름: 디택션 콘텐츠 업로드
             # (선택 사항) 아래 명령에 `--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 가 올바른 인증을 허용하도록 설정되었는지 확인합니다.

저장소에 예약된 프롬프트, API 토큰에는 ManageScheduledPrompts 권한(그리고 AIRunAsModify 어떤 프롬프트의 RunAsUser 가 토큰과 다를 경우).

1. 로그인합니다 CircleCI 에 로그인하고 프로젝트가 속한 조직을 선택합니다.

2. 왼쪽 탐색 메뉴에서 프로젝트.

3. 프로젝트 목록에서 저장소를 찾습니다. 프로젝트 오른쪽에서, panther-analysis 저장소를 클릭합니다. 그런 다음 ... 그런 다음 Project Settings.

   
4. 왼쪽 탐색 메뉴에서 Environment Variables.

5. 클릭합니다 Add Environment Variable를 추가하고 INTERNAL_API_TOKEN 및 INTERNAL_API_HOST.

   

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

확인해 보세요 Panther Analysis Tool 명령어 에서 Panther Analysis 도구에 대한 자세한 정보를 확인하세요.