Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

엔터프라이즈의 감사 로그 API 사용

REST API를 사용하여 프로그래밍 방식으로 엔터프라이즈 이벤트를 검색할 수 있습니다.

이 기능을 사용할 수 있는 사용자

Enterprise owners can use the audit log API.

감사 로그 API 사용

REST API를 사용하여 감사 로그와 상호 작용할 수 있습니다. 다음을 read:audit_log 사용할 수 있습니다. scope API를 통해 감사 로그에 액세스합니다.

API 응답의 타임스탬프 및 날짜 필드는 UTC Epoch 밀리초 단위로 측정됩니다.

지적 재산권의 안전을 보장하고 엔터프라이즈에 대한 규정 준수를 유지하기 위해 감사 로그 REST API를 사용하여 감사 로그 데이터의 복사본을 유지하고 모니터링할 수 있습니다. * 조직 또는 리포지토리 설정에 대한 액세스

  • 권한의 변경 내용
  • 조직, 리포지토리 또는 팀에서 추가 또는 제거된 사용자
  • 관리자로 승격된 사용자
  • GitHub App의 사용 권한 변경
  • API 요청(사용하도록 설정해야 함) * Git 이벤트(예: 복제, 가져오기 및 푸시)

감사 로그에는 엔터프라이즈 현재 월 및 이전 6개월 이내. 감사 로그는 7일 동안 Git 이벤트를 유지합니다.

기본적으로 지난 3개월의 이벤트만 표시됩니다. 이전 이벤트를 보려면 created 매개 변수를 사용하여 날짜 범위를 지정해야 합니다. 자세한 내용은 "검색 구문 이해"을 참조하세요.

감사 로그 REST API에 대한 자세한 내용은 "GitHub Enterprise 관리" 및 "조직.

예제 1: 페이지를 매긴 특정 날짜에 대한 엔터프라이즈의 모든 이벤트

커서 기반 페이지 매김을 사용할 수 있습니다. 페이지 매김에 대한 자세한 내용은 "REST API에서 페이지 매김 사용.

아래 쿼리는 엔터프라이즈에서 avocado-corp 2022년 1월 1일에 생성된 감사 로그 이벤트를 검색하고 페이지 매김을 사용하여 페이지당 최대 100개의 항목이 있는 첫 번째 페이지를 반환합니다. 페이지 매김에 대한 자세한 내용은 "REST API에서 페이지 매김 사용. 플래그를 --include 사용하면 헤더가 응답과 함께 반환됩니다.

curl --include -H "Authorization: Bearer TOKEN" \
--request GET \
"https://api.github.com/enterprises/avocado-corp/audit-log?phrase=created:2022-01-01&per_page=100"

결과가 link 100개 이상인 경우 헤더에는 결과의 다음, 첫 번째 및 이전 페이지를 가져오는 URL이 포함됩니다.

link: <https://api.github.com/enterprises/13827/audit-log?%3A2022-11-01=&per_page=100&after=MS42NjQzODMzNTk5MjdlKzEyfDloQzBxdURzaFdVbVlLWjkxRU9mNXc%3D&before=>; rel="next",
<https://api.github.com/enterprises/13827/audit-log?%3A2022-11-01=&per_page=100&after=&before=>; rel="first",
<https://api.github.com/enterprises/13827/audit-log?%3A2022-11-01=&per_page=100&after=&before=MS42Njc4NDA2MjM4MzNlKzEyfExqeG5sUElvNEZMbG1XZHA5akdKTVE%3D>; rel="prev"

해당 페이지 매김 링크를 다음 요청에 복사합니다. 예를 들면 다음과 같습니다.

curl -I -H "Authorization: Bearer TOKEN" \
--request GET \
"https://api.github.com/enterprises/13827/audit-log?%3A2022-11-01=&per_page=100&after=MS42Njc4NDA2MjM5NDFlKzEyfHRYa3AwSkxUd2xyRjA5bWxfOS1RbFE%3D&before="

예제 2: 특정 날짜 및 행위자의 엔터프라이즈 끌어오기 요청에 대한 이벤트

+ 기호 또는 ASCII 문자 코드 %20으로 구성된 URL에서 구분하여 createdactor와 같은 여러 검색 구문을 지정할 수 있습니다.

아래 쿼리는 avocado-corp 엔터프라이즈에서 2022년 1월 1일 이후에 이벤트가 발생하고 octocat 사용자가 작업을 수행한 끌어오기 요청에 대한 감사 로그 이벤트를 검색합니다.

curl -H "Authorization: Bearer TOKEN" \
--request GET \
"https://api.github.com/enterprises/avocado-corp/audit-log?phrase=action:pull_request+created:>=2022-01-01+actor:octocat"