히스토리

• GitLab 15.2에서 서브그룹 이벤트 기록 수정됨.
• GitLab 15.2에서 custom_headers_streaming_audit_events_ui라는 플래그와 함께 사용자 지정 HTTP 헤더 UI가 도입됨. 기본적으로 비활성화됨.
• GitLab 15.3에서 사용자 지정 HTTP 헤더 UI가 일반 가용화됨. 기능 플래그 custom_headers_streaming_audit_events_ui 제거됨.
• GitLab 15.3에서 사용자 경험 개선됨.
• GitLab 16.3에서 HTTP 대상 이름 필드가 추가됨.
• GitLab 16.5에서 활성 체크박스 기능이 추가됨.

최상위 그룹을 위한 감사 이벤트 스트리밍을 사용하면 그룹 소유자는 다음을 수행할 수 있습니다:

• 그룹, 서브그룹 및 프로젝트에 관한 모든 감사 이벤트를 구조화된 JSON으로 수신하기 위한 최상위 그룹의 스트리밍 대상을 설정합니다.
• 서드파티 시스템에서 감사 로그를 관리합니다. 구조화된 JSON 데이터를 수신할 수 있는 모든 서비스를 스트리밍 대상으로 사용할 수 있습니다.

각 스트리밍 대상:

• 스트리밍되는 각 이벤트에 최대 20개의 사용자 지정 HTTP 헤더를 포함할 수 있습니다.
• GitLab.com의 경우 GitLab.com IP 주소 범위에서의 트래픽을 허용해야 합니다.

GitLab은 동일한 대상으로 단일 이벤트를 두 번 이상 스트리밍할 수 있습니다. 수신 데이터의 중복을 제거하려면 페이로드의 id 키를 사용하세요.

감사 이벤트는 HTTP에서 지원하는 POST 요청 방법 프로토콜을 사용하여 전송됩니다.

HTTP 대상#

사전 요구 사항:

• 보안 강화를 위해 대상 URL에 SSL 인증서를 사용해야 합니다.

최상위 그룹의 HTTP 스트리밍 대상을 관리합니다.

새 HTTP 대상 추가#

최상위 그룹에 새 HTTP 스트리밍 대상을 추가합니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹에 스트리밍 대상을 추가하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트리밍 대상 추가를 선택하고 HTTP 엔드포인트를 선택하여 대상 추가 섹션을 표시합니다.
5. 이름 및 대상 URL 필드에 대상 이름과 URL을 추가합니다.
6. 선택 사항. 사용자 지정 HTTP 헤더 표를 찾습니다.
7. 헤더를 활성화하려면 활성 체크박스를 선택합니다. 감사 이벤트와 함께 헤더가 전송됩니다.
8. 헤더 추가를 선택하여 새 이름 및 값 쌍을 생성합니다. 필요한 만큼 이름 및 값 쌍을 입력합니다. 스트리밍 대상당 최대 20개의 헤더를 추가할 수 있습니다.
9. 모든 헤더를 입력한 후 추가를 선택하여 새 스트리밍 대상을 추가합니다.

HTTP 대상 업데이트#

사전 요구 사항:

• 그룹에 대한 Owner 역할.

스트리밍 대상 이름을 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 이름 필드에 업데이트할 대상 이름을 추가합니다.
6. 저장을 선택하여 스트리밍 대상을 업데이트합니다.

스트리밍 대상의 사용자 지정 HTTP 헤더를 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 사용자 지정 HTTP 헤더 표를 찾습니다.
6. 업데이트하려는 헤더를 찾습니다.
7. 헤더를 활성화하려면 활성 체크박스를 선택합니다. 감사 이벤트와 함께 헤더가 전송됩니다.
8. 헤더 추가를 선택하여 새 이름 및 값 쌍을 생성합니다. 필요한 만큼 이름 및 값 쌍을 입력합니다. 스트리밍 대상당 최대 20개의 헤더를 추가할 수 있습니다.
9. 저장을 선택하여 스트리밍 대상을 업데이트합니다.

이벤트 진위성 확인#

히스토리

• GitLab 15.2에서 도입됨.

각 스트리밍 대상에는 이벤트의 진위성을 확인하는 데 사용할 수 있는 고유한 확인 토큰(verificationToken)이 있습니다. 이 토큰은 소유자가 지정하거나 이벤트 대상이 생성될 때 자동으로 생성되며 변경할 수 없습니다.

verificationToken 매개변수는 GraphQL API를 사용해서만 설정할 수 있습니다.

스트리밍된 각 이벤트에는 스트리밍 대상을 나열할 때 대상 값과 비교하여 확인할 수 있는 X-Gitlab-Event-Streaming-Token HTTP 헤더에 확인 토큰이 포함됩니다.

사전 요구 사항:

• 그룹에 대한 Owner 역할.

스트리밍 대상을 나열하고 확인 토큰을 보려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 확인 토큰 입력란을 찾습니다.

이벤트 필터 업데이트#

히스토리

• GitLab 16.1에서 정의된 감사 이벤트 유형 목록을 포함한 UI의 이벤트 유형 필터링이 도입됨.

그룹에 이 기능이 활성화된 경우 사용자가 대상별로 스트리밍된 감사 이벤트를 필터링할 수 있습니다. 필터 없이 기능이 활성화된 경우 대상은 모든 감사 이벤트를 수신합니다.

이벤트 유형 필터가 설정된 스트리밍 대상에는 필터링됨 ([filter]) 레이블이 표시됩니다.

스트리밍 대상의 이벤트 필터를 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 감사 이벤트 유형별 필터링 드롭다운 목록을 찾습니다.
6. 드롭다운 목록을 선택하고 필요한 이벤트 유형을 선택하거나 해제합니다.
7. 저장을 선택하여 이벤트 필터를 업데이트합니다.

네임스페이스 필터 업데이트#

히스토리

• GitLab 16.7에서 UI의 네임스페이스 필터링이 도입됨.

그룹에 이 기능이 활성화된 경우 사용자가 대상별로 스트리밍된 감사 이벤트를 필터링할 수 있습니다. 필터 없이 기능이 활성화된 경우 대상은 모든 감사 이벤트를 수신합니다.

네임스페이스 필터가 설정된 스트리밍 대상에는 필터링됨 ([filter]) 레이블이 표시됩니다.

스트리밍 대상의 네임스페이스 필터를 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 그룹 또는 프로젝트별 필터링 드롭다운 목록을 찾습니다.
6. 드롭다운 목록을 선택하고 필요한 네임스페이스를 선택하거나 해제합니다.
7. 저장을 선택하여 네임스페이스 필터를 업데이트합니다.

기본 콘텐츠 유형 헤더 재정의#

기본적으로 스트리밍 대상은 application/x-www-form-urlencoded의 content-type 헤더를 사용합니다. 하지만 content-type 헤더를 다른 값으로 설정할 수 있습니다. 예: application/json.

최상위 그룹 스트리밍 대상의 content-type 헤더 기본값을 재정의하려면 다음 중 하나를 사용합니다:

• GitLab UI.
• GraphQL API.

Google Cloud Logging 대상#

히스토리

• GitLab 16.2에서 도입됨.

최상위 그룹의 Google Cloud Logging 대상을 관리합니다.

사전 요구 사항#

Google Cloud Logging 스트리밍 감사 이벤트를 설정하기 전에 다음을 수행해야 합니다:

1. Google Cloud 프로젝트에서 Cloud Logging API를 활성화합니다.
2. 적절한 자격 증명과 권한을 가진 Google Cloud 서비스 계정을 생성합니다. 이 계정은 감사 로그 스트리밍 인증을 구성하는 데 사용됩니다. 자세한 내용은 Google Cloud 문서의 서비스 계정 생성 및 관리를 참조하세요.
3. Google Cloud에서 로깅을 활성화하려면 서비스 계정에 Logs Writer 역할을 활성화합니다. 자세한 내용은 IAM으로 접근 제어를 참조하세요.
4. 서비스 계정에 대한 JSON 키를 생성합니다. 자세한 내용은 서비스 계정 키 생성을 참조하세요.

새 Google Cloud Logging 대상 추가#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹에 Google Cloud Logging 스트리밍 대상을 추가하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트리밍 대상 추가를 선택하고 Google Cloud Logging을 선택하여 대상 추가 섹션을 표시합니다.
5. 새 대상의 이름으로 사용할 임의의 문자열을 입력합니다.
6. 이전에 생성한 Google Cloud 서비스 계정 키에서 Google 프로젝트 ID, Google 클라이언트 이메일, Google 개인 키를 입력하여 새 대상에 추가합니다.
7. 새 대상의 로그 ID로 사용할 임의의 문자열을 입력합니다. 나중에 Google Cloud에서 로그 결과를 필터링하는 데 사용할 수 있습니다.
8. 추가를 선택하여 새 스트리밍 대상을 추가합니다.

Google Cloud Logging 대상 업데이트#

히스토리

• GitLab 16.3에서 개인 키를 추가하는 버튼이 도입됨.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹의 Google Cloud Logging 스트리밍 대상을 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. Google Cloud Logging 스트림을 선택하여 펼칩니다.
5. 대상의 이름으로 사용할 임의의 문자열을 입력합니다.
6. 이전에 생성한 Google Cloud 서비스 계정 키에서 Google 프로젝트 ID와 Google 클라이언트 이메일을 입력하여 대상을 업데이트합니다.
7. 대상의 로그 ID를 업데이트할 임의의 문자열을 입력합니다. 나중에 Google Cloud에서 로그 결과를 필터링하는 데 사용할 수 있습니다.
8. 새 개인 키 추가를 선택하고 Google 개인 키를 입력하여 개인 키를 업데이트합니다.
9. 저장을 선택하여 스트리밍 대상을 업데이트합니다.

AWS S3 대상#

히스토리

• GitLab 16.6에서 allow_streaming_audit_events_to_amazon_s3라는 플래그와 함께 도입됨. 기본적으로 활성화됨.
• GitLab 16.7에서 기능 플래그 allow_streaming_audit_events_to_amazon_s3가 제거됨.

최상위 그룹의 AWS S3 대상을 관리합니다.

사전 요구 사항#

AWS S3 스트리밍 감사 이벤트를 설정하기 전에 다음을 수행해야 합니다:

1. 적절한 자격 증명과 권한을 가진 AWS 액세스 키를 생성합니다. 이 계정은 감사 로그 스트리밍 인증을 구성하는 데 사용됩니다. 자세한 내용은 액세스 키 관리를 참조하세요.
2. AWS S3 버킷을 생성합니다. 이 버킷은 감사 로그 스트리밍 데이터를 저장하는 데 사용됩니다. 자세한 내용은 버킷 생성을 참조하세요.

새 AWS S3 대상 추가#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹에 AWS S3 스트리밍 대상을 추가하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트리밍 대상 추가를 선택하고 AWS S3을 선택하여 대상 추가 섹션을 표시합니다.
5. 새 대상의 이름으로 사용할 임의의 문자열을 입력합니다.
6. 이전에 생성한 AWS 액세스 키 및 버킷에서 액세스 키 ID, 비밀 액세스 키, 버킷 이름, AWS 리전을 입력하여 새 대상에 추가합니다.
7. 추가를 선택하여 새 스트리밍 대상을 추가합니다.

AWS S3 대상 업데이트#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹의 AWS S3 스트리밍 대상을 업데이트하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. AWS S3 스트림을 선택하여 펼칩니다.
5. 대상의 이름으로 사용할 임의의 문자열을 입력합니다.
6. 대상을 업데이트하려면 이전에 생성한 AWS 액세스 키 및 버킷에서 액세스 키 ID, 비밀 액세스 키, 버킷 이름, AWS 리전을 입력합니다.
7. 비밀 액세스 키를 업데이트하려면 새 비밀 액세스 키 추가를 선택하고 AWS 비밀 액세스 키를 입력합니다.
8. 저장을 선택합니다.

스트리밍 대상 나열#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹의 스트리밍 대상을 나열하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.

스트리밍 대상 활성화 또는 비활성화#

히스토리

• GitLab 18.2에서 도입됨.

대상 구성을 삭제하지 않고 대상으로의 감사 이벤트 스트리밍을 일시적으로 비활성화할 수 있습니다. 스트리밍 대상이 비활성화된 경우:

• 해당 대상으로의 감사 이벤트 스트리밍이 즉시 중지됩니다.
• 대상 구성은 보존됩니다.
• 언제든지 대상을 다시 활성화할 수 있습니다.
• 다른 활성 대상은 계속 이벤트를 수신합니다.

스트리밍 대상 비활성화#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

스트리밍 대상을 비활성화하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 활성 체크박스를 해제합니다.
6. 저장을 선택합니다.

대상이 감사 이벤트 수신을 중지합니다.

스트리밍 대상 활성화#

이전에 비활성화된 스트리밍 대상을 다시 활성화하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 활성 체크박스를 선택합니다.
6. 저장을 선택합니다.

대상이 즉시 감사 이벤트 수신을 재개합니다.

스트리밍 대상 삭제#

최상위 그룹의 스트리밍 대상을 삭제합니다. 마지막 대상이 성공적으로 삭제되면 최상위 그룹의 스트리밍이 비활성화됩니다.

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

최상위 그룹의 스트리밍 대상을 삭제하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 대상 삭제를 선택합니다.
6. 확인하려면 대상 삭제를 선택합니다.

사용자 지정 HTTP 헤더만 삭제#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 역할.

스트리밍 대상의 사용자 지정 HTTP 헤더만 삭제하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 보안 > 감사 이벤트를 선택합니다.
3. 메인 영역에서 스트림 탭을 선택합니다.
4. 스트림을 선택하여 펼칩니다.
5. 사용자 지정 HTTP 헤더 표를 찾습니다.
6. 제거하려는 헤더를 찾습니다.
7. 헤더 오른쪽에서 삭제 ([remove])를 선택합니다.
8. 저장을 선택합니다.

관련 항목#

• 인스턴스를 위한 감사 이벤트 스트리밍