> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 맞춤형 SIEM/웹훅 통합

> SecureAI 보안 로그를 사용자 정의 HTTP 엔드포인트로 전송하기 위한 일반 SIEM(HTTP/Webhook) 통합

# 일반 SIEM(HTTP/웹훅) 통합

## 개요

Generic SIEM(HTTP/Webhook) 통합을 사용하면 SecureAI 보안 로그를 사용자 정의 HTTP 엔드포인트로 보낼 수 있습니다. 이는 기본 지원, 사용자 정의 보안 도구 또는 HTTP 기반 로깅 시스템이 없는 SIEM 시스템과 통합하는 데 적합합니다.

## 사용 사례

* **맞춤형 SIEM 시스템**: 사내 보안 모니터링 도구로 로그 전송
* **타사 보안 플랫폼**: 웹훅을 허용하는 보안 도구와 통합
* **맞춤형 대시보드**: 나만의 보안 이벤트 시각화 구축
* **테스트 및 개발**: 웹훅 테스트 서비스를 사용하여 로그 전달 확인
* **레거시 시스템**: HTTP 엔드포인트만 지원하는 이전 보안 도구에 연결

## 구성 단계

### 1. 테스트 엔드포인트 가져오기

테스트 목적으로 webhook.site를 사용하는 것이 좋습니다.

1. [https://webhook.site](https://webhook.site)를 방문하세요.
2. 고유 URL(예: `https://webhook.site/ae0761ed-7939-4d86-be2f-ed58d0e65dd3`)을 복사하세요.
3. 들어오는 웹훅을 모니터링하려면 이 페이지를 열어두세요.

<div class="mac-window">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hiper-ai/img/generic%20siem%20-%20Images/Generic%20SIEM%20-%201.png" alt="Webhook.site 테스트 엔드포인트" />
</div>

### 2. 통합 구성

1. SecureAI 관리자 패널에서 **통합**으로 이동합니다.
2. SIEM 카테고리에서 \*\*"Generic SIEM (HTTP/Webhook)"\*\*를 찾습니다.
3. \*\*"통합 연결"\*\*을 클릭하세요.

### 3. 구성을 입력합니다.

#### 기본 설정

* **통합 이름**: `Test Generic SIEM` (또는 설명이 포함된 이름)
* **엔드포인트 URL**: `https://webhook.site/ae0761ed-7939-4d86-be2f-ed58d0e65dd3`
* **HTTP 방법**: `POST` (대부분의 SIEM 플랫폼에 권장됨)
* **HTTP 헤더**: `{"Content-Type": "application/json"}`

<div class="mac-window">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hiper-ai/img/generic%20siem%20-%20Images/Generic%20SIEM%20-%202.png" alt="HTTP 헤더 구성" />
</div>

#### 이벤트 카테고리

전달할 이벤트 유형을 선택하세요.

✅ **테스트 권장 사항:**

* 인증 및 로그인
* API 및 모델 사용
* 데이터 액세스 및 PHI
* SMLTP 및 정책
* 청구 및 사용 한도
* 분석

⚠️ **선택 사항(많은 양이 생성될 수 있음):**

* 보안 및 위반
* 시스템 및 인프라
* 구성 변경

### 4. 연결 테스트

1. 연결을 확인하려면 \*\*"연결 테스트"\*\*를 클릭하세요.

<div class="mac-window">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hiper-ai/img/generic%20siem%20-%20Images/Generic%20SIEM%20-%203.png" alt="연결 테스트 버튼" />
</div>

2. webhook.site를 확인하세요. 테스트 요청이 표시되어야 합니다.
3. 응답에 성공이 표시되는지 확인합니다.

<div class="mac-window">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hiper-ai/img/generic%20siem%20-%20Images/Generic%20SIEM%20-%204.png" alt="성공 응답 확인" />
</div>

### 5. 저장 및 모니터링

1. \*\*"연결"\*\*을 클릭하여 구성을 저장합니다.
2. SecureAI 시스템에서 작업(로그인, API 호출 등)을 수행합니다.
3. webhook.site를 모니터링하여 실시간 로그 보기

## 고급 구성

### 사용자 정의 헤더

인증 또는 특정 요구 사항에 대한 사용자 정의 헤더를 추가할 수 있습니다.

```json theme={null}
{
  "Content-Type": "application/json",
  "Authorization": "Bearer your-api-key",
  "X-Custom-Header": "custom-value"
}
```

### 맞춤형 SIEM을 사용해야 하는 경우

사용자 정의 SIEM 통합은 다음 시나리오에서 특히 유용합니다.

* **SIEM 시스템 없음**: 현재 SIEM 플랫폼을 사용하지 않는 경우 보안 로그 수집을 시작하는 간단한 방법을 제공합니다.
* **추가 데이터 대상**: 동시에 여러 위치로 데이터 전송(예: 기본 SIEM + 백업 시스템)
* **맞춤 도구**: 전문 보안 도구, 데이터 센터 또는 맞춤 대시보드와 통합
* **커뮤니케이션 플랫폼**: Teams 채널, Slack 또는 기타 공동 작업 도구에 경고 보내기
* **레거시 시스템**: HTTP 엔드포인트만 지원하는 이전 보안 도구에 연결
* **테스트 및 개발**: 웹훅 테스트 서비스를 사용하여 프로덕션 배포 전에 로그 전달을 확인합니다.

**참고**: 지원되는 SIEM(Splunk, Microsoft Sentinel, Elastic)이 이미 있는 경우 최적의 성능과 기능을 위해 기본 통합을 사용하는 것이 좋습니다.

## 문제 해결

### 일반적인 문제

1. **연결 시간 초과**: 엔드포인트에 액세스할 수 있고 응답하는지 확인하세요.
2. **인증 오류**: API 키 및 인증 헤더 확인
3. **SSL/TLS 문제**: HTTPS 엔드포인트에 대한 적절한 인증서 유효성 검사를 보장합니다.

### 모니터링

* SecureAI 관리자 패널에서 통합 상태를 확인하세요.
* 웹훅 전달 성공률 모니터링
* 로그에서 실패한 웹훅 시도를 검토합니다.
* 엔드포인트 가용성 및 응답 시간 확인

## 보안 고려 사항

* **HTTPS 전용**: 프로덕션에서는 항상 HTTPS 엔드포인트를 사용합니다.
* **인증**: 웹훅 엔드포인트에 대한 적절한 인증 구현
* **비율 제한**: 엔드포인트에 적절한 비율 제한을 구성합니다.
* **로그 보존**: 규정 준수를 위해 적절한 로그 보존 정책을 구현합니다.
* **액세스 제어**: 웹훅 엔드포인트에 대한 액세스를 승인된 시스템으로만 제한합니다.

## 모범 사례

1. **작게 시작**: 필수 이벤트 카테고리로 시작하여 점진적으로 확장합니다.
2. **철저하게 테스트**: 초기 테스트에는 webhook.site 또는 유사한 서비스를 사용하세요.
3. **성능 모니터링**: 웹훅 전달 지연 또는 실패를 관찰하세요.
4. **문서 구성**: 웹훅 설정에 대한 자세한 기록을 유지하세요.
5. **정기 검토**: 웹훅 구성을 주기적으로 검토하고 업데이트합니다.
6. **백업 계획**: 웹훅이 실패할 경우를 대비한 대체 로깅 방법 마련

## 완료!

이러한 단계를 통해 Custom Webhook 인스턴스가 SecureAI와 통합되도록 완전히 구성되었습니다 8.