Risk Exchange 用 Silverfort プラグイン

このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Risk Exchange モジュールを使用して Silverfort v1.0.0 プラグインを構成する方法について説明します。 このプラグインは、SilverfortのSilverfort > ユーザー登録ページで利用可能なユーザーに対して、 Silverfortリスクの更新アクションを実行することをサポートします。 このプラグインは、Silverfort プラットフォームからのデータの取得をサポートしていません。

前提条件

この統合を完了するには、以下が必要です。

• Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
• Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
• Silverfortテナントへの接続。
• Silverfortバージョン5.3以降。

Silverfortプラグインのサポート 

このプラグインは、SilverfortのSilverfort > ユーザー登録ページで利用可能なユーザーに対して、 Silverfortリスクの更新アクションを実行することをサポートします。 このプラグインは、Silverfort プラットフォームからのデータの取得をサポートしていません。

取得したデータの種類	サポートされているアクション
サポートされていません	シルバーフォートのリスクを更新 No Action

権限 

You need admin access for the Silverfort user.

APIの詳細

使うAPI一覧

APIエンドポイント	方法	使うケース
/integrations/inbound/ Netskope /v1/risk/{webhook_id}	役職	指定されたユーザーのSilverfortリスクを更新しました。

API Endpoint: {base_url}/integrations/inbound/ Netskope /v1/risk/{webhook_id}

Method: 役職

Request Headers

Key	Value
Authorization	<auth_id>
Content-Type	アプリケーション/json
ユーザーエージェント	netskope-ce-5.1.2-cre-silverfort-risk-v1.0.0

Payload

{
     "riskLevel": <silverfort_risk>, 
     "email": <email>
}

ユーザーエージェント

netskope-ce-5.1.2-cre-silverfort-risk-v1.0.0

ワークフロー

1. 認証トークンを設定します。
2. SilverfortからWebhook IDと認証IDを取得してください。
3. Silverfortプラグインの設定。
4. ビジネスルールを追加します。
5. アクションを追加します。
6. プラグインを検証してください。

動画を見る

再生ボタンをクリックして動画をご覧ください。

Netskope API認証トークンの設定

New Flow for 6.0

Silverfort管理コンソールで、 Settings > Notifications > Add Integrationに移動してNetskope Inbound Plugin選択します。ここに名前、認証ID、およびウェブフックIDを入力できます。

Property	Description	Permitted Value
AuthId	Silverfortへの受信リクエストに必要な認証ID	有効なUUID（ユーザーによって生成されたもの）
WebhookId	Silverfortへの受信リクエストに必要なWebhook ID	有効なUUID（ユーザーによって生成されたもの）

Flow for Pre-6.0

Silverfort管理コンソールで、 Settings > Notifications > Customに移動します。

JSON構造において、親オブジェクト内に以下の設定オブジェクトを追加します。両方のUUIDはユーザーによって生成される必要があります。

"netskope_inbound_v1": 
{
        "config": 
        {
            " authId": " Valid UUID" ,
            " webhookId": "Valid UUID"  
        }
}

Property	Description	Permitted Value
authId	Silverfortへの受信リクエストに必要な認証ID	有効なUUID（ユーザーによって生成されたもの）
webhookId	Silverfortへの受信リクエストに必要なWebhook ID	有効なUUID（ユーザーによって生成されたもの）

SilverfortからWebhook IDと認証IDを取得してください。

SilverfortテナントからWebhook IDと認証IDを取得するには：

1. Silverfortにログインし、左下隅のSettingsをクリックします。

   

2. Notificationsに移動して、 Customタブをクリックしてください。

   

3. プラグインを設定する際に、認証IDとWebhook IDをコピーしてください。

Silverfortプラグインの設定

Silverfortプラグインを設定するには：

1. Cloud ExchangeにログインしてSettings > Pluginsに移動してください。
2. Silverfort Risk v1.0.0プラグインボックスを検索して選択します。

   

3. プラグインの構成名を入力し、同期間隔を選択してください。

   

4. Nextをクリックして、設定パラメータを入力してください。
   • Silverfort Base URL: Silverfort プラットフォームのベース URL。
   • Auth ID: 以前取得したSilverfort認証ID。
   • Webhook ID: 以前取得したSilverfort Webhook ID。

   

5. Nextをクリックし、ドロップダウンリストから一覧表示されているエンティティを選択してください。

   注記：

   このプラグインはプルをサポートしていないため、エンティティソースページにはマッピングするフィールドがありません。

   

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

   

Silverfortプラグインにリスク交換ビジネスルールを追加する

1. Risk ExchangeでBusiness Rulesに移動し、 Create New Ruleをクリックします。
2. ルール名を入力してください。ユーザーレコードが保存されているエンティティSelect 、要件に基づいてクエリを設定してください。 完了したら、 Saveをクリックしてください。

Silverfortプラグインにリスク交換アクションを追加する

Silverfortプラグインは、以下のアクションタイプをサポートしています。

• Update Silverfort RiskこのアクションはSilverfortに登録されているユーザーに対して実行され、トリガーされるとSilverfortユーザーのスコアが更新されます。
• No Actionこのアクションに対しては、何も措置は講じられません。Ticket OrchestratorでUBAアラートを生成するには、このアクションを選択し、「アラートの生成」トグルを有効にします。

アクションを設定するには：

1. Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。
2. それぞれのドロップダウンメニューから、必要なビジネスルール、設定、およびアクションSelect 。
3. ユーザーの電子メールを使用するフィールドSelectか、「静的」に切り替えて静的なユーザーの電子メール アドレスを入力します (電子メールのカンマ区切り値はサポートされていません)。
4. ユーザーのスコアが保存されているソースフィールドを指定するか（スコアは文字列形式（Low、Medium、High、Critical）である必要があります）、またはStaticに切り替えてドロップダウンからスコア値を選択してください。
5. ユーザー/アプリケーションに対してアクションを実行する前に承認が必要な場合は、 Require Approvalを有効にしてください。
6. Saveをクリックしてください。

   

Silverfortプラグインを検証する

Cloud Exchangeでの検証

Silverfort でユーザーに対して実行されたアクションを確認するには、 Loggingに移動して、メッセージ「silverfort」のようにプラグイン名に基づいてログをフィルタリングします。

Silverfortでの検証

Silverfort テナントでは、アクションをトリガーするユーザーを確認するには、左側のパネルからUser Enrollmentに移動します。

ユーザーのスコアが更新されているかどうかを確認するには、ダッシュボードの右上隅にあるSilverfort検索バーからユーザーの住所を検索してください。 ユーザーの電子メール アドレスをクリックします。 

ユーザー詳細ページにリダイレクトされます。そこで、ページ上でユーザーのスコアと、スコア変更のログを確認できます。

Silverfortプラグインのトラブルシューティング

操作の実行中にエラーが発生しました

Silverfort API は、アクションの実行中に 500 または 504 内部サーバーエラーを頻繁にスローすることが確認されています。これは以下のいずれかの理由による可能性があります。

• アクションが実行されているユーザーは、Silverfort プラットフォームに存在しません。
• APIがダウンしているか、SilverfortのUIがダウンしているか、アクセスできません。
• アクションがトリガーされた時点では、ユーザーはスコアを確認できません。

What to do:

• プラグインから500または504エラーが発生する場合、それはSilverfort APIが上記のシナリオに対してこれらのエラーで応答するためです。これはSilverfort APIからの内部サーバーエラーであるため、500または504の場合に再試行を行うための汎用的な処理がプラグインに追加されています。 SilverfortテナントまたはAPIがダウンしていない限り、テナントに存在するユーザーに基づいてのみアクションを実行するようにしてください。 
• スコア更新のアクションがトリガーされた場合 ソースフィールドで、ユーザーのスコアが利用できない場合（null値または空の値）、APIは内部サーバーエラーをスローします。