このドキュメントでは、 Netskope Cloud Exchangeプラットフォームの Threat Exchange モジュールを使用して GitHub プラグインを構成する方法について説明します。 この連携により、GitHubリポジトリファイルのファイルハッシュをNetskopeと共有することが可能になります。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- 悪意のあるファイルハッシュ共有に対するNetskope脅威対策サービスのサブスクリプション。
- Netskope Cloud Exchangeテナント（テナントプラグインと脅威交換プラグインが既に構成済み）
- ファイルハッシュを取得する必要のあるリポジトリにアクセスできるGitHubアカウント。
ワークフロー
- GitHub APIトークンを取得します。
- GitHubプラグインを設定します。
- NetskopeとGitHub間の共有設定を行います。
- GitHubプラグインを検証します。
再生ボタンをクリックして動画をご覧ください。
GitHub APIトークンを取得する
- GitHubにログインしてください。
- どのページでも右上隅にあるプロフィール写真をクリックし、次にSettingsをクリックします。
- 左側のパネルで、 Developer settingsをクリックします。
- 左側のパネルで、 Personal access tokensをクリックします。
- 右上隅のGenerate new tokenクリックしてください。
- Noteでは、トークンに分かりやすい名前を付けてください。
- リポジトリとユーザーに対して、以下のスコープをSelect 。
- Generate tokenアイコンをクリックしてください。
- 新しく生成されたトークンをコピーするには、を押してください。
そして、安全な場所に保存してください。このトークンは、GitHub プラグインの構成に使用されます。
GitHubプラグインを設定する
- Cloud Exchangeで Settings に移動し、 Pluginsをクリックします。
- プラグイン作成ページを開くには、 GitHubプラグインボックスを検索して選択してください。
- 最初のページに基本情報を入力してください。
- 構成名：統合に適した名前を入力してください。
- ポーリング間隔：環境のニーズに合わせて調整してください。本番環境では、5分未満にしないことを推奨します。
- 経年劣化基準：デフォルトのままにしてください。
- 評判設定の上書き：デフォルト設定のままにします。
- SSL検証を有効にする：デフォルトのままにしてください。
- Nextをクリックしてください。
- 2ページ目で設定パラメータを入力してください。
- ベースURL：GitHub APIのベースURLを入力してください（デフォルト値を変更する必要がある場合のみ）。
- APIトークン：GitHub APIトークンを入力してください。
- リポジトリ名: ファイルハッシュを取得するリポジトリ名をカンマ区切りで入力してください。すべてのアクセス可能なリポジトリを含める場合は、空欄のままにしてください。
- タグ：デフォルトのままにしてください。
- 割り当て制限：デフォルトのままにしてください。
- 右上隅のSaveクリックしてください。Threat Exchange > Pluginsにアクセスして、新しい GitHub プラグインを確認してください。
NetskopeとGitHubの共有設定
- Threat Exchangeに移動してSharingを選択してください。「共有」ページには、以下に示すように、各共有設定における既存の関係がグリッドビューで表示されます。共有ページには、あるプラグインから別のプラグインへの新しい共有を設定するための入力欄もあります。
- Add Sharing Configurationをクリックし、ソース構成のドロップダウン リストからGithubを選択します。
- ビジネスルールSelect 、次に宛先構成にNetskopeを選択します。 設定の共有は一方向です。あるプラグインから取得したデータは、別のプラグインと共有されます。双方向または多方向の共有を実現するには、それぞれを個別に設定してください。
- 対象Select 。 各プラグインは、IoC（侵害指標）のターゲットまたは宛先が異なります。
選択したターゲット（URLリストに追加、またはファイルハッシュリストに追加）に応じて、残りのオプションが変わります。もし ファイルハッシュリストであれば、次のステップに進みます。
URLリストの場合は、リスト名を選択し、新しいリスト名を入力してください。リスト名はNetskopeのUIに存在しなければなりません。URLリストの作成方法については、 「URLリストの追加」を参照してください。今、URLリストタイプを選択し、次にリストサイズとデフォルトURLを選択します。
- ファイルハッシュリストを追加するには、リスト名、リストサイズ、およびデフォルトのファイルハッシュを入力します。リスト名は、Netskope UI のSettings > Policies > Profilesに存在している必要があります。ハッシュのファイルプロファイルの作成方法については、 「ファイルプロファイルの追加」を参照してください。
- Saveをクリックしてください。
- 手順2～6を繰り返しますが、ソース構成としてNetskope 、宛先構成としてGitHubを選択してください。
- Saveをクリックしてください。
アクティブなソースポーリングに新しい共有設定を追加すると、ソース設定の既存のIoCが宛先設定に共有されます。新しい共有構成が構築されるたびに、送信元と送信先の組み合わせに一致する場合、すべてのアクティブなIoCも共有対象として検討されます。
注記
データを取り込むためのAPIを持たないプラグインは、脅威データを受信できません。これは、インストールされたプラグインAPI Sourceにも当てはまります。これは、データをプッシュするリモート サードパーティ システムの API エンドポイントに関連付けられたバケットを提供します。 共有ポリシーが追加されると、それが有効になります。
共有構成が作成されると、共有テーブルには、呼び出されるルール、潜在的なIoC一致を提供するソースシステム、一致するIoCを受信する宛先システム、およびそのルールに適用されるターゲットが表示されます。複数の共有構成を設定することで、システム宛先システム上であっても、特定のIoCを複数のターゲットにマッピングすることをサポートできます。
共有構成の変更、テスト、または削除
各設定は3つのアクションをサポートします。
 |
- 鉛筆アイコンをクリックしてルールを編集してください。
- 同期アイコンをクリックして、ルールをテストしてください。これは、指定された期間とルールに基づいて、実際に宛先システムに送信されるIoC（侵害指標）の数をテストするものです。
- ゴミ箱アイコンをクリックしてルールを削除してください。
GitHubプラグインを検証する
統合を検証するには、GitHub上で設定済みのユーザーがアクセスできるリポジトリが少なくとも1つ必要です。
- Threat Exchangeに移動して、 Threat IoCsをクリックしてください。GitHubプラグインからのレコードが表示されるはずです。ソース値に基づいてフィルタリングすることで、NetskopeとGitHubの両方のプラグインを確認できます。
- NetskopeのUIで Policies > File > Your Custom File Profile に行き、 File Hashをクリックします。
- プラットフォーム間でデータがブローカされていない場合は、 Cloud Exchangeの監査ログを確認できます。 Cloud ExchangeでLoggingに移動し、ログを確認してエラーを探してください。
