このドキュメントでは、 Netskope Cloud Exchangeの Application Risk Exchange モジュールを使用して Bitsight プラグインを構成する方法について説明します。 この統合機能には、企業全体のベンダー情報を保存する監視対象のベンダーセクションがあります。このプラグインは、Netskopeテナントのアプリケーションデータを監視対象ベンダーに送信し、リスク分析を行うための仕組みを提供します。このプラグインには、監視対象ベンダーへのアクセス権を持つBitsightアカウントの詳細情報が必要です。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- Netskope Cloud Exchangeテナント（テナントプラグインとリスクエクスチェンジプラグインが既に設定済み）。
- Bitsightインスタンス認証キー。
- Bitsightへの接続。
Bitsightプラグインのサポート
このプラグインは、アプリケーションを Bitsight プラットフォームに共有するメカニズムを提供します。
| 共有されるデータの種類 | 応用 |
マッピング
押し出されたフィールド
| サードパーティフィールド | Netskope CE Fields |
|---|---|
| 内部メモ | アプリケーション名、 Cloud Confidence Index 、CCL、カテゴリ名、ディープリンク、最終共有日時 |
APIの詳細
使うAPI一覧
| API Endpoint | Method | Use Case |
|---|---|---|
| /api/v2/connections非アクティブ | 得る | アプリケーション/ベンダーの詳細を取得する |
| /api/tier/ {vendor_id}/note | 役職 | 共有アプリケーションのリスクスコア |
アプリケーション/ベンダーの詳細を取得する
Method: 得る
Headers:
コンテンツタイプ: application/json
受け入れ: application/json
認証: トークン {token}
API Request Endpoint: https://api.thirdpartytrust.com/api/v2/connections.inactives
Sample API Response – 200 OK:
[
{
"incoming": {
"model_name": "CompanyConnection",
"approval_boolean": false,
"approval_date": "",
"connection_date": "2021-03-18T11:17:13.837654",
"created_on": "2021-03-18 11:17:13",
"description": "",
"internal_contacts": [],
"lifecyclestate_uuid": "b8ca0bea-1b11-4adf-9601-ee7ec06d4e8e",
"manual": "True",
"owner_contacts": [],
"primary_uuid": "f8feed5f-d200-4ea3-8fe8-8a0fc690eff1",
"relationship_date": "",
"review_year": 0,
"secondary_uuid": "153e6623-da10-404e-bddf-66a872d3c8c3",
"type_relation": "secondary_views_primary",
"uuid": "e3b80f16-3191-4aab-8892-2eb385d7de93",
"is_owner": false
},
"outgoing": null,
"company": {
"model_name": "Company",
"uuid": "f8feed5f-d200-4ea3-8fe8-8a0fc690eff1",
"domain": "oracle.com",
"company_legal_name": "Oracle Corporation, Lodestar",
"name": "Oracle Corporation, Lodestar",
"website": "oracle.com",
"labels": [],
"departments": [],
"lifecycle_state": null,
"logo_url": "https://s3.amazonaws.com/s3-apps-prd-fileservice/d21aa983-4519-4868-a2ec-e2a569d05fb9",
"company_cluster_domain": "oracle.com",
"domains": [],
"generic": {
"connection_date": "2021-03-18T11:17:13.837654",
"description": "",
"approval_date": "",
"approval_boolean": false,
"relationship_date": "",
"lifecycle_state": {
"model_name": "LifeCycle",
"base_value": true,
"color": "#767676",
"icon": "x",
"type": 1,
"uuid": "b8ca0bea-1b11-4adf-9601-ee7ec06d4e8e",
"value": "Base Pending"
}
},
"tier_score": 1,
"trust_score": 55.38,
"next_review_date": "--",
"due_date": {
"date": null
}
}
}
]
共有アプリケーションのリスクスコア
Method: 役職
Headers:
コンテンツタイプ: application/json
受け入れ: application/json
認証: トークン {token}
Request Body:
{
“note”:”Netskope CE ….”
}
API Request Endpoint: https://api.thirdpartytrust.com/api/tier/{vendor_id}/note
Sample API Response – 200 OK:
[
{
"incoming": {
"model_name": "CompanyConnection",
"approval_boolean": false,
"approval_date": "",
"connection_date": "2021-03-18T11:17:13.837654",
"created_on": "2021-03-18 11:17:13",
"description": "",
"internal_contacts": [],
"lifecyclestate_uuid": "b8ca0bea-1b11-4adf-9601-ee7ec06d4e8e",
"manual": "True",
"owner_contacts": [],
"primary_uuid": "f8feed5f-d200-4ea3-8fe8-8a0fc690eff1",
"relationship_date": "",
"review_year": 0,
"secondary_uuid": "153e6623-da10-404e-bddf-66a872d3c8c3",
"type_relation": "secondary_views_primary",
"uuid": "e3b80f16-3191-4aab-8892-2eb385d7de93",
"is_owner": false
},
"outgoing": null,
"company": {
"model_name": "Company",
"uuid": "f8feed5f-d200-4ea3-8fe8-8a0fc690eff1",
"domain": "oracle.com",
"company_legal_name": "Oracle Corporation, Lodestar",
"name": "Oracle Corporation, Lodestar",
"website": "oracle.com",
"labels": [],
"departments": [],
"lifecycle_state": null,
"logo_url": "https://s3.amazonaws.com/s3-apps-prd-fileservice/d21aa983-4519-4868-a2ec-e2a569d05fb9",
"company_cluster_domain": "oracle.com",
"domains": [],
"generic": {
"connection_date": "2021-03-18T11:17:13.837654",
"description": "",
"approval_date": "",
"approval_boolean": false,
"relationship_date": "",
"lifecycle_state": {
"model_name": "LifeCycle",
"base_value": true,
"color": "#767676",
"icon": "x",
"type": 1,
"uuid": "b8ca0bea-1b11-4adf-9601-ee7ec06d4e8e",
"value": "Base Pending"
}
},
"tier_score": 1,
"trust_score": 55.38,
"next_review_date": "--",
"due_date": {
"date": null
}
}
}
]
ユーザーエージェント
netskope-ce-1.1.1
ワークフロー
- Bitsight APIキーを取得してください。
- Bitsightプラグインを設定します。
- Bitsight 用のアプリケーションリスク交換ビジネスルールを設定します。
- Bitsight向けアプリケーションリスクエクスチェンジ共有の設定を行います。
- ThirdPartyTrustプラグインを検証します。
デモをご覧になるには、再生ボタンをクリックしてください。
Bitsight認証キーを取得してください
- Bitsightにログインして、 Settings .
にアクセスしてください。
- Integrationsタブに移動してください。
- Generate Key .
をクリックしてください
- 生成された認証キーをコピーしてください。これはBitsightプラグインを設定するために必要です。
Bitsightプラグインの設定
- Cloud Exchangeで Settings > Pluginsに行ってください。ARE Bitsightプラグインを検索して選択してください。
- 設定名を追加し、プラグインの設定に使うプロキシを使う場合は使う System Proxy を有効にしてください。 Next .
をクリックしてください
- 認証キーを入力し、 Nextをクリックしてください。
- マッピングを提供してください。
- 左側のドロップダウンは Bitsight プラットフォームのフィールドを表し、右側のドロップダウンはNetskopeフィールドを表します。
- Cloud Exchangeに保存されているアプリケーションを展開して、フィールド名を確認してください。
- Bitsight に存在する会社名はドメインである必要があり、Cloud Exchange に保存されているアプリケーション内のディスカバリー ドメインまたはステアリング ドメインに存在する値とマッピングできます。
- Save .
をクリックしてください
Bitsight 用のアプリケーションリスクエクスチェンジビジネスルールを構成する
- Application Risk Exchange > Business Rulesに移動してCreate New Ruleをクリックしてください。
- ルール名を入力し、要件に基づいてビジネスルールのクエリを設定します。
- Saveをクリックしてください。
Bitsight のアプリケーションリスクエクスチェンジ共有を設定する
- Application Risk Exchange > Sharingに移動してAdd Sharing Configurationをクリックしてください。
- それぞれのドロップダウンメニューから、必要なビジネスルールと設定（プラグイン） Select 。
- Save .
をクリックしてください
Bitsightプラグインを検証する
Cloud Exchangeで検証する
- Application Risk Exchange > Applicationへ移動してください。すべての応募書類と、それぞれのスコアを確認できます。
- ログページにアクセスすると、プルされたアプリケーションを確認できます。
注記
Cloud Exchangeには固有のアプリケーションのみが保存されるため、Netskopeテナントから取得したデータが同じであれば、Cloud Exchangeには固有のアプリケーションのみが保存されます。
[ログ] ページに移動して、Bitsight プラットフォームへのアプリケーションの共有を確認します。
注記
内部メモは、Netskopeアプリケーションに存在する固有のドメインに基づいて、Bitsight上のアプリケーションに追加されます。例えば、Cloud Exchange 上にアプリケーションが 1 つしかない場合でも、そのアプリケーションには複数の検出ドメインと制御ドメインが含まれている場合などです。BitSight プラットフォームには複数のアプリケーションが存在しますが、そのアプリケーションは固有のドメインを持ちます。 したがって、BitSight上に存在するCloud Exchangeアプリケーション内の固有ドメインはすべて、この注記によって更新されます。単一のCloud Exchangeアプリケーションに対して、BitSight上で複数のアプリケーションが更新されるケースも考えられます。
一般的に、Netskope上の単一のアプリケーションに複数のドメインが含まれている場合、BitSightは各ドメインを個別のアプリケーションとして表示します。
Bitsightで検証する
- Bitsight プラットフォームにログインします。
- Connectionsに移動してMonitored Vendorsをクリックしてください。
- 更新された会社へ行ってください。
- Netskopeテナントの詳細については、「内部メモ」セクションをご確認ください。
トラブルシューティング
アプリケーションを Bitsight プラットフォームに共有できません
アプリケーションが Bitsight プラットフォームと共有されていない場合は、 Cloud Exchange Logging のログを確認してください。 次のいずれかである可能性があります。
- 共有することを目的としたアプリケーションが Bitsight プラットフォーム上に存在しません。
- Bitsight プラットフォームの構成中に指定されたマッピングに一致するものはありません。
What to do: アプリケーションを共有する際に警告が表示された場合は、警告メッセージを確認し、以下の手順に従ってください。
- アプリケーションが Bitsight プラットフォームにすでに存在していることを確認してください。
- 提供されたマッピングの値が、Bitsightと共有アプリケーションで正しく一致していることを確認してください。
BitSightプラグインを構成できません
BitSightプラグインの設定ができない場合は、Cloud Exchange Loggingのログを確認してください。認証キーの有効期限が切れている、無効である、または削除されている可能性があります。
What to do: BitSightプラグインの設定中にエラーが発生した場合は、メッセージを確認し、認証キーを確認してください。認証キーが無効、期限切れ、または削除されている場合は、新しい認証キーを作成してから、プラグインを設定してください。