このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Risk Exchange モジュールを使用して Proofpoint v1.0.0 プラグインを構成する方法について説明します。 このプラグインはTAPダッシュボード > 人物ページでProofpointのユーザーの攻撃インデックスを取得します VAPモジュール。 このプラグインは、Proofpointのユーザーに対して何らかの操作を実行することをサポートしていません。
Netskope の正規化スコアの計算は、ユーザー > (1 – ((ユーザーの攻撃インデックス – ユーザーの攻撃インデックスの最小値) / (ユーザーの攻撃インデックスの最大値 – ユーザーの攻撃インデックスの最小値)) * 999) + 1 で行います。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
- ProofpointのURL、ユーザー名、パスワード。
- 以下のホストへの接続: https://tap-api-v2.proofpoint.com
Proofpointプラグインのサポート
このプラグインは Proofpoint TAPダッシュボード > 人物ページからユーザーの攻撃インデックスを取得します VAPモジュール。 このプラグインは、Proofpointのユーザーに対して何らかの操作を実行することをサポートしていません。
| 取得したデータの種類 | Actions |
|---|---|
| ユーザー | アクションなし |
マッピング
マッピングは 取得されたユーザーとそのそれぞれの詳細を表示します。 プラグイン設定時にマッピングされたフィールドは、データが取得されるとレコードページに表示されます。以下は、プラグインの設定時に使用すべき推奨マッピングです。 プラグインの設定時に使用してください。
ユーザー向けプルマッピング
| プラグインフィールド | 想定されるデータ型 | 提案されたフィールド名 | 提案された集約戦略 |
|---|---|---|---|
| ユーザーの電子メール | String | ユーザーの電子メール | Unique |
| ユーザー攻撃インデックス | Number | ユーザー攻撃インデックス | Overwrite |
| Netskope正規化スコア | Number | Netskope正規化スコア | Overwrite |
正規化スコアの計算
Netskope のユーザー正規化スコアの計算 => (1 – ((ユーザーの攻撃インデックス – ユーザーの攻撃インデックスの最小値) / (ユーザーの攻撃インデックスの最大値 – ユーザーの攻撃インデックスの最小値)) * 999) + 1。
権限
ユーザーは管理者ユーザーの役割を持っている必要があります。
APIの詳細
使うAPI一覧
| API Endpoint | Method | Use Case |
|---|---|---|
| /v2/people/vap | 得る | Fetch Users |
Fetch Users
API Endpoint: <Proofpoint URL>/v2/people/vap
Method: GET
Params
| 鍵 | Value |
|---|---|
| window | <Proofpoint Date Range>＜プルーフポイント日付範囲＞ |
| size | 5000 |
| page | 1 |
Auth
| 鍵 | Value |
|---|---|
| ユーザー名 | <Proofpoint Username> |
| password | <Proofpoint Password> |
Sample API Response
"users": [
{
"identity": {
"guid": "c23d2fc6-adb1-c625-0a4b-9cad87bc0a6d",
"customerUserId": null,
"emails": [
"user@example.com"
],
"name": null,
"department": null,
"location": null,
"title": null,
"vip": false
},
"threatStatistics": {
"attackIndex": 341679,
"families": [
{
"name": "credential phishing",
"score": 3551651
},
{
"name": "malspam",
"score": 411
},
{
"name": "stealer",
"score": 150
}
]
}
}
],
"totalVapUsers": 3965,
"interval": "2025-01-02T05:21:10Z/2025-01-16T05:21:10Z",
"averageAttackIndex": 293.44128,
"vapAttackIndexThreshold": 5193.266
}
パフォーマンスマトリックス
以下は、Proofpointプラグインで1万件のユーザーレコードを取得することにより、これらのVM仕様を持つ大規模CEスタックで実施されたパフォーマンス測定結果です。
| デスクリプション | 仕様 |
|---|---|
| スタックの詳細 | サイズ：大 RAM：32 GB CPU：16コア |
| リスクスコアとともに取得したユーザーレコードを保存するのにかかる時間 | 約1分 |
ユーザーエージェント
netskope-ce-5.1.0-cre-proofpoint-v1.0.0
ワークフロー
- Proofpointユーザーを作成します。
- Proofpoint APIトークンを作成します。
- Proofpointプラグインの設定。
- ビジネスルールを追加します。
- アクションを追加します。
- プラグインを検証する
Proofpointユーザーを作成する
- Proofpointにログインしてください。
- TAP Dashboard > Settings > Privileges .
へ移動してください。
- Add Dashboard Userをクリックしてください。
- 電子メール アドレスを入力し、管理ユーザー アクセスを選択して、アラートの受信を有効にします。
- Addをクリックしてください。
プルーフポイントを作成する クレデンシャル
- TAP Dashboard > Settings > Connected Applicationsへ移動してください。
- Create New Credential .
をクリックしてください
- 名前を入力してGenerateをクリックしてください。プラグインを設定する際は、ユーザー名とパスワードを控えておいてください。 プラグインを設定する際。
Proofpointプラグインの設定
- Cloud Exchangeで Settings > Pluginsに行ってください。Proofpoint v1.0.0 (CRE)プラグインボックスを検索して選択します。
- 基本情報を入力してください。
- Configuration Name: 設定の名前を入力してください。
- Sync Interval: このプラグインソースからデータを取得する間隔。
- Nextをクリックして、設定パラメータを入力してください。
- Proofpoint URL: Proofpoint API エンドポイント URL。
- Proofpoint Username: Proofpoint APIのユーザー名。
- Proofpoint Password: Proofpoint APIのパスワード。
- Date Range: Proofpoint APIからユーザーとスコアを取得する日付範囲（日数）。
- Nextをクリックし、エンティティのドロップダウンからエンティティを選択します。エンティティフィールドは、スキーマエディタページから作成することも、 フィールドのドロップダウンから+ Add Fieldオプションを選択することもできます。
現場のマッピング情報を提供してください。推奨されるマッピングについては、 「マッピング」セクションを参照してください。
- Save .
をクリックしてください
Proofpoint のリスク交換ビジネスルールを追加する
ビジネス ルールを使用してユーザーをフィルタリングします。 ビジネスルールを設定するには、以下の手順に従ってください。
- Risk ExchangeでBusiness Rulesに移動し、 Create New Ruleをクリックします。
- ビジネスルール名をSelectし、エンティティを選択し、アクションを実行するために必要なフィルターを提供します。Saveをクリックしてください。
Proofpoint のリスク交換アクションを追加する
Proofpointは「何もしない」アクションのみをサポートしています。
No Action
この操作では、いかなる動作も実行されません。この操作を実行すると、チケットオーケストレーターモジュールでUBAアラートを生成できます。
- Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。
- ビジネスルール、プラグインの設定、およびアクション（アクションなし） Select 。
- Generate Alert Ticket Orchestratorでアラートを生成するアクションを作成する際に、この機能を有効にする必要があります。Ticket Orchestratorモジュールが有効になっていることを確認してください。
- Saveをクリックしてください。
Netskopeテナント上で、Proofpointから取得したユーザーに対してその他の操作を実行できます。
Proofpointプラグインを検証する
Cloud Exchangeで検証する
Proofpointから取得したユーザーレコードを検証するには、 Loggingに移動して、CRE Proofpointプラグインから取得したログを検索してください。
Example: message Like “[CRE Proofpoint]”
取得したデータを確認するには、 Recordsに移動し、Proofpoint プラグインの設定時に選択したエンティティのタイプを選択してください。 Proofpoint プラグインの設定時に選択したエンティティのタイプを選択してください。 取得したレコードを確認してください。
Proofpointプラグインで実行されたアクションについては、 Loggingにあるログを確認してください。
アクションの設定中に「承認が必要」トグルが有効になっている場合は、上記のアクションログページから保留中の承認エントリを選択して承認を行い、 Approvalトグルを有効にしてください。
Proofpointで検証する
このプラグインは、ProofpointのTAPダッシュボードの「ユーザー」ページから、ユーザーとそのユーザーに対応する攻撃インデックスを取得します。
Proofpointプラグインのトラブルシューティング
プラグインのワークフローでエラーが発生しました
CRE Proofpoint [configuration_name]: Validation error occurred, Received exit code 401, Unauthorized, Verify Password provided in the configuration parameters.
What to do: Proofpointのパスワードを確認してください。
Proofpointからユーザーが引き抜かれることはありません
ユーザーのデータが取得できない場合、原因は以下のいずれかである可能性があります。
- プラットフォーム上にプル可能なユーザーがいません。
- マッピング機能はプラグインには含まれていません。
What to do:
- Proofpointにアクセスし、 TAPダッシュボードの「ユーザー」ページからユーザーが取得可能かどうかを確認してください。
- プラグインの設定を編集し、「エンティティソース」ページを確認してください。同じ情報を取得するには、いくつかのフィールドをマッピングする必要があります。
制限事項
APIでは、24時間以内に最大50件のリクエストが可能です。この制限を超過した場合、APIは24時間後に再び利用可能になります。APIのレート制限の詳細については、Proofpoint People APIのドキュメントを参照してください。
Proofpointへのリクエストが多すぎる場合、プラグインはこのエラーを表示します。
CRE Proofpoint [configuration_name]: Received exit code 429, API rate limit exceeded while fetching users for page 3 from Proofpoint. Max retries for rate limit handler exceeded hence returning status code 429.