このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Risk Exchange モジュールを使用して StealthMole v1.0.0 プラグインを構成する方法について説明します。 このプラグインは、StealthMole プラットフォームの[新規作成]でUBで利用可能な検索ドメインに基づいてユーザーを取得するために使用します。 このプラグインは、StealthMole プラットフォーム上のユーザーに対するアクションの実行をサポートしていません。
前提条件
この統合を完了するには、以下が必要です。
- Netskopeテナント(または、例えば本番環境と開発/テスト環境など、複数のテナント)。
- Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
- Stealthmole プラットフォームへの接続。
- StealthMole ULP Binder (UB) の購読。
- 以下のホストへの接続: https://platform.stealthmole.com
StealthMoleプラグインのサポート
このプラグインは、StealthMole プラットフォームの[新規作成]でUBで利用可能な検索ドメインに基づいてユーザーを取得するために使用します。 このプラグインは、StealthMole プラットフォーム上のユーザーに対するアクションの実行をサポートしていません。
| 取得したデータの種類 | サポートされているアクション |
|---|---|
| ユーザー | No Action |
マッピング
マッピングは 取得したユーザーとアプリケーション、およびそれぞれの詳細情報を表示するためのものです。 プラグイン設定時にマッピングされたフィールドは、データ取得後にレコードページに表示されます。以下は、プラグインの設定時に推奨されるマッピングです。 プラグインの設定時に使用します。
Pull Mappings
| Plugin Field Label | Expected Data Type | Suggested Field Label | 推奨分野 Aggregate Strategy |
|---|---|---|---|
| 電子メール | String | 電子メール | Unique |
| リーク元 | String | リーク元 | Unique |
| リークされた日付 | Datetime | リークされた日付 | Overwrite |
| Score | Number | Score | Overwrite |
APIの詳細
使うAPI一覧
API Base URL: https://api.stealthmole.com
| API Endpoint | Method | Use case |
|---|---|---|
| /v2/user/quotas | 得る | クレデンシャルを検証する |
| /v2/ub/export | 得る | ユーザーを獲得する |
クレデンシャルを検証する
Endpoint: <API Base URL>/v2/user/quotas
Method: 得る
Headers
| Key | Value |
|---|---|
| ユーザーエージェント | netskope-ce-5.1.1-cre-stealthmole-v1.0.0 |
| Authorization | Bearer <JWT Token> |
Sample Response
{
"DT": {
"allowed": 150,
"used": 3
},
"CDS": {
"allowed": 200,
"used": 0
},
"CB": {
"allowed": 50,
"used": 0
},
"CL": {
"allowed": 50,
"used": 0
},
"UB": {
"allowed": 100,
"used": 44
},
"RM": {
"allowed": 20,
"used": 0
},
"LM": {
"allowed": 20,
"used": 0
},
"GM": {
"allowed": 20,
"used": 0
},
"DA": {
"allowed": 20,
"used": 0
},
"TT": {
"allowed": 150,
"used": 0
}
}
ユーザーを獲得する
Endpoint: <API Base URL>/v2/ub/export
Method: 得る
Headers
| Key | Value |
|---|---|
| ユーザーエージェント | netskope-ce-5.1.1-cre-stealthmole-v1.0.0 |
| Authorization | Bearer <JWT Token> |
Parameters
| Key | Value |
|---|---|
| query | “email:<search_domain>“ |
| limit | 0 |
| exportType | json |
| start | <epoch time> |
Sample Response
{
"data": [
{
"id": "6645a10347357c08737f89bb5e18d2f01e09e10a",
"host": "https://mail.google.com",
"user": "user-1@<search_domain>",
"password": "*!B24y0aZG",
"leaked_date": "2025-05-11 03:28:33"
},
…
]
}
パフォーマンスマトリックス
以下は、これらの仕様を持つ大規模CEスタック上で、50万件のユーザーレコードを取得して実施したパフォーマンスマトリックスです。
| デスクリプション | 仕様 |
|---|---|
| スタックの詳細 | サイズ:大 RAM:32 GB CPU:16コア |
| StealthMoleから取得したユーザー | 約7分 |
ユーザーエージェント
netskope-ce-5.1.1-cre-stealthmole-v1.0.0
ワークフロー
- StealthMole プラットフォームからアクセス キーと秘密キーを取得します。
- StealthMoleプラグインを設定します。
- ビジネスルールを追加します。
- アクションを追加します。
- StealthMoleプラグインを検証します。
再生ボタンをクリックして動画をご覧ください。
StealthMole プラットフォームからアクセス キーと秘密キーを取得します。
このセクションでは、StealthMoleのシークレットとアクセストークンを取得する方法について説明します。
StealthMoleライセンスにサインアップする
https://www.stealthmole.com/free-planにアクセスしてくださいStealthMoleライセンスに登録するには。サインアップの際には、使うAPIキーを使おうとする正しいプラットフォームを選択してください。
確認メール
申請が確認されると、次の内容の確認電子メールが届きます。
- StealthMole プラットフォームにアクセスするための StealthMole ライセンス
- APIアクセスキー
- APIシークレットキー
電子メールに必要な情報が不足している場合は、コンタクトsupport@stealthmole.comまでご連絡ください。
StealthMoleプラグインの設定
- Cloud Exchange で、 Settings > Pluginsに移動します。StealthMole v1.0.0 (CRE)プラグインを検索して選択してください。

- プラグイン設定名を追加し、同期間隔を変更します(API制限を超えないように1日のままにしてください)。

- Nextをクリックして、設定パラメータを入力してください。
- Access Key: StealthMoleプラットフォームのアクセスキーを提供します。
- Secret Key: StealthMole プラットフォームから秘密キーを提供します。
- Search Domain: StealthMoleデータベースからユーザーを検索するドメインを指定してください。例えばgmail.com
- Score: StealthMoleプラットフォームから抽出した各ユーザーに割り当てられるスコア。 値は0から1000の範囲内である必要があります。

- Nextをクリックして、エンティティソース情報を入力してください。エンティティのドロップダウンからエンティティをSelectしてください。エンティティフィールドはスキーマエディターで作成するか、フィールドドロップダウンから使う + Add Field オプションを作成できます。 フィールドマッピングを提供してください。推奨されるマッピングについては、 「マッピング」セクションを参照してください。

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

StealthMole のリスク交換ビジネスルールを追加する
- Risk Exchangeで Business Rulesに移動してください。
- 右上隅のCreate New Ruleクリックしてください。
- ルール名を入力してください。StealthMoleプラグイン用に設定されたフィールドのエンティティSelect 、要件に基づいてクエリを設定してください。 完了したら、 Saveをクリックしてください。

StealthMoleにリスク交換アクションを追加する
StealthMoleプラグインは、ユーザーに対して以下の操作をサポートしています。
「何もしない」を選択すると、ユーザーに対して一切の操作は行われません。
No Action
- Risk Exchangeで Actionsに移動し、 Add Action Configurationをクリックします。
- ビジネスルールSelect 、構成を選択して、構成済みのプラグインの名前を選択します。
- ドロップダウンメニューから「アクション」 Selectか、 No actionsを選択して、 「アラート生成」トグルを有効にすると、チケットオーケストレーターモジュールでアラートが生成されます。
- ユーザーに対して操作を実行する前に承認が必要な場合は、 「承認が必要」トグルを有効にしてください。
- Saveをクリックしてください。

StealthMoleプラグインを検証する
Cloud Exchangeで検証する
Cloud Exchange に取り込まれたデータを確認するには、 Loggingにアクセスし、構成名に基づいてログをフィルタリングしてください。
Example: message Like “CRE StealthMole”

Cloud Exchangeに保存されているデータを確認するには、Risk Exchange のRecordsに移動し、プラグイン設定中にユーザーレコードを保存したエンティティを選択します。 プラグイン設定中にユーザーレコードを保存したエンティティを選択します。

StealthMoleで検証する
StealthMoleで利用可能なデータを確認するには、 HomePageの「 Create New Case 」ボタンをクリックし、 UBに移動して、漏洩したユーザーの詳細をフィルタリングしたいドメインの種類を検索します。 漏洩したユーザーの詳細をフィルタリングします。

StealthMoleプラグインのトラブルシューティング
プラグインの設定やユーザーレコードの取得ができません
プラグインは、レコードの保存または取得中に、次のような場合にエラーを表示する可能性があります。
- アクセスキーまたはシークレットキーの有効期限が切れているか、無効です。
- 検索ドメインには、取得すべき大量のデータがあります。
What to do:
プラグイン クレデンシャルを確認してください。提供されたクレデンシャルが無効であるか削除されている場合、プラグインはエラーをスローします。
制限事項
- StealthMoleにはクエリ制限が設定されており(ULP Binderのサブスクリプションに基づきます)、StealthMole上でデータ取得のリクエストが成功するたびにこの制限が作動します。これは、プラットフォーム上でULP Binderの検索が行われるたび、またはプラグインが同期されるたびにトリガーされます。制限に達すると、プラグインのライフサイクルでエラーが表示されます。制限を超えないように、プラグインの同期間隔は1日に設定することをお勧めします。また、制限を引き上げるためにStealthMoleのサポートに問い合わせてください。

- プラグインに追加されたドメインに処理すべきデータが100万件を超える場合、APIから422 Unprocessableエラーが返されます。このケースでは、プラグインはデータを取得せず、このエラーをスローします。


