> ## 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 / Webhook の統合

> SecureAI セキュリティ ログを任意のカスタム HTTP エンドポイントに送信するための汎用 SIEM (HTTP/Webhook) 統合

# 汎用 SIEM (HTTP/Webhook) 統合

## 概要

汎用 SIEM (HTTP/Webhook) 統合により、SecureAI セキュリティ ログを任意のカスタム HTTP エンドポイントに送信できます。これは、ネイティブ サポート、カスタム セキュリティ ツール、または HTTP ベースのログ システムを持たない SIEM システムとの統合に最適です。

## 使用例

* **カスタム SIEM システム**: 社内のセキュリティ監視ツールにログを送信します。
* **サードパーティのセキュリティ プラットフォーム**: Webhook を受け入れるセキュリティ ツールと統合します。
* **カスタム ダッシュボード**: 独自のセキュリティ イベントの視覚化を構築します。
* **テストと開発**: Webhook テスト サービスを使用してログ配信を検証します。
* **レガシー システム**: HTTP エンドポイントのみをサポートする古いセキュリティ ツールに接続します。

## 構成手順

### 1. テストエンドポイントを取得する

テスト目的では、webhook.site を使用することをお勧めします。

1. [https://webhook.site](https://webhook.site) にアクセスします。
2. 一意の URL (例: `https://webhook.site/ae0761ed-7939-4d86-be2f-ed58d0e65dd3`) をコピーします。
3. 受信 Webhook を監視するには、このページを開いたままにしてください

<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 カテゴリで **「汎用 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 エンドポイントのみをサポートする古いセキュリティ ツールに接続します。
* **テストと開発**: Webhook テスト サービスを使用して、運用展開前にログ配信を検証します。

**注意**: サポートされている SIEM (Splunk、Microsoft Sentinel、Elastic) をすでにお持ちの場合は、最適なパフォーマンスと機能を得るためにネイティブ統合を使用することをお勧めします。

## トラブルシューティング

### 一般的な問題

1. **接続タイムアウト**: エンドポイントがアクセス可能で応答しているかどうかを確認します。
2. **認証エラー**: API キーと認証ヘッダーを確認します
3. **SSL/TLS の問題**: HTTPS エンドポイントの証明書が適切に検証されていることを確認する

### モニタリング

* SecureAI 管理パネルで統合ステータスを確認します。
* Webhook 配信の成功率を監視する
* 失敗した Webhook 試行をログで確認します。
* エンドポイントの可用性と応答時間を確認する

## セキュリティに関する考慮事項

* **HTTPS のみ**: 運用環境では常に HTTPS エンドポイントを使用します
* **認証**: Webhook エンドポイントに適切な認証を実装します。
* **レート制限**: エンドポイントに適切なレート制限を構成します。
* **ログ保持**: コンプライアンスのために適切なログ保持ポリシーを実装します。
* **アクセス制御**: Webhook エンドポイントへのアクセスを承認されたシステムのみに制限します

## ベストプラクティス

1. **小規模から開始**: 重要なイベント カテゴリから始めて、徐々に拡大していきます。
2. **徹底的にテストします**: 初期テストには webhook.site または同様のサービスを使用します。
3. **パフォーマンスの監視**: Webhook 配信の遅延や失敗を監視します。
4. **ドキュメント設定**: Webhook 設定の詳細な記録を保存します。
5. **定期的なレビュー**: Webhook 構成を定期的に確認して更新します。
6. **バックアップ計画**: Webhook が失敗した場合に備えて、代替のログ記録方法を用意する

## 完了しました!

これらの手順により、カスタム Webhook インスタンスは SecureAI と統合するように完全に構成されます 😎。