このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Risk Exchange モジュール用に KnowBe4 v1.0.0 プラグインを構成する方法について説明します。 このプラグインは、KnowBe4 プラットフォームの PAB ユーザー アクティビティ ページからユーザーを取得するために使用します。 PAB ユーザー アクティビティ ページは、KnowBe4 プラットフォーム > アカウント設定 > アカウント統合 > フィッシング アラート > PAB ユーザー アクティビティを参照してください。 このプラグインは、KnowBe4のユーザーに対して何らかの操作を実行することをサポートしていません。
Netskopeの正規化スコア計算（ユーザー > 1000 – (KnowBe4の現在のリスクスコア) x 10）。
前提条件
この統合を完了するには、以下が必要です。
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
- KnowBe4のベースURLとAPIトークン。
- 以下のホストへの接続: https://*.api.knowbe4.com 。
KnowBe4プラグインのサポート
KnowBe4 は、KnowBe4 プラットフォームの PAB ユーザー アクティビティ ページからのユーザーの取得をサポートしています。 PAB ユーザー アクティビティ ページは、KnowBe4 プラットフォーム > アカウント設定 > アカウント統合 > フィッシング アラート > PAB ユーザー アクティビティを参照してください。 このプラグインは、KnowBe4のユーザーに対して何らかの操作を実行することをサポートしていません。
| 取得したデータの種類 |
ユーザー |
| Actions |
アクションなし |
マッピング
マッピングは 取得したユーザーとその詳細を表示するためのものです。 プラグイン設定時にマッピングされたフィールドは、データが取得されるとレコードページに表示されます。以下は、プラグインの設定時に使用すべき推奨マッピングです。 プラグインの設定時に使用してください。
ユーザー向けプルマッピング
| プラグインフィールド | 想定されるデータ型 | 提案されたフィールド名 | 推奨される現場での対応策 |
|---|---|---|---|
| ユーザーID | Number | ユーザーID | Unique |
| 名 | String | 名 | Overwrite |
| 姓 | String | 姓 | Overwrite |
| ユーザーの電子メール | String | ユーザーの電子メール | Overwrite |
| ユーザーの状態 | String | ユーザーの状態 | Overwrite |
| ユーザー現在のリスクスコア | Number | ユーザー現在のリスクスコア | Overwrite |
| Netskope正規化リスクスコア | Number | Netskope正規化リスクスコア | Overwrite |
正規化スコアの計算
KnowBe4で想定されるスコアの範囲は0～1000です。Netskopeの正規化スコア計算（ユーザー > (1000 – (KnowBe4の現在のリスクスコア) x 10)）。
リスクスコアの値が0、100、および文字列の場合、Netskope正規化スコアの計算はスキップされることに注意してください。
権限
トークンを作成するユーザーが、APIトークンを作成するために必要な権限を持っていることを確認してください。
APIの詳細
使うAPI一覧
| APIエンドポイント | 方法 | 使うケース |
|---|---|---|
| v1/users | 得る | Fetch Users |
Fetch Users
API Endpoint: <Base URL>/v1/users
Method: GET
Headers
| 鍵 | Value |
|---|---|
| Authorization | ベアラー<API Token> |
Params
| 鍵 | Value |
|---|---|
| page | 1 |
| per_page | 500 |
Sample API Response
[
{
"id": 3460988,
"employee_number": null,
"first_name": "user",
"last_name": "name",
"job_title": null,
"email": "user.name@test.com",
"phish_prone_percentage": 50.0,
"phone_number": "",
"extension": "",
"mobile_phone_number": "",
"location": null,
"division": null,
"manager_name": null,
"manager_email": null,
"provisioning_managed": true,
"provisioning_guid": null,
"groups": [],
"current_risk_score": 32.8,
"aliases": [
"user.name@test.com"
],
"joined_on": "2024-06-19T18:15:58.000Z",
"last_sign_in": "2024-10-22T12:03:55.000Z",
"status": "active",
"organization": null,
"department": null,
"language": null,
"comment": null,
"employee_start_date": null,
"archived_at": null,
"custom_field_1": null,
"custom_field_2": null,
"custom_field_3": null,
"custom_field_4": null,
"custom_date_1": null,
"custom_date_2": null
}
]
パフォーマンスマトリックス
以下は、KnowBe4プラグインから50万件のユーザーレコードを取得して、これらのVM仕様を持つ大規模CEスタックで実施したパフォーマンス測定結果です。
| スタックの詳細 | サイズ：大 RAM：32 GB CPU：16コア |
| リスクスコアとともに取得したユーザーレコードを保存するのにかかる時間 | 約16分 |
ユーザーエージェント
netskope-ce-5.1.0-cre-knowbe4-v1.0.0
ワークフロー
- KnowBe4でAPIトークンを作成します。
- KnowBe4プラグインの設定を行っています。
- KnowBe4 のリスク交換ビジネスルールを追加します。
- KnowBe4のリスク交換アクションを追加します。
- KnowBe4プラグインを検証してください。
再生ボタンをクリックして動画をご覧ください。
KnowBe4でAPIトークンを作成する
- KnowBe4 プラットフォームにログインします。
- Account Settings .
へ移動してください。
- Account Integration > APIに移動してReporting APIをクリックしてください。
- Create New API Token .
をクリックしてください
- トークンの名前を入力して、 Create Tokenをクリックしてください。
- トークンをコピーして保存してください。 KnowBe4プラグインを設定するために必要です。
- Press OK.
KnowBe4プラグインの設定
- Cloud Exchangeで Settings > Pluginsに行ってください。KnowBe4 v1.0.0 (CRE)プラグインボックスを検索して選択します。
- 基本情報を入力してください：
- 設定名：設定の名前を入力してください。
- 同期間隔：このプラグインソースからデータを取得する間隔。
- Click Next. Enter the Configuration Parameters:
- ベース URL: KnowBe4 インスタンスのベース URL。例: https://ca.api.knowbe4.com 。
- APIトークン：以前に生成されたAPIトークン。
- Nextをクリックしてください。エンティティのドロップダウンからエンティティをSelectしてください。
エンティティフィールドはスキーマエディタのページから作成するか、フィールドのドロップダウンから +Add Field オプションを使うことができます。
現場のマッピング情報を提供してください。推奨されるマッピングについては、 「マッピング」セクションを参照してください。
- Save .
をクリックしてください
KnowBe4 のリスク交換ビジネスルールを追加する
ビジネス ルールを使用してユーザーを除外します。 ビジネスルールを設定するには、以下の手順に従ってください。
- Risk ExchangeでBusiness Rulesに移動し、 Create New Ruleをクリックします。
- アクションを実行するために、ビジネスルール名、エンティティを入力し、要件に応じてフィルタを指定してください。
- Save .
をクリックしてください
KnowBe4のリスク交換アクションを追加する
KnowBe4は「何もしない」アクションのみをサポートしています。
No Action
この操作では、いかなる動作も実行されません。この操作を実行すると、チケットオーケストレーターモジュールでUBAアラートを生成できます。
- Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。
- ビジネスルール、プラグイン設定、およびアクション（アクションなし） Select 。
- Save .
をクリックしてくださいTicket Orchestrator > Alertsでアラートを生成するには、このアクションを作成する際にアラート生成を有効にする必要があります（チケットオーケストレーターモジュールが有効になっている必要があります）。
Netskopeテナント上で、KnowBe4から取得したユーザーに対してUCIスコアの更新を実行できます。
KnowBe4プラグインを検証する
Cloud Exchangeでの検証
KnowBe4から取得したユーザーレコードを検証するには、 Loggingに移動して、KnowBe4プラグインから取得したログを検索してください。
例:メッセージ「[CRE KnowBe4]」
取得したデータを確認するには、 Recordsに移動し、KnowBe4 プラグインの設定時に使用するエンティティのタイプを選択します。 KnowBe4 プラグインの設定時に使用します。 取得したレコードを確認してください。
ユーザーリスクスコアが「0」の場合、UIには「-」が表示され、ユーザーリスクスコアが「100」の場合、UIのNetskope正規化リスクスコアにも「-」が表示されます。
KnowBe4プラグインのログ（ Loggingで、実行されたアクションを確認してください。
アクションの設定時に「承認が必要」トグルが有効になっている場合は、 Action Logページで保留中の承認エントリを選択し、「承認」トグルを選択して承認を提供してください。
KnowBe4で検証する
ユーザーは、アカウント設定 > アカウント統合 > フィッシングアラート > KnowBe4 で PAB ユーザーアクティビティを表示から取得されます。
ユーザーを検証するには、 Account Settings > Account Integrations > Phish Alert > See PAB User Activity.
にアクセスしてください。 
KnowBe4プラグインのトラブルシューティング
プラグインのワークフローでエラーが発生しました
CRE KnowBe4 [CRE KnowBe4]: Validation error occurred, Received exit code 401, Unauthorized, Verify Base URL and API Token provided in the configuration parameters.
What to do:
- KnowBe4のAPIトークンを確認してください。KnowBe4プラグインの設定を参照してください。
- KnowBe4 プラットフォームのベース URL を確認します。 「前提条件」 の 「次のホストへの接続」 を参照してください。
KnowBe4からユーザーは抽出されません
ユーザーのデータが取得できない場合、原因は以下のいずれかである可能性があります。
- プラットフォーム上にプル可能なユーザーがいません。
- マッピング機能はプラグインには含まれていません。
What to do:
- KnowBe4 にアクセスし、[アカウント設定] > [アカウント統合] > [フィッシングアラート] > [PAB ユーザーアクティビティの表示]ページからユーザーが取得可能かどうかを確認してください。
- プラグインの設定を編集し、「エンティティソース」ページを確認してください。同じ情報を取得するには、いくつかのフィールドをマッピングする必要があります。