---
title: "カスタム HTTP プッシュ統合を使用してデータを送信する"
slug: "integrating-cato-data-with-custom-http-push"
updated: 2026-10-23T23:15:28Z
published: 2026-10-23T23:15:28Z
canonical: "knowledge.catonetworks.com/integrating-cato-data-with-custom-http-push"
---

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

# カスタム HTTP プッシュ統合を使用してデータを送信する

## 概観

専用の Cato 統合がないシステムにデータを送信する組織のために、カスタム HTTP プッシュ統合を提供します。

イベントと任意のフローを、JSON または改行区切りの JSON (NDJSON) を受け入れる任意の外部プラットフォームに直接ストリームするためにカスタム HTTP プッシュ統合を使用してください。データは、定期的に取得されるのではなく、生成されるとすぐに継続的にプッシュされます。これにより、下流のシステムはポーリングせずに、ほぼリアルタイムの更新を受け取ることができます。

### 共通のユースケース

- **SIEMおよびSOCプラットフォーム -** サンプル会社は[疑わしい活動のモニタリング機能](https://knowledge.catonetworks.com/v1/docs/monitoring-suspicious-activity-with-ips-sam)を使用し、高いセキュリティイベントを生成しています。彼らはこのデータを既存のSIEMプラットフォームと集中化することを決定しましたが、専用のCato統合はありません。サンプル会社はイベント統合を有効化し、カスタムHTTPプッシュ統合をSIEMのHTTPインジェストエンドポイントに向けて設定することで、すべてのIPSイベントが他のセキュリティデータとともに相関、アラート、長期保存のためにSIEMに自動ストリーミングされます。
- **カスタムログ収集とアナリティクス -** サンプル会社は運用報告のためにCatoイベントデータを内部のアナリティクスパイプラインに投入したいと考えています。彼らはHTTPベースのログコレクタを起動し、データを受け取って、彼らのCatoアカウントでカスタムHTTPプッシュ統合を設定し、イベントが生成される度に収集機に継続的にプッシュされるようにします。

### 配信信頼性

データはベストエフォートで送信されます。宛先のエンドポイントが利用できなくなる、または認証エラーを返す場合、Catoは以下のスケジュールに従って自動的に再接続を試みます。

- **短期リトライ:** 1 分、5 分、10 分、15 分、1 時間、6 時間、および 24 時間
- **延長リトライ:** 最初の24時間後、7日間継続して毎日リトライ

統合が7日間接続できないままである場合は、エンドポイントの設定の問題が解決されるまで、統合全体の再試行が停止します。

### ネイティブ統合 vs. カスタムHTTPプッシュ

Catoはイベントを一般的なプラットフォームにエクスポートするための特別な統合を提供しており、[Splunk](/v1/docs/integrating-cato-data-with-splunk)、[Microsoft Sentinel](/v1/docs/integrating-cato-events-with-microsoft-sentinel)、[CrowdStrike](/v1/docs/integrating-cato-events-with-crowdstrike)、および[Azure Storage](/v1/docs/integrating-cato-events-with-azure-storage-account)を含みます。宛先にネイティブ統合が利用可能な場合は、それを使用することをお勧めします。その利点は、それがそのプラットフォームに最適化されており、プラットフォーム固有の機能を提供する可能性があることです。

専用の統合がない場合や、カスタムアプリケーションやサービスにイベントを配信する必要がある場合には、カスタムHTTPプッシュ統合を使用してください。

### フィルター

エクスポートするイベントを制御するためにフィルターを使用します。これにより、インジェストコストが削減され、ノイズが最小限に抑えられ、特定のサイト、ユーザー、または地域に最も関連するイベントに調査を集中させることができます。フィルターを使用して、異なるSIEM環境に異なるイベントのサブセットをルーティングすることもできます。

![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/36659528448669.png?sv=2026-02-06&spr=https&st=2026-11-10T17%3A11%3A08Z&se=2026-11-10T18%3A11%3A08Z&sr=c&sp=r&sig=ZcbhfhrD%2FOty8iGgHJ%2FexpFlBldjZ7H39W462i6mdS4%3D)

フィルターグループを使用して、[イベントフィールド](/v1/docs/understanding-event-fields)またはフィールドの組み合わせに基づいてフィルターを定義します。各グループ内の条件はANDロジックが使用されます。 ORロジックはグループ間で適用されます。スクリーンショットのフィルターでは、以下をエクスポートするように統合を構成します：

- **ニース**または**マドリード**発で、サブタイプが**インターネットファイアウォール**で、結果が**モニター**や**プロンプト**以外の**アクション**だったイベント
- **ユーザ名**にTestが含まれる

## 前提条件

カスタムHTTPプッシュ統合を設定する前に、宛先プラットフォームが以下のすべてをサポートしていることを確認してください：

- HTTP POSTまたはPUTリクエスト
- JSONまたは改行区切りJSON（NDJSON）
- 独自のリクエストボディ、ベンダー固有のラッパー、または追加の指示が不要な標準的なCatoペイロード

ペイロード構造は固定されています。フィールドを追加、削除、再配置することはできません。

要約：

- 宛先プラットフォームは、Catoが送信するそのままのプレーンJSONオブジェクトまたはNDJSONイベントストリームをインジェストできる場合に通常、互換性があります。例としては、SentinelOne、Securonix、Trend AIがあります。
- プラットフォームのAPIが、リクエストボディに追加されるべきプロプライエタリなペイロード構造（エンベロープ、ラッパー、制御ラインなど）を要求する場合、互換性がないとみなされます。例としては、ElasticやDatadogがあります。

## カスタムHTTPプッシュ統合を設定

### ステップ1: パラメータを収集する

ターゲットプラットフォームから取得:

- **インジェスションURL:** イベントを受け入れるHTTP（S）エンドポイント
- **認証の詳細:** 統合はカスタムヘッダー、APIキー、Bearerトークン、またはBasic認証をサポートします。もしベンダーが接頭辞を期待する場合（例: Bearer <token>）、接頭辞を含む全体を一つの値として入力してください。それはCato側で暗号化されて保存されています。

### ステップ2: curlでテスト

コマンドラインcurlリクエストを使用して、宛先を独立して検証してください。これにより、ベンダー側の問題（認証、エンドポイント、ペイロード受け入れ）がある場合は隔離され、コネクタセットアップで直接再利用可能なリクエストを得ることができます。

次の例では、Elastic が非成功のcurlリクエストを示しています。

```bash
curl -X POST "https://<your-elastic-endpoint>/_bulk" \
 -H "Authorization: ApiKey <KEY>" \
 -H "Content-Type: application/x-ndjson" \
 --data-binary $'{"create":{"_index":"logs-cato.events-default"}}\n{"message":"curlからのテストイベント","event_type":"test","timestamp":"2026-07-05T12:00:00Z"}\n'
```

これはコネクタの要件を満たさないことになりますが、curl呼び出し自体はElasticに対して成功することもあります。ペイロードには、イベントラインごとに「create」指示行が必要であり、統合はその追加行を挿入する方法を持っていません。なぜなら、ボディフォーマットが固定されているからです。

以下にSentinelOneの成功するcurlリクエストを示します。

```bash
curl -i "https://ingest.us1.sentinelone.net/services/collector/raw?sourcetype=cato_events" \
 -H "Authorization: <token>" \
 -H "Content-Type: application/x-ndjson" \
 --data-binary $'{"event_type":"test"}\n'
```

これは、SentinelOneのHEC生エンドポイントが行ごとのプレーンイベントオブジェクトを受け入れるため機能し、コネクタが送信するのとまったく同じです。このようにcurlテストが成功した場合、その内容をそのままコネクタセットアップに使用できます:

- **URL:** クエリパラメーターを含めたエンドポイント全体を貼り付けてください（例: ?sourcetype=cato_events)
- **Auth:** カスタムヘッダー → ヘッダー名 Authorization、値を実際のトークン（秘密として保存）に設定
- **Body:** コンテンツタイプをテストしたものに一致させます（application/x-ndjson ここに）

curlテストが成功した場合は、ステップ3に進みます。

### ステップ3: コネクタを設定

1. CMAで、**リソース > 統合 > 統合済み統合**に移動し、**新規**をクリックします。
2. **統合**の下で、**カスタムHTTP統合**を選択します。
3. **機能**の下で、**データエクスポート**を選択します。
4. **Auth**の下で、curlで検証したものと一致するメソッド（カスタムヘッダー、APIキー、Bearerトークン、またはBasic Auth）を選択します。
5. **名前**とオプション**説明**を入力します。
6. **URL**を入力します — curlでテストしたのと同じエンドポイントです。
7. **カスタムヘッダー**（または同等の認証項目）を追加します — 成功したcurlコマンドからヘッダー名と値を正確に引き継ぎます。各値は**秘密**または**プレーン**として保存できます。
8. **本文**の下で、コンテンツタイプを確認してください（デフォルトは`application/json`です；NDJSONもサポートされます）。 コネクタによって送信されるリクエストボディは**構成不可**です：カスタム項目を追加したり、ペイロードを再構築することはできません。
9. **データソース**で、**イベント**、**フロー**またはその両方を選択します。
10. （オプションとして）送信される内容を**イベントフィルター**および**フローフィルター**（設定済みのフィルターグループのいずれかに一致）を使用して絞ることができます。詳細は[上記のフィルター](/v1/docs/sending-cato-data-to-external-platforms-http-push#filters1)を参照してください。
11. **コネクタイベントでエラーを追跡**するかどうかを選択します。これを推奨するのは、配信の失敗がアラート可能なイベントとして露呈することになるからです。
12. 構成を保存し、ステータスに**接続済み**と表示されていることを確認します。

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

- **Curlが成功しましたが、Catoに接続エラーが表示されます:** Headers/AuthがCatoで入力した内容がcurlで使用したものと完全に一致することをダブルチェックしてください（例: Bearerのような必須接頭辞を含みます）。
- **外部プラットフォームにイベントが届かない:** イベントフィルタ/フローフィルタを確認してください。あまりにも狭いフィルタは、すべてを静かに除外する可能性があります。
- **ベンダーがペイロードを拒否:** 前提条件を確認してください。ベンダーはおそらくこのコネクタで対応できないカスタムボディ構造を要求しています。

## 記事への変更履歴

| 日付 | "説明" |
| --- | --- |
| 2026年8月04日 | - 詳細なユースケースを追加しました - [フィルター](/v1/docs/sending-cato-data-to-external-platforms-http-push#filters1) セクションを追加しました |

## FAQ

#### Q: 複数のエンドポイントに一度にプッシュできますか？

A: 宛先ごとに別々のカスタムHTTPプッシュ統合を構成する必要があります。

#### Q: これはネイティブ統合（Splunk、Sentinel、CrowdStrikeなど）に取って代わりますか？

A: いいえ。ネイティブCato統合が存在する場合は、それを使用してください。カスタムHTTPプッシュ統合は、専用の統合がないプラットフォーム、またはSIEM以外の宛先用です。

#### Q: ベンダーがサポートリストにない場合はどうしますか？

A: ベンダーのHTTPインジェスションAPIが、ラッパー構造が必要ないプレーンなJSONまたはNDJSONを受け入れるかどうかを確認してください。もしそうなら、まずcurlでテストし、このページの説明に従ってコネクタを構成してください。

#### Q: JSONボディをカスタマイズしたりフィールドを追加できますか？

A: いいえ。ペイロードスキーマは固定されています。