リリースノート
2.0.0
Added
- IoC(侵害指標)の撤回に関するサポートを追加しました。
- CE v6.0.0以降、エラーログの解決機能を追加しました。
- URLを種類(ドメイン、FQDN、URL)ごとに分割する機能を追加しました。
- APIレート制限の処理機能を追加しました。
Changed
- エラー処理を改善しました。
1.0.0
Added
- 初回リリース
このドキュメントではCloud Exchangeプラットフォームで Proofpoint v2.0.0 プラグインを構成する方法について説明します。 このプラグインは Proofpoint TAP (標的型攻撃対策) ダッシュボードの「脅威」から、URL、SHA256、ドメイン、FQDN タイプの IoC を取得します。 このプラグインは、Proofpointからのインジケーターのプル削除をサポートしています。このプラグインは、Proofpoint プラットフォームへのインジケーターの共有をサポートしていません。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント(または、例えば本番環境と開発/テスト環境など、複数のテナント)。
- Netskopeテナント上のファイルプロファイル。
- A URL List on your Netskope tenant.
- A Destination Profile on your Netskope tenant.
- A DNS Profile on your Netskope Tenant
- Netskope Cloud Exchangeテナントには、テナントプラグインと脅威交換プラグインが既に設定済みです。
- Proofpoint プラットフォームへの接続。
- 以下のホストへの接続: https://tap-api-v2.proofpoint.com 。
Proofpointプラグインのサポート
このプラグインは Proofpoint TAP (標的型攻撃対策) ダッシュボードの「脅威」から、URL、SHA256、ドメイン、FQDN タイプの IOC を取得します。 このプラグインは、Proofpointからのインジケーターのプル削除をサポートしています。このプラグインは、Proofpoint プラットフォームへのインジケーターの共有をサポートしていません。
| 取得したインジケータータイプ | 共有指標タイプ |
|---|---|
| URL、SHA256、ドメイン、FQDN | サポートされていません |
インジデントの指標撤回
IoC Retraction (Pull): 指標はProofpointから取得され、その後のプルサイクルでも取得されます。Proofpointから一部の指標が削除された場合、Cloud Exchangeでは「取り消し済み」とマークされます。
IoC Retraction (Push): Cloud Exchangeに存在する取り下げられた指標は、共有時にProofpointから削除されます。
| タイプ | デスクリプション |
|---|---|
| IoCリトラクション(プル) | はい |
| IoCリトラクション(プッシュ) | いいえ |
マッピング
プルマッピング
| Netskope CTEフィールド | Proofpoint APIフィールド | タイプ |
|---|---|---|
| threatStatus | threatStatus | String |
| interval | interval | Datetime |
| sinceSeconds | sinceSeconds | Integer |
| eventTypes | eventTypes | String |
APIの詳細
使うAPI一覧
| APIエンドポイント | 方法 | Use case |
|---|---|---|
| /v2/siem/all | 得る | クレデンシャルインジケーターとプルインジケーターを検証する |
クレデンシャルまたはプルインジケーターを検証する
API Endpoint: https://tap-api-v2.proofpoint.com/v2/siem/all
Method: 得る
Request Parameters:
| パラメータ | Value |
|---|---|
| format | “JSON” (default) |
| interval | “2024-01-01T00:00:00Z/2024-01-01T01:00:00Z” |
| sinceSeconds | 3600 |
| threatStatus | "アクティブ" |
| ユーザーエージェント | netskope-ce-5.1.2-cte-proofpoint-v2.0.0 |
Sample API Response:
{
"clicksPermitted": [
{
"url": "https://example.com/malicious",
"threatTime": "2024-01-01T12:00:00Z",
"threatURL": "https://threatinfo.proofpoint.com/...",
"classification": "malware"
}
],
"clicksBlocked": [
{
"url": "https://blocked-site.com",
"threatTime": "2024-01-01T12:30:00Z",
"threatURL": "https://threatinfo.proofpoint.com/...",
"classification": "phish"
}
],
"messagesDelivered": [
{
"threatsInfoMap": [
{
"threat": "abc123def456...",
"threatType": "attachment",
"threatTime": "2024-01-01T13:00:00Z",
"threatUrl": "https://threatinfo.proofpoint.com/...",
"classification": "malware"
},
{
"threat": "https://malicious-url.com",
"threatType": "url",
"threatTime": "2024-01-01T13:15:00Z",
"threatUrl": "https://threatinfo.proofpoint.com/...",
"classification": "phish"
}
]
}
],
"messagesBlocked": [
{
"threatsInfoMap": [
{
"threat": "def789ghi012...",
"threatType": "attachment",
"threatTime": "2024-01-01T14:00:00Z",
"threatUrl": "https://threatinfo.proofpoint.com/...",
"classification": "spam"
}
]
}
]
}
パフォーマンスマトリックス
この読み取りは、下記の仕様を持つ大規模なCEスタック上で、各ページから10万個のIOCを取得し、Proofpointに10万個のIOCを送信することによって実施されます。
| デスクリプション | 仕様 |
|---|---|
| スタックサイズ | 大容量 RAM: 32 GB コア: 16 |
| Proofpointから取得した指標 | ~34.5k per min |
ユーザーエージェント
netskope-ce-6.1.0-cte-proofpoint-v2.0.0
ワークフロー
- Proofpoint からクレデンシャルを入手してください。
- Proofpointプラグインを設定します。
- Proofpointプラグインのビジネスルールを設定します。
- Proofpointプラグインの共有設定を行います。
- Proofpointプラグインを検証します。
動画を見る
再生ボタンをクリックして動画をご覧ください。
Proofpoint からクレデンシャルを入手
-
Proofpoint TAP ダッシュボードにログインして、 Settingsに移動します。

-
設定で、 Connected Applicationsに移動します。

-
Create New Credentialをクリックしてください。

-
名前を入力し、クレデンシャルの外部サービスを選択します。

-
生成されたService PrincipalとSecretをコピーし、使うとしてプラグインを設定 Cloud Exchange。 完了したら、 Doneをクリックしてください。

Proofpointプラグインの設定
-
Cloud Exchange で、 Settings > Plugin Storeに移動します。
-
Proofpoint v2.0.0 (CTE)プラグインを検索して選択してください。

-
基本情報を入力してください:
- Configuration Name: 設定の一意の名前。
- Sync Interval: このプラグインからデータを取得し、他のソースからこのプラグインにデータを共有するための間隔。
多数のIoCを取得したい場合は、同期間隔の値を大きくする方が良いことに注意してください。 - Aging Criteria: プラグインの有効期限(日数)(デフォルト:90日)
- Override Reputationこの設定から受信したインジケーターの評判を上書きする値を設定します。
- Enable SSL ValidationSSL証明書の検証を有効にします。

-
Nextをクリックして、設定パラメータを入力してください。
- Base URL: Proofpoint TAP API Base URL, like https://tap-api-v2.proofpoint.com.
- Username: プルーフポイント サービスプリンシパル。
- Password: プルーフポイントの秘密。
- Event Types: Proofpointから脅威指標(URL、SHA256、ドメイン、FQDN)を取得するイベントの種類Select 。 イベントの種類が選択されていない場合、デフォルトで全てのイベントの種類が含まれます。
- Enable Tagging: タグ付け機能を有効/無効にします。
- Retraction Interval: 使うまでの時間数を、Proofpoint IoC(s)のリトラクション間隔として示します。 有効な値の範囲は1時間から168時間です。このパラメータは、脅威交換設定でIoC(侵害指標)の撤回が有効になっている場合にのみ考慮されます。
- Initial Range: 初回実行時に脅威IoCを取得するのに必要な時間数。有効な値の範囲は1時間から168時間です。

-
Saveをクリックしてください。

Proofpoint の Threat Exchange ビジネスルールを設定する
Proofpointから取得した指標をCloud Exchangeに共有するには、共有したい指標をフィルタリングするビジネスルールが必要です。
-
Threat ExchangeでBusiness Rulesに移動し、 Create New Ruleをクリックします。
-
ルールに、要件に応じたフィルターを追加してください。

-
Saveをクリックしてください。

Proofpointプラグインの脅威交換共有を設定する
ProofpointからNetskope Cloud ExchangeにIoCを共有するには:
- Threat ExchangeでSharingへ移動し、 Add Sharing Configurationをクリックします。
- ソース構成(CTE Proofpoint)、ビジネスルール、宛先構成(CTE Netskope )、およびターゲットをSelect 。
- Saveをクリックしてください。

注記
- ProofpointプラグインはIoC(侵害指標)の共有をサポートしていませんが、このプラグインから取得したIoCは他のサードパーティプラットフォームと共有できます。
- Threat Exchangeの共有設定に関する詳細については、 Netskope Threat Exchangeプラグインガイドを参照してください。
Proofpointプラグインを検証する
プルを検証する
Cloud Exchange で取得したログを確認するには、 Loggingにアクセスして、CTE Proofpoint プラグインからログを検索してください。ログをフィルタリングできます フィルタ: message Like “[]”<plugin configuration name> 。

抽出されたデータは、脅威IoC(侵害指標)ページに掲載されます。プラットフォームから取得した IoC をフィルタリングするには、フィルタを使用します: sources.source<plugin configuration name> “” のようにします 。

プルリトラクションを検証する
取り下げられた IoC を確認するには、ログで IoC Retraction の例を確認します: message Like CTE Proofpoint [CTE Proofpoint] [Retraction]。

プラットフォームからフィルターを使用して、撤回された IoC をフィルターできます <plugin configuration name>。


注記
- 撤回期間外のIoCは、Cloud Exchangeで「撤回済み:はい」とマークされます。
- また、このプラグインはアクティブなインジケーターのみを取得するため、最初にアクティブな状態で取得され、その後誤検出またはクリアに更新されたインジケーターは取り下げられたものとしてマークされます。
- 共有結果は、共有設定を作成した後にソースプラグインからIoCが取得された場合にのみマークされます。
プッシュ通知を検証する
ここでは、Netskopeテナントの宛先プロファイルにIoC(侵害指標)が追加されたことが確認できます。


その後、共有されていたIoCの一部が撤回済みとしてマークされたため、リストから削除されました。

Proofpointプラグインのトラブルシューティング
Proofpoint プラットフォームから IoC を取得できない
プラグインの設定後、プラットフォームからIoCが取得されない場合は、以下のいずれかの理由が考えられます。
- プラットフォーム上にはプル可能なIoCがありません
- 指定された構成パラメータ(初期範囲など)では、IoCは利用できません。
What to do: 上記から根本原因を特定し、以下のいずれかの手順に従って問題を解決してください。
No IoCs are available on the platform to pull:
プラットフォーム上でIoC(侵害指標)が利用可能かどうかを確認してください。可能であれば、次の項目の解決策を確認してください。
IoCs are not available for the given time range
プラットフォーム上でIoCが取得可能であるにもかかわらず、プラグインがCEでIoCを取得していない場合は、プラグイン設定の初期範囲パラメータで指定されている日数を確認してください。Proofpoint プラットフォームで、指定された時間範囲のデータがあるかどうかを確認します。

