このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Threat Exchange モジュールを使用して Darktrace v1.0.0 プラグインを設定する方法について説明します。 このプラグインは、Darktraceの「監視対象ドメインとIPアドレス」ページから、ドメイン、FQDN、ホスト名、IPv4、IPv6タイプのIoC(侵害指標)を取得します。このプラグインは、ドメイン、FQDN、ホスト名、IPv4、IPv6を監視対象ドメインとIPアドレスのページに共有することをサポートしています。このプラグインは、DarktraceからのIoC(侵害指標)のプルおよびプッシュによる削除をサポートします。
前提条件
- Netskopeテナント(または、例えば本番環境と開発/テスト環境など、複数のテナント)
- Netskope Cloud Exchangeテナント(テナントプラグインと脅威交換プラグインが既に構成済み)
- Darktraceインスタンス
- 以下のホストへの接続: https:// <region> .cloud.darktrace.com/
Darktraceプラグインのサポート
このプラグインは、Darktraceの「監視対象ドメインとIPアドレス」ページから、ドメイン、FQDN、ホスト名、IPv4、IPv6タイプのIoC(侵害指標)を取得します。このプラグインは、ドメイン、FQDN、ホスト名、IPv4、IPv6を監視対象ドメインとIPアドレスのページに共有することをサポートしています。このプラグインは、DarktraceからのIoC(侵害指標)のプルおよびプッシュによる削除をサポートします。
| 取得したインジケータータイプ | 共有指標タイプ |
|---|---|
| ドメイン FQDN ホスト名 IPv4 IPv6 | ドメイン FQDN ホスト名 IPv4 IPv6 |
マッピング
プルマッピング
| Cloud Exchangeフィールド | APIフィールド | デスクリプション |
|---|---|---|
| value | name | – |
| タイプ | ホスト名 | Darktrace は、インジデントの指標がホスト名としてマークされている場合にのみ、タイプ (ホスト名) を提供します。 他のタイプについては、正規表現を使用してインジデントの指標タイプを見つけます。 インジデントの指標が提供された正規表現のいずれにも一致しない場合、URL タイプでマークされます。 |
| Reputation | strength | – |
| Comments | description | デスクリプションフィールド値 + 強みフィールド値 |
プルされたIoCの評判マッピング
| 入力(ダークトレース強度) | 出力( Cloud Exchange評判) |
|---|---|
| 1-10 | 1 |
| 11-20 | 2 |
| 21-30 | 3 |
| 31-40 | 4 |
| 41-50 | 5 |
| 51-60 | 6 |
| 61-70 | 7 |
| 71-80 | 8 |
| 81-90 | 9 |
| 91-100 | 10 |
プッシュマッピング
| APIフィールド | Cloud Exchangeフィールド/デフォルト値 | デスクリプション |
|---|---|---|
| addlist | value | Darktraceに共有されるIOCのリスト |
| strength | reputation | – |
| description | Netskope CE | <source_plugin_name> | ソースラベル |
| ホスト名 | true/false | 「正確なホスト名」アクションパラメータで選択された値。 |
| iagn | true/false | レスポンスアクションパラメータのフラグで選択された値。 |
共有IoCの評判マッピング
| 入力( Cloud Exchange評判) | 出力(ダークトレース強度) |
|---|---|
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
| 4 | 40 |
| 5 | 50 |
| 6 | 60 |
| 7 | 70 |
| 8 | 80 |
| 9 | 90 |
| 10 | 100 |
IoC撤回
- IoC リトラクション(プル):インジケーターは Darktrace から取得され、その後のプル サイクルで Darktrace 上で一部のインジケーターが削除された場合、Netskope Cloud Exchange でリトレース済みとしてマークされます。
- IoCの取り消し(プッシュ):Cloud Exchange に存在する取り消されたインジケーターは、共有中に<third-party platform> から削除されます。
注記
Darktraceプラグインでは、
- IoC(侵害指標)は、プラグイン設定で指定されたソースに基づいて取り消されます。
- IoC は、 アクション構成内のソース名から削除されます。
| 引き込みタイプ | サポートされているリトラクションタイプ |
|---|---|
| IoCリトラクション(プル) | はい |
| IoCリトラクション(プッシュ) | はい |
権限
以下の権限が必要です。
- ドメインを編集する
- Visualizer
- Edit Tags
APIの詳細
使うAPI一覧
| 使うケース | 方法 | Endpoint |
|---|---|---|
| 取得ソース名 | 得る | /intelfeed |
| IoC をプルする | 得る | /intelfeed |
| IoCをプッシュする | 役職 | /intelfeed |
| IoCを削除する | 役職 | /intelfeed |
ソース名を取得
API Endpoint: /intelfeed
Method: 得る
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.1-cte-darktrace-v1.0.0 |
Query Parameters
| 鍵 | Value |
|---|---|
| sources | true |
Sample Response
[
"Default",
"threatintel",
"external",
"cloud-exchange",
"netskope"
]
IoC をプルする
API Endpoint: /intelfeed
Method: 得る
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.1-cte-darktrace-v1.0.0 |
| Authorization | Bearer <Bearer Token> |
Query Parameters
| 鍵 | Value | デスクリプション |
|---|---|---|
| source | <source_name> | 設定パラメータで指定されたソース名 |
| fulldetails | true | – |
Sample API Response
[
{
"name": "101.44.42.56",
"strength": "45",
"description": "malicious IP",
"source": "threat"
},
{
"name": "db-08a3ed2f40.corp-internal.local",
"hostname": true,
"strength": "45",
"description": "malicious hostname",
"source": "threat"
},
]
IoCをプッシュする
Endpoint: /intelfeed
Method: 役職
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.1-cte-darktrace-v1.0.0 |
Request Body
{
"addlist": "malsite.malware.com,exploit.com,76.83.2.190",
"description": "Netskope CE | <3rd party plugin name>",
"strength": 50,
"source": "external-source"
}
Sample API Response
{
"response": "SUCCESS",
"added": 3,
"updated": 0,
"addedList": [
"malsite.malware.com",
"exploit.com",
"76.83.2.190"
]
}
IoCを削除する
API Endpoint: /intelfeed
Method: 役職
Headers
| 鍵 | Value |
|---|---|
| ユーザーエージェント | netskope-ce-6.0.1-cte-darktrace-v1.0.0 |
Request Body
{
"removeentry": "db-08a3ed2f40.corp-internal.local",
"source": "threatintel"
}
Sample API Response
{
"response": "SUCCESS"
}
パフォーマンスマトリックス
以下は、これらの仕様を持つ大規模Cloud Exchangeスタック上で、Darktraceとの間で10万個のインジケーターをプルおよび共有することによって実施されたパフォーマンス測定結果です。
| デスクリプション | 仕様 |
|---|---|
| スタックの詳細 | サイズ:大 RAM:32 GB CPU:16コア |
| Darktraceから取得したインジケーター | ~40k IoCs per minute |
| Darktraceと共有されたインジケーター | ~40k IoCs per minute |
ユーザーエージェント
netskope-ce-6.0.1-cte-darktrace-v1.0.0
ワークフロー
- Darktraceでユーザーを作成します。
- 公開トークンと非公開トークンを取得してください。
- Darktraceプラグインを設定します。
- ビジネスルールを設定します。
- 共有を設定する。
- Darktraceプラグインを検証してください。
動画を見る
再生ボタンをクリックして動画をご覧ください。
Darktraceでユーザーを作成する
- DarktraceインスタンスにログインしてAdmin > Permissions Adminに移動してください。

- Created Accountsに移動してCreate new userをクリックしてください。

- ユーザー名とパスワードを入力し、 User Templateをクリックしてください。

- 「ユーザーテンプレートSelectでは、「なし」を選択してください。

- 脅威トレイの動作カテゴリページで、すべてのトグルがオンになっていることを確認してください。

- Make sure all toggles are checked on the Flags page.

- ドメインの編集、ビジュアライザー、タグの編集の権限を付与してから、 Summaryをクリックします。

- Create new accountをクリックしてください。

パブリックトークンとプライベートトークンを取得する
- 先ほど作成したユーザーアカウントでログインし、 Account Settingsにアクセスしてください。

- API Accessをクリックして、生成された公開トークンと秘密トークンをコピーしてください。これらはDarktraceプラグインの設定に必要です。

Darktraceプラグインの設定
- 基本情報を入力してください:
- Configuration Name: プラグイン設定名。
- Sync Intervalこのプラグインソースからデータを取得する間隔。
- Indicator Aging Criteria: 特定の時間が経過したら、インジケーターの有効期限を切れるように設定する。
- Override Reputationこの設定から受信したインジケーターの評判を上書きする値を設定します。デフォルト設定のままにする場合は空欄のままにしてください。
- Enable SSL ValidationSSL証明書の検証を有効にします。
- Tags Aggregate Strategy: 既存のIoCに新しいタグを追加するか、上書きするかを選択してください。この設定パラメータは、この設定用に取得されたインジケーターのタグの保存方法を決定します。

- Nextをクリックして、設定パラメータを入力してください。
- Base URL: DarktraceインスタンスのベースURL。
- Public Token: Darktrace プラットフォームから生成されたパブリック トークン。
- Private Token: Darktraceプラットフォームから生成されたプライベートトークン。
- Source Name: IoC(侵害指標)を取得するIntelフィードソースの名前。このパラメータには、ソース名を1つだけ入力してください。利用可能な情報源は、Intel > 監視対象ドメインのページで確認できます。
- Enable Polling: Darktraceからの脅威IoCのポーリングを有効/無効にします。脅威IoCをDarktraceにプッシュするだけでよい場合は、無効にしてください。

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

Darktrace 用の Threat Exchange ビジネスルールを設定する
ビジネスルールは 共有する指標をフィルタリングするためのものです。 DarktraceとIoCを共有するには、ビジネスルールを作成します。
- Threat ExchangeでBusiness Rulesに移動し、 Create New Ruleをクリックします。
- ルール名を入力し、IoCをフィルタリングするフィールドを選択してください。

- Saveをクリックしてください。
Darktraceの脅威交換共有を設定する
IntelフィードソースアクションにIoCを追加します。共有を設定するには:
- Threat ExchangeでSharingに移動し、 Add Sharing Configurationをクリックします。
- ソース(Darktraceにデータを共有する元のソース)、ビジネスルール、および宛先Select 。
- 目標値Select 、要件に応じてアクションパラメータを設定してください。
- Source Name: IoC(侵害指標)を追加するIntelフィードソース名。Darktraceプラットフォームで新しいソースを作成するSelect Create new source。
- Custom Source: 存在しない場合に作成するカスタムソースの名前。
- Exact Hostnames: 追加された項目をドメイン名ではなくホスト名として扱うには、trueに設定します。IPタイプのIoCには適用されません。ホスト名タイプの IoC の場合、共有設定で「正確なホスト名」が false に設定されていても、常に True になることに注意してください。
- Flag for Response: エントリが検出された場合、Darktraceの自律応答アクションが自動的にトリガーされるように設定します。
- Saveをクリックしてください。

Darktraceプラグインを検証する
プルを検証する
Darktraceの指標は、 「監視対象ドメインとIPアドレス」ページから取得されます。
注記
Netskope CE を除くデスク リプションを持つ IoC | Netskope Threat Exchange はDarktrace から削除されます。
Darktraceインスタンスにログインしてください。

Intel > Watched Domainsへ移動してください。


Cloud Exchangeに保存されている指標はThreat Exchange > Threat IoCsで確認できます。Darktraceのインジケータをフィルタリングして、DarktraceのIoC(侵害指標)を検索します。
例: 「sources.source Is equal “CTE Darktrace” && type IN (“<IOC_TYPE>”)」のようなクエリを追加します。


注記
Darktrace上でホスト名が完全に一致するIoCは、Cloud Exchangeにも同じホスト名で保存されます。
また、Cloud Exchangeで取得したインジケーターは、 Loggingで利用可能なログから確認できます。

プッシュ通知を検証する
Darktraceと共有されているIoCは、 Loggingで入手可能なログから確認できます。

Darktrace で共有 IoC を検証するには、 Intel > Watched Domainsにアクセスしてください。



Cloud Exchangeでこのインジケーターが取得され、Darktrace に共有された元のソースを確認するには、その特定の IoC のデスクトップリプションを確認してください。
例えば、Threat Exchange から Darktrace にインジケーターが共有された場合、その特定の IoC の Darktrace の ブレーク リプションにはNetskope CE | Netskope Threat Exchangeと表示されます。

DarktraceからNetskopeテナントまたはサードパーティプラットフォームに共有されたIoCが取り下げられると、取り下げ結果に<plugin-config-name>: retractedとマークされます。第三者プラットフォームから削除されない場合、取り消し結果は保留状態となります。
撤回を検証する
Darktraceから取り下げられたIoCを確認するには、ログでIoCの取り下げに関する項目を確認してください。例:「メッセージ Like CTE Darktrace [configuration_name] [Retraction] 」。

注記
Darktrace上で削除されたIoCは、Cloud Exchange上で「撤回済み」としてマークされます。
プッシュ取り消し時のログ例:

Cloud Exchangeで撤回されたIoCを確認するには、 Threat IoCs にアクセスして 「sources.source Like "CTE Darktrace" & & sources.retracted Is equal"で検索してください。


このプラグインはプッシュの取り消しもサポートしています。つまり、 Netskopeまたはサードパーティのプラットフォームから取得され、Darktrace プラットフォームに共有され、 Cloud Exchangeで取り消し済みとしてマークされている IoC は、そのプラットフォームが IoC の削除をサポートしている場合、共有プラットフォームからも削除されます。 撤回結果欄で確認できます。

注記
1つのDarktraceに対して複数のアクションが設定されている場合、共有設定で選択されたソース名に基づいて、Darktrace上のIoCが削除されます。
Darktraceプラグインのトラブルシューティング
プラグインの設定中にエラーが発生しました
Darktraceプラグインの設定中に問題が発生しました。
What to do:
正しいクレデンシャルが提供されていることを確認してください。 クレデンシャルを生成するには、次の手順に従います。
Darktrace プラットフォームからデータを取得できません
Darktraceプラグインからデータを取得する際にエラーが発生しています。
What to do:
- ログページにアクセスして、エラーが発生していないか確認し、修正を試みてください。
- 公開トークンと秘密トークンの有効期限が切れていないことを確認してください。
Cloud ExchangeからDarktraceにIoCを共有できません
NetskopeからDarktraceにIoCを共有できない場合、以下のいずれかの理由が考えられます。
- Netskopeプラグインに存在するIoCは無効なタイプです。
- 公開トークンとプライベートトークンは期限切れです。
What to do:
- 有効なタイプのIoCが存在することを確認してください。Darktraceは、ドメイン、FQDN、ホスト名、IPv4、IPv6を「監視対象ドメインとIPアドレス」ページに共有することをサポートしています。
- 公開トークンと秘密トークンの有効期限が切れていないことを確認してください。
既知の行動
- Darktraceプラグインは、同期間隔ごとに設定されたソース名からすべてのIoC(侵害指標)を取得するため、同期間隔ごとにすべてのIoCのヒット数が1ずつ増加します。
- DarktraceからIoCを削除する際(プッシュリトラクション)、ソース名は必須パラメータです。
例:- Initial State:
- Action 1 (Source 1): IoC 1~5をフィルタリングしてプッシュします。
- Action 2 (Source 2): IoC 6~10をフィルタリングしてプッシュします。
- Retraction Event:
- IoC 1、2、6、および7は撤回済みとしてマークされています。
- Current Core Behavior:
- プラグインは、[1, 2, 6, 7]のような取り下げられたインジケーターのリストと、設定済みのアクションのリスト[アクション1(ソース1), アクション2(ソース2)]を受け取ります。
- The Conflict: プラグインは、1と2がソース1に属し、6と7がソース2に属することを認識していません。そのため、対象を絞った撤回を実行するためのコンテキストがありません。
- Current Implementation: このプラグインは、ソース1とソース2の両方からIoC 1、2、6、7を削除します。
- Initial State:
- 上記のケースに関連するもう1つの問題は、アクションが設定されていない場合(最初に設定され、IoCがプッシュされたが、今は削除されている場合)、IoCを削除するソース名がないため、IoCの取り消しが機能しないことです。
- IoCがシステム間で繰り返しプッシュおよびプルされるシナリオを防ぐため、このプラグインは特定の保護策を実装しています。
Cloud Exchangeからプッシュされた IoC が Darktrace からCloud Exchangeにプルバックされた場合、それは IoC のデスクトップリプションが手動またはサードパーティのエンティティソース API を介して更新されたことが原因です。 プラグインは IoC をチェックし、 Cloud Exchangeから IoC がプッシュされたときにNetskope CE|<plugin_name>のようなソース ラベルを探します。 このソースラベルがIoCに見つからなければ、Cloud Exchangeで取得されます。


