Audit 이벤트 스키마 및 예시

Audit 이벤트 스키마

Audit 이벤트는 응답 본문의 예측 가능한 스키마를 갖고 있습니다.

필드 설명 기록 스트리밍 전용 필드
author_id 이벤트를 트리거한 사용자의 사용자 ID   No
author_name 이벤트를 트리거한 작성자의 사람이 읽을 수 있는 이름 작성자가 더 이상 존재하지 않을 때 유용합니다 Yes
created_at 이벤트 트리거 시간   No
details 추가 메타데이터가 포함된 JSON 오브젝트 정의된 스키마가 없지만 종종 이벤트에 대한 추가 정보를 포함합니다 No
entity_id Audit 이벤트의 엔티티 ID   No
entity_path 감사 가능한 이벤트에 영향을 받는 엔티티의 전체 경로   Yes
entity_type 엔티티 유형의 문자열 표현 User, Group, Key를 포함할 수 있는 값들이 허용됩니다. 이 목록은 모두를 포함하지는 않습니다 No
event_type 감사 이벤트 유형의 문자열 표현   Yes
id 감사 이벤트의 고유 식별자 필요한 경우 중복을 방지하는 데 사용할 수 있습니다 No
ip_address 이벤트를 트리거하는 호스트의 IP 주소   Yes
target_details 대상에 대한 추가 세부 정보   Yes
target_id Audit 이벤트의 대상 ID   Yes
target_type 대상 유형의 문자열 표현   Yes

Audit 이벤트 JSON 스키마 

{
  "properties": {
    "id": {
      "type": "string"
    },
    "author_id": {
      "type": "integer"
    },
    "author_name": {
      "type": "string"
    },
    "details": {},
    "ip_address": {
      "type": "string"
    },
    "entity_id": {
      "type": "integer"
    },
    "entity_path": {
      "type": "string"
    },
    "entity_type": {
      "type": "string"
    },
    "event_type": {
      "type": "string"
    },
    "target_id": {
      "type": "integer"
    },
    "target_type": {
      "type": "string"
    },
    "target_details": {
      "type": "string"
    },
  },
  "type": "object"
}

헤더

헤더는 다음과 같이 포맷됩니다. 

POST /logs HTTP/1.1
Host: <목적지_호스트>
Content-Type: application/x-www-form-urlencoded
X-Gitlab-Event-Streaming-Token: <목적지_토큰>
X-Gitlab-Audit-Event-Type: repository_git_operation

예시: Git 작업에 대한 감사 이벤트 스트리밍

인증된 사용자가 프로젝트의 원격 Git 저장소를 푸시하거나 풀하거나 복제할 때 감사 이벤트를 스트리밍할 수 있습니다:

  • SSH 사용.
  • HTTP 또는 HTTPS 사용.
  • GitLab UI의 Download () 사용.

사용자가 로그인하지 않은 경우에는 감사 이벤트가 캡처되지 않습니다. 예를 들어, 공개 프로젝트를 다운로드할 때 감사 이벤트가 캡처되지 않습니다.

Git SSH 이벤트에 대한 감사 이벤트 페이로드 예시

페치: 

{
  "id": "1",
  "author_id": -3,
  "entity_id": 29,
  "entity_type": "Project",
  "details": {
    "author_name": "deploy-key-name",
    "author_class": "DeployKey",
    "target_id": 29,
    "target_type": "Project",
    "target_details": "example-project",
    "custom_message": {
      "protocol": "ssh",
      "action": "git-upload-pack"
    },
    "ip_address": "127.0.0.1",
    "entity_path": "example-group/example-project"
  },
  "ip_address": "127.0.0.1",
  "author_name": "deploy-key-name",
  "entity_path": "example-group/example-project",
  "target_details": "example-project",
  "created_at": "2022-07-26T05:43:53.662Z",
  "target_type": "Project",
  "target_id": 29,
  "event_type": "repository_git_operation"
}