최상위 그룹을 위한 감사 이벤트 스트리밍
최상위 그룹을 위한 감사 이벤트 스트리밍에 대해 설명합니다.
최상위 그룹의 감사 이벤트 스트리밍을 사용하면 그룹 Owner는 다음을 수행할 수 있습니다. 최상위 그룹에 스트리밍 대상을 설정하여 해당 그룹, 하위 그룹, 프로젝트의 모든 감사 이벤트를 구조화된 JSON으로 수신합니다. 서드파티 시스템에서 감사 로그를 관리합니다. 구조화된 JSON 데이터를 수신할 수 있는 모든 서비스를 스트리밍 대상으로 사용할 수 있습니다. 각 스트리밍 대상은 다음 조건을 따릅니다. 스트리밍되는 이벤트마다 최대 20개의 사용자 지정 HTTP 헤더를 포함할 수 있습니다. GitLab.com의 경우 GitLab.com IP 주소 범위 의 트래픽을 허용해야 합니다. 대상의 최대 수와 대상 생성 및 업데이트의 속도 제한은 감사 이벤트 스트리밍 대상 제한 을 참고합니다. GitLab은 동일한 대상으로 단일 이벤트를 두 번 이상 스트리밍할 수 있습니다. 페이로드의 id 키를 사용하여 수신 데이터의 중복을 제거합니다. 감사 이벤트는 HTTP가 지원하는 POST 요청 메서드 프로토콜로 전송됩니다. Warning 스트리밍 대상은 민감한 정보가 포함될 수 있는 모든 감사 이벤트 데이터를 수신합니다. 신뢰할 수 있는 스트리밍 대상인지 확인합니다. 배치 이벤트 전송 # 히스토리 GitLab 19.3에서 audit_event_streaming_via_nats 라는 기능 플래그 와 함께 도입되었습니다 . 기본적으로 비활성화되어 있습니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. 기본적으로 GitLab은 각 감사 이벤트를 별도의 요청으로 스트리밍 대상에 전송합니다. 최상위 그룹에 audit_event_streaming_via_nats 기능 플래그가 활성화되어 있으면 GitLab은 그룹의 감사 이벤트를 대신 배치로 전송합니다. 배치에는 서로 다른 유형의 이벤트가 포함될 수 있으며, 이벤트가 하나뿐일 수도 있습니다. 배치 형식은 그룹의 대상으로 가는 모든 전송에 적용됩니다. 대상으로의 전송이 실패하면 GitLab은 배치 전체를 다시 전송하며, 이 경우 배치에 포함된 모든 이벤트가 중복될 수 있습니다. 자세한 내용은 스트리밍 대상으로의 전송 실패 를 참고합니다. 이 페이지 앞부분에서 설명한 대로 id 로 이벤트의 중복을 제거합니다. 배치 형식은 대상 유형에 따라 다릅니다. 배치 HTTP 요청 # 요청 본문은 JSON 배열입니다. 각 요소는 감사 이벤트 스키마 를 따르는 감사 이벤트이며, 해당 이벤트의 유형을 식별하는 event_type 필드를 포함합니다. 예시는 배치 HTTP 요청 본문 을 참고합니다. 배치 요청은 단일 이벤트 요청과 다음 점이 다릅니다. 요청 본문이 단일 이벤트 객체가 아니라 이벤트 배열입니다. X-Gitlab-Audit-Event-Type 헤더가 전송되지 않습니다. 대신 각 이벤트의 event_type 필드를 사용합니다. X-Gitlab-Event-Streaming-Token 헤더와 사용자 지정 HTTP 헤더는 그대로입니다. 배치 요청은 대상의 conten