감사 로그 파일 API (V2)

감사 로그 API는 조직별 로그 파일의 ID를 나열하고 각 파일의 본문을 다운로드합니다. OAuth2로 호출하는 타사 애플리케이션에는 api:audit-read 권한 범위가 필요하며, 호출 토큰에도 대상 감사 로그를 조회할 권한이 있어야 합니다.

날짜 범위에서 파일 찾기

List Log Files에 조직 RID와 startDate를 전달합니다. startDate는 pageToken이 없는 첫 요청에서 필수입니다. endDate를 넣으면 그 날짜의 이벤트까지 포함하여 조회합니다. 두 날짜는 YYYY-MM-DD 형식입니다.

응답의 data에는 LogFile 객체가 들어가며 각 파일에는 필수 문자열 id가 있습니다. 페이지의 결과 수는 요청한 pageSize와 다를 수 있으므로, 적은 결과를 받았다는 이유로 조회를 끝내지 않습니다. nextPageToken이 있으면 같은 조건의 다음 요청에 pageToken으로 전달하고, 없으면 마지막 페이지로 처리합니다.

종료 날짜를 생략하면 날짜 상한 없이 조회합니다. 반환한 다음 토큰을 사용하여 새로 제공되는 감사 로그를 계속 확인할 수 있습니다.

파일 본문 저장

Get Log File Content에 같은 조직 RID와 목록에서 얻은 파일 ID를 전달합니다. 파일 ID는 URL 경로 조각으로 퍼센트 인코딩합니다. 예를 들어 끝의 ==는 %3D%3D가 됩니다.

다운로드 응답은 바이너리 본문입니다. 파일 ID를 디코딩한 값을 로그 내용으로 사용하거나, 다운로드한 본문을 목록 응답과 같은 JSON 객체로 가정하지 않습니다. 언어별 예제는 AUDIT_LOG_FILE 환경 변수에 지정한 로컬 파일에 본문 바이트를 기록합니다. 기존 파일이 있으면 덮어쓰므로 보존할 파일과 저장 경로를 구분합니다.

첫 목록 요청에서 시작 날짜를 빠뜨리면 MissingStartDate/HTTP 400이 발생합니다. 조회 권한이 없으면 목록 또는 다운로드 엔드포인트의 권한 오류가 HTTP 403으로 반환됩니다. 호출 대상과 토큰의 권한을 확인한 뒤 다시 요청합니다.