GitHub 로그
Panther는 GitHub 로그 직접 가져오기와 감사 로그 스트리밍을 지원합니다
개요
Panther는 GitHub 로그를 다양한 방법으로 수집할 수 있으며, 아래에 설명되어 있습니다.
Panther는 다음과 같은 GitHub 로그 수집 방법을 지원합니다:
Panther는 GitHub 감사 로그를 쿼리하여 가져올 수 있습니다 GitHub API 새 이벤트를 1분마다 확인합니다.
이 방법은 GitHub의 조직 수준.
Panther는 GitHub 감사 로그를 다음을 사용하여 수집할 수 있습니다 GitHub의 감사 로그 스트리밍 기능 AWS S3 또는 Google Cloud Storage를 통해.
이 방법은 GitHub의 엔터프라이즈 수준.
Panther는 GitHub webhook HTTP를 통해 직접.
이 방법은 GitHub의 조직 수준.
GitHub Enterprise Cloud를 사용 중이라면, 감사 로그 스트리밍 방법으로 로그를 수집하는 것을 권장합니다. 단일 통합으로 전체 엔터프라이즈의 로그를 수집할 수 있기 때문입니다. API 방법은 하나의 GitHub 조직에 대해서만 로그를 가져올 수 있습니다.
GitHub 조직 로그를 Panther에 온보딩하는 방법
귀하의 Github 조직은 다음의 일부여야 합니다 Github Enterprise Cloud 배포. Github Enterprise Server 자체 호스팅 옵션은 아직 지원되지 않습니다.
1단계: GitHub에서 Panther 인증하기
Panther가 GitHub 감사 로그를 수신하도록 인증하는 두 가지 옵션이 있습니다:
새 OAuth 앱 생성 GitHub에서 생성하고 앱 자격 증명을 Panther에 제공
개인 액세스 토큰 생성 GitHub에서 생성하고 자격 증명을 Panther에 제공
옵션 1: 새 OAuth 앱 생성
아래 단계는 GitHub 조직에서 조직 소유자 권한과 GitHub Enterprise 구독이 있는 경우에만 수행할 수 있습니다. 동일한 자격 증명을 사용하여 서로 다른 GitHub 조직에 대해 여러 통합을 구성해야 하는 경우, 개인 액세스 토큰 또는 OAuth2 앱 을(를) 조직 계정 대신 사용자 계정에 생성하여 사용할 수 있습니다. 어떤 조직이든 OAuth2 앱 액세스 제한을 활성화한 경우, 앱은 먼저 조직 관리자에 의해 승인되어야 합니다.
GitHub Enterprise 계정에 로그인합니다.
조직 계정의 홈페이지에서 설정 탭을 클릭합니다.
페이지 하단으로 스크롤하여 개발자 설정 을 클릭한 다음 OAuth 앱 을(를) 클릭합니다 (앱을
org수준에 설치).을 클릭합니다 애플리케이션 등록. 양식을 작성합니다:
기억하기 쉬운 애플리케이션 이름을 이름 필드에 입력합니다. 예:
Panther Integration.Panther 인스턴스의 기본 URL을 홈페이지 URL 필드에 입력합니다. 예:
https://test.runpanther.xyz를 복사합니다 리디렉션 URL 을 Panther에서 복사하여 인증 콜백 URL 필드에 붙여넣습니다.
이 URL을 얻으려면 GitHub API 소스설정을 시작합니다. 리디렉션 URL 이 표시되는 단계에 도달하면 이를 복사한 후 돌아와 GitHub 앱 구성을 완료합니다.

필요한 모든 필드를 입력한 후 애플리케이션 등록을 클릭합니다.
애플리케이션이 등록되면 클라이언트 ID 를 확인하고 새 클라이언트 시크릿을 생성할 수 있습니다. 안전한 위치에 저장하세요. 다음 단계에서 필요합니다.

옵션 2: 개인 액세스 토큰 생성
아래 단계는 GitHub 조직에서 조직 소유자 권한과 GitHub Enterprise 구독이 있는 경우에만 수행할 수 있습니다. GitHub에서 개인 액세스 토큰을 생성하는 방법에 대한 자세한 내용은 여기.
Github Enterprise 계정에 로그인합니다.
프로필을 클릭한 다음 설정 옵션을 클릭합니다.
페이지 하단으로 스크롤하여 개발자 설정 을 클릭한 다음 개인 액세스 토큰.
클릭합니다 새 토큰 생성 을 클릭하고 설명이 있는 토큰 이름을 입력합니다. 예:
Panther Integration.이 토큰에 부여할 범위(scope) 또는 권한을 선택합니다.
다음을 선택합니다
read:audit_log범위.만약
read:audit_log범위를 사용할 수 없다면, 다음을 선택합니다admin:org>read:org대신 권한.
다음을 활성화할 필요는 없습니다
write:org권한.
클릭합니다 토큰 생성.
토큰을 복사하여 안전한 위치에 저장하세요. 다음 단계에서 필요합니다.
2단계: Panther에서 새 GitHub API 소스 생성
Panther Console의 왼쪽 탐색 막대에서 구성 > 로그 소스.
클릭합니다 새로 만들기를 클릭합니다.
“GitHub API”를 검색한 다음 해당 타일을 클릭합니다.
슬라이드 아웃 패널에서 설정 시작.
을 클릭합니다. 다음 화면에서 소스에 대한 설명이 있는 이름(예:
내 Github 감사 로그)과 모니터링하려는 Github 조직의 이름을 입력합니다.클릭합니다 설정.
GitHub에서 로그를 수신하도록 Panther를 인증합니다 - 위에서 선택한 옵션에 따라 아래 단계를 따르세요:
OAuth2 인증 흐름 사용: 앱 클라이언트 ID 와 클라이언트 시크릿 을 입력합니다. 이 값은 Github에서 얻은 것입니다. Github 계정에서 OAuth 앱의 세부 정보 페이지에서 이 정보를 확인할 수 있습니다. 애플리케이션을 등록한 후.
개인 액세스 토큰 사용: 개인 액세스 토큰 키를 복사하여 Personal Access token 필드에 붙여넣습니다.
클릭합니다 설정.
클릭합니다 액세스 권한 부여.
클릭합니다 승인.

성공 화면으로 이동합니다:

선택적으로 하나 이상의 디택션 팩.
을 활성화할 수 있습니다 이벤트가 처리되지 않을 때 알러트 트리거 설정의 기본값은 예입니다. 일정 시간 이후 로그 소스에서 데이터 흐름이 중단되면 알림을 받게 되므로 이 설정을 활성화된 상태로 유지하는 것을 권장합니다. 기간은 구성 가능하며 기본값은 24시간입니다.

감사 로그 스트리밍을 통해 GitHub 로그를 Panther에 온보딩하는 방법
Panther에서 GitHub 감사 로그 스트리밍을 구성하는 데는 두 단계가 있습니다:
GitHub에서 스토리지 대상까지 감사 로그 스트리밍을 설정합니다.
Panther에서 새 GitHub 감사 로그 스트리밍 소스를 생성합니다.
사전 요구 사항
감사 로그 스트리밍은 GitHub 엔터프라이즈 소유자가 GitHub에서 구성해야 합니다.
1단계: GitHub에서 스토리지 대상으로 감사 로그 스트리밍 설정
Panther는 두 개의 스토리지 대상에서 GitHub 감사 로그 스트리밍 데이터 수집을 지원합니다. 아래 스토리지 대상 중 하나를 선택하세요:
AWS S3
여기의 지침을 따르세요: Amazon S3용 스트리밍 설정.
Google Cloud GCS
여기의 지침을 따르세요: Google Cloud Storage로 스트리밍 설정.
2단계: Panther에서 새 GitHub 감사 로그 스트리밍 소스 생성
Panther Console의 왼쪽 탐색 막대에서 구성 > 로그 소스.
클릭합니다 생성.
GitHub를 검색합니다. GitHub 감사 로그 스트리밍 타일을 선택합니다.

다음 중 하나를 선택합니다 S3 또는 GCS, 선택한 전송 방법에 따라.
선택한 대상 방법의 온보딩 프로세스를 따르세요:
S3의 경우, 다음을 따르세요 Panther가 S3에서 로그를 가져오도록 활성화하는 방법에 대한 문서.
Panther에서 S3 버킷을 생성한 후 소스의 Schema 탭으로 이동하여 Advanced Edit & Test with Raw Events.

를 클릭합니다. S3 제외 필터 를 다음 값으로 설정합니다
_check.
GCS의 경우, 다음을 따르세요 Panther가 GCS에서 로그를 가져오도록 활성화하는 방법에 대한 문서.
GitHub webhook 이벤트를 온보딩하는 방법
Panther는 GitHub webhook 이벤트를 HTTP를 통해 직접 수집할 수 있습니다.
1단계: Panther에서 GitHub Webhooks 소스 생성
Panther Console의 왼쪽 탐색 막대에서 구성 > 로그 소스.
클릭합니다 새로 만들기.
“GitHub Webhooks”를 검색한 다음 해당 타일을 클릭합니다.
슬라이드 아웃 패널에서 전송 메커니즘 드롭다운은 오른쪽 상단에서 미리 HTTP 옵션을 클릭합니다.
클릭합니다 설정 시작.

로 채워져 있습니다. Panther의 HTTP 소스 구성 지침을 5단계부터 따르세요.
설정 중에 인증 방법 은 기본적으로 HMAC으로 설정되며, HMAC 헤더 이름 은 기본적으로
X-Hub-Signature-256.입력한 시크릿 키 값 을 저장해 두세요. 다음 단계에서 필요합니다.
이 소스로 전송되는 페이로드는 모든 HTTP 소스에 대한 페이로드 요구 사항.
의 적용을 받습니다. HTTP 엔드포인트 생성이 완료될 때까지 다음 단계로 진행하지 마세요.
2단계: GitHub에서 webhook 생성
GitHub webhook 생성에 대한 자세한 지침은 다음을 참조하세요 GitHub의 webhook 생성 문서.
GitHub에서 조직으로 이동합니다.
왼쪽 탐색 막대에서 Webhooks.

클릭합니다 Webhook 추가.
를 클릭합니다. 다음 필드에 값을 입력합니다:
콘텐츠 유형: 다음으로 설정
application/json.페이로드 URL: 1단계에서 Panther에서 생성한 HTTP 소스 URL로 설정합니다.
시크릿 값: 1단계의 HTTP 소스 생성 중 사용한 값으로 설정합니다.
Panther가 수신할 이벤트를 선택하세요. 모든 이벤트 유형이 지원되지만, 모두가 보안적 가치를 갖는 것은 아닙니다.
이벤트 유형 설명은 다음을 참조하세요 GitHub의 Webhook 이벤트 및 페이로드 문서.
일반적으로 보안적 가치가 있는 GitHub Webhook 이벤트 유형
pushpull_requestrepositorymember,membership,teamorganizationinstallation,installation_repositoriessecret_scanning_알러트code_scanning_알러트repository_vulnerability_알러트workflow_dispatchworkflow_jobworkflow_runcheck_rundependabot_알러트branch_protection_룰branch_protection_configurationsecurity_and_analysis
클릭합니다 Webhook 추가.
Panther 관리형 디택션
참조 Panther 관리형 GitHub용 룰은 panther-analysis GitHub 리포지토리.
Data Explorer에서 로그 쿼리하기
Panther의 Data Explorer에서 GitHub 로그 쿼리 예제를 보려면 다음을 참조하세요 Github 감사 로그 쿼리.
지원되는 로그 유형
GitHub.Webhook
GitHub webhook은 GitHub 조직 또는 리포지토리 내에서 생성된 모든 이벤트에 대해 알림을 내보냅니다. 자세한 내용은 다음을 참조하세요 GitHub의 webhook 문서.
Github.Audit
감사 로그를 통해 조직 관리자는 조직 구성원이 수행한 작업을 신속하게 검토할 수 있습니다. 자세한 내용은 다음을 참조하세요. 감사 로그 액세스에 대한 GitHub 문서.
마지막 업데이트
도움이 되었나요?

