> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ko/platform/enterprise-features/audit-logs-and-siem-export.md).

# 감사 로그 및 SIEM 내보내기

변조 방지 워크스페이스 감사 로그에서 주요 작업을 확인하고 OpenTelemetry를 통해 이벤트를 SIEM으로 스트리밍하세요.

{% hint style="warning" %}
감사 로그는 **프리미엄** 기능입니다.

요금제와 각 요금제에 포함된 기능에 대한 최신 정보는 [요금 페이지](https://roboflow.com/pricing).
{% endhint %}

감사 로그는 Roboflow 워크스페이스에서 발생한 주요 작업을 변조 방지 방식으로 기록합니다. 누가 작업을 수행했는지, 무엇이 변경되었는지, 언제 변경되었는지 확인할 수 있습니다. 팀 구성원, 역할, 프로젝트, 데이터 세트, 워크플로, 디바이스, API 키, OAuth 앱, 내보내기 관련 이벤트가 기록됩니다.

### 감사 로그에 액세스하기

1. 워크스페이스를 엽니다.
2. 다음으로 이동합니다: **워크스페이스 설정**.
3. 사이드바에서 **감사 로그** 를 선택합니다.

감사 로그 페이지는 기본적으로 **로그** 탭이 열립니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-a05c20d0be30ef53a62614b99af86622d65e607f%2Fimage%20(6).png?alt=media" alt="The Audit Logs table showing recent   workspace activity"><figcaption></figcaption></figure>

### 로그 읽기

각 행은 단일 이벤트를 나타내며 다음 항목을 포함합니다.

| 열         | 설명                                         |
| --------- | ------------------------------------------ |
| **타임스탬프** | 작업이 발생한 시각(UTC)입니다.                        |
| **작업자**   | 작업을 수행한 사용자, API 키 또는 시스템입니다.              |
| **작업**    | 수행된 작업입니다(생성, 업데이트, 삭제, 역할 변경 등).          |
| **리소스**   | 작업 대상 객체입니다(구성원, 프로젝트, 워크플로, 디바이스, 역할 등).  |
| **세부 정보** | 행을 클릭하면 이전 값과 새 값을 포함한 전체 변경 내역을 볼 수 있습니다. |

#### 필터링

테이블 상단의 필터 4개를 사용해 표시 항목을 좁힐 수 있습니다.

* **작업자** - 개별 사용자, API 키 또는 작업자 유형으로 필터링합니다.
* **작업** - 작업 유형(예: `member_added`, `project_deleted`).
* **)으로 필터링합니다.** 리소스
* **- 특정 리소스 또는 리소스 유형으로 필터링합니다.** - 폴더 자체에서 발생한 생성 또는 액세스 변경과 같은 이벤트로 필터링합니다. 폴더 안의 프로젝트에 대한 이벤트는 포함하지 않습니다. 폴더와 **리소스** 는 하나의 필터이므로 폴더를 선택하면 리소스 선택이 대체됩니다. 모든 폴더를 선택하면 모든 폴더 이벤트가 표시됩니다. 필터를 지우려면 **리소스** 에서 모든 리소스를 선택합니다.

스크롤하면 테이블에 항목이 더 로드됩니다. 감사 로그는 기본적으로 최근 **365일** 동안 조회할 수 있습니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-e3ffc4447337d7052409422b25f465cf728b0918%2Fimage%20(449).png?alt=media" alt="The filter row at the top of the Audit Logs table."><figcaption></figcaption></figure>

### 기록되는 항목

감사 로그에는 다음 활동 범주가 기록됩니다.

| 범주               | 예시                                                                                                   |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| **팀 구성원**        | 구성원 추가 또는 제거, 초대 전송 또는 취소, 역할 변경, 기본 역할 변경, 폴더 액세스 권한 변경                                             |
| **사용자 지정 역할**    | 사용자 지정 역할 활성화, 역할 생성·수정·삭제                                                                           |
| **폴더**           | 폴더 생성·수정·삭제 또는 복원, 폴더에 대한 사용자 또는 그룹 액세스 권한 변경                                                        |
| **프로젝트**         | 프로젝트 생성·수정·삭제 또는 복원                                                                                  |
| **데이터 세트 및 이미지** | 원본 이미지 업로드, 이미지 삭제 또는 승인, 데이터 세트에 이미지 추가 또는 제거, 이미지 분할 지정, 버전 삭제 또는 복원                               |
| **워크플로**         | 워크플로 생성·수정·게시·삭제 또는 복원, 워크스페이스에서 워크플로 블록 허용 또는 차단                                                    |
| **학습 및 내보내기**    | 학습 실행 시작 또는 중지, 데이터 세트 내보내기, 검색 결과 내보내기, 모델 가중치 다운로드                                                 |
| **디바이스 및 스트림**   | 디바이스 생성·수정·삭제, 스트림 추가·제거·일시 중지·재개·수정, 디바이스 명령 실행                                                     |
| **비전 이벤트**       | 대시보드 또는 API에서 운영자 피드백을 포함한 이벤트 삭제                                                                    |
| **API 키**        | 워크스페이스, 폴더 및 디바이스 키의 생성·수정·폐기·교체를 포함합니다. 수정 항목에는 이름 변경, 권한 변경, 메타데이터 변경, 기본 키 할당, 활성화 및 비활성화가 기록됩니다. |
| **OAuth 앱**      | OAuth 앱 생성·수정·폐기, 클라이언트 시크릿 교체, 앱 설치 또는 설치 취소, 사용자 동의 승인 또는 철회, 앱 액세스 정책 변경                          |
| **SIEM 구성**      | SIEM 통합 설정 업데이트                                                                                      |

### SIEM 내보내기

{% hint style="info" %}
SIEM 통합은 일부 Enterprise 플랜 고객에게 제공되는 프리미엄 기능입니다. [영업팀에 문의하여](https://roboflow.com/sales) SIEM 통합에 대한 액세스 권한을 받으세요.
{% endhint %}

SIEM 통합은 OpenTelemetry(OTLP)를 통해 보강된 감사 로그 이벤트를 SIEM으로 스트리밍하므로, Roboflow 활동을 나머지 보안 텔레메트리와 함께 중앙에서 관리할 수 있습니다.

#### 지원되는 전송 방식

| 프로토콜              | 기본 포트 | 엔드포인트 형식                                             |
| ----------------- | ----- | ---------------------------------------------------- |
| **gRPC**          | 4317  | 기본 URL만 - `https://collector.example.com:4317`       |
| **HTTP/Protobuf** | 4318  | 전체 경로 - `https://collector.example.com:4318/v1/logs` |

#### SIEM 통합 구성

1. 에서 **워크스페이스 설정 → 감사 로그**, **SIEM 통합** 탭을 엽니다.
2. 전환하여 **SIEM 통합 활성화**.
3. 항목에 **OTLP 엔드포인트 URL**.
4. 을 입력하고 **프로토콜** (gRPC 또는 HTTP/Protobuf)을 선택합니다.
5. (선택 사항) 입력 **헤더를** JSON 형식으로 입력합니다. 일반적으로 전달자 토큰을 사용합니다. 예: `{"Authorization": "Bearer your-token"}`.
6. 을 클릭해 **연결 테스트** 컬렉터가 요청을 수락하는지 확인합니다.
7. 을 클릭해 **저장**.

#### 연결 테스트

**연결 테스트** 는 현재 양식에 입력된 값으로 컬렉터에 최소 OTLP 요청을 보냅니다(저장하지 않음). 테스트에 성공하면 엔드포인트에 연결할 수 있고 헤더 인증이 올바르게 작동하는 것입니다.\ <br>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-daff89f7c26d6fff97b79f3637687f1470568cd4%2Fimage%20(453).png?alt=media" alt="A successful Test Connection   result."><figcaption></figcaption></figure>

#### 문제 해결

* **연결 거부 / 시간 초과** - 엔드포인트 호스트와 포트를 확인하고, 컬렉터에 공용 인터넷에서 연결할 수 있는지 확인합니다.
* **컬렉터에서 401 / 403 응답** -  `Authorization` 헤더 값과 전달자 토큰의 유효성을 확인합니다.
* **TLS 오류** - 컬렉터가 공인 인증 기관(CA)에서 신뢰하는 인증서를 제공하는지 확인합니다.
* **HTTP/Protobuf 경로 불일치** - HTTP/Protobuf를 사용하는 경우 엔드포인트에 전체 로그 경로를 포함해야 합니다(예: `/v1/logs`). gRPC의 경우 기본 URL만 사용합니다.

SIEM 통합 탭에서 변경한 사항 자체도 감사 로그에 다음과 같은 `siem_config_updated` 이벤트로 기록됩니다.\
\
**연결 테스트** 는 현재 양식에 입력된 값으로 실제 OTLP 로그 레코드를 컬렉터에 보냅니다(저장하지 않음). 따라서 연결이 열렸는지만 확인하는 것이 아니라 SIEM 측에서 통합이 처음부터 끝까지 제대로 작동하는지 확인할 수 있습니다.

몇 초 내에 테스트 이벤트가 SIEM에 표시됩니다. 아래 스크린샷은 Honeycomb에 이벤트가 도착하는 모습을 보여 줍니다. 같은 이벤트는 모든 OTLP 호환 백엔드(Splunk, Elastic, Datadog, OTel 컬렉터 등)에서도 확인할 수 있습니다. 다음을 검색하세요. `audit.action = test_connection`.<br>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-4397e4a34fdc398e96cb265c7f6e10d173da404d%2Fimage%20(463).png?alt=media" alt=""><figcaption></figcaption></figure>
