퍼블릭 포크

Panther가 관리하는 Python 디텍션을 귀하의 CI/CD 워크플로우 의 공개 포크를 생성하는 것입니다 panther-analysis.

조직에서 디텍션 컨텐츠를 공개적으로 공유하거나 컨텐츠를 업스트림으로 가져오려는 경우 공개 포크를 권장합니다 panther-labs/panther-analysis.

레포의 비공개 클론 생성에 대한 정보는 을 참조하십시오 비공개 클론.

새로운 태그된 릴리스가 있을 때 panther-analysis에서 업스트림 변경사항을 가져오는 것이 권장됩니다. 또한 main 브랜치에서 가져올 수도 있습니다. 다른 브랜치는 안정적이라고 간주해서는 안 됩니다.

panther-analysis의 공개 포크 구성

이 과정은 의 공개 포크를 생성합니다 panther-analysis 조직의 저장소. 이는 귀하의 작업 사본으로 사용됩니다 panther-analysis이며 조직에서 필요한 모든 변경 사항은 여기에서 수행할 수 있고 정의한 구성된 CI 검사들을 거치게 됩니다.

참조용으로, 을 참조하십시오 레포를 포크하는 것에 대한 GitHub의 완전한 지침은 여기.

1. GitHub에 로그인하고 로 이동합니다 panther-labs/panther-analysis.

2. 저장소 메인 페이지의 오른쪽 상단에서 를 클릭합니다 포크.

3. 페이지에서 새 포크 생성 페이지:

   1. 의 선택을 해제하세요 다음 값을 복사하세요 develop 브랜치 전용 상자.

   2. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 포크 생성.

4. 콘솔로. 설정 포크된 저장소의 페이지.

5. 내에서 기본 브랜치, 기본 브랜치를 편집하려면 연필 아이콘을 클릭하세요.

   1. 일반 구성 기본 브랜치를 다른 브랜치로 전환 팝업 모달에서, 선택: main.

   2. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. 업데이트.

6. (선택 사항) 사용자 정의 디텍션 중 일부를 포크된 버전의 동일한 디렉터리에 압축 해제하세요 panther-analysis.

업스트림 panther-analysis 업데이트와 공개 포크를 동기화 상태로 유지하기

업스트림 변경사항과 동기화를 유지하려면, Sync Panther Analysis from Upstream GitHub Action을 사용하는 것이 권장됩니다. 이 Action은 주기적으로 panther-analysis의 최신 변경사항으로 기본 브랜치에 대한 풀 리퀘스트를 엽니다.

이 Action을 구성하려면:

1. 다음 권한을 가진 GitHub 토큰을 생성하세요:

   • Administration - Read

   • Contents - Read and write

   • Metadata - Read

   • Pull Requests - Read and write

   • Workflows - Read and write

2. 포크한 저장소에서 다음 이름의 새 시크릿을 추가하세요: PANTHER_SYNC_UPSTREAM 그리고 이전 단계에서 생성한 토큰을 해당 값으로 설정하세요.

이 단계를 건너뛰면, 업스트림 저장소가 .github/workflows 디렉터리 내에 변경 사항이 있을 때마다 Action이 PR을 열지 못하고 실패합니다.

1. 포크를 업스트림 저장소와 처음으로 동기화하여 Action을 처음 트리거하려면, GitHub의 저장소에서 Actions > Sync Panther Analysis from Upstream.

2. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. Run Workflow > Run workflow.

   • Action이 완료되면 워크플로 실행 옆에 녹색 원이 표시됩니다. 변경 사항이 있으면 GitHub Actions가 작성한 새 오픈 풀 리퀘스트가 표시됩니다. 변경 사항이 없으면 "Local repo already synced to latest release."와 유사한 메시지가 표시됩니다.

   • 사용자를 사용할 것이며, Sync Panther Analysis from Upstream Action은 매주 화요일 15:00Z에 크론 스케줄로 실행되도록 구성되어 있습니다. 이 스케줄은 .github/workflows/sync-from-upstream.yml.

3. 의 6번째 줄에서 수정할 수 있습니다.

풀 리퀘스트를 일반 풀 리퀘스트와 동일한 방식으로 기본 브랜치에 병합하세요.

저장소는 병합을 최신 변경사항으로 반영하며, 비공개 저장소와 panther-analysis의 git 히스토리를 모두 확인할 수 있습니다. 병합 충돌 문제에 직면하거나 "all jobs have failed"라는 오류가 표시되면, 다음 문제 해결 문서를 참조하세요:

수동 업데이트

또는 포크를 수동으로 업데이트할 수 있습니다. 자세한 내용은 을 참조하세요 GitHub의 문서 이 경우 panther-labs/panther-analysis의 소스에서 포크를 수동으로 업데이트하는 프로세스에 대해 자세히 알아보려면.

항상 이러한 문서에 설명된 "비교" 옵션을 사용하여 조직에 적합한 변경 사항을 가져오고 있는지 확인하는 것이 권장됩니다. 이는 업데이트를 풀 리퀘스트로 표시하고 변경 사항과 댓글을 남길 수 있습니다.

GitHub Action sync-panther-analysis-from-upstream을 사용할 때 병합 충돌 및 실패한 동기화를 어떻게 해결하나요?

레포를 포크한 후 Panther 디텍션을 CI/CD 워크플로에 통합할 수 있습니다—에 대한 문서를 참조하세요 CircleCI 와 저장소를 복제한 후에는 Panther 디텍션을 CI/CD 워크플로우에 통합할 수 있습니다—다음 문서를 참조하세요:.

저장소를 복제한 후에는 Panther 디텍션을 CI/CD 워크플로우에 통합할 수 있습니다—다음 문서를 참조하세요:

GitHub Actions

참조 GitHub Actions를 통한 콘텐츠 관리 을 참조하세요.

고객 기여 콘텐츠

콘텐츠를 panther-analysis로 다시 기여하는 것을 권장합니다. 그렇게 하려면 panther-analysis 저장소에 대한 풀 리퀘스트를 생성하면 Panther의 위협 조사 팀이 검토합니다.