IDE を使用する
以下でサポートされています。
Google SecOps
SOAR
このドキュメントでは、統合開発環境(IDE)の本番環境モードについて説明します。IDE は、コードの表示、編集、テストを行うためのフレームワークです。商用統合のコードを表示し、カスタム統合をゼロから作成するか、商用統合コードを複製して作成できます。
IDE では、カスタム統合の管理、インポート、エクスポートを行います。
IDE を開く
IDE を開く手順は次のとおりです。
- IDE を開くには、メインメニューで [Automation] > [IDE] に移動します。[IDE] ページが開きます。
[IDE] ページでは、次のオプションにアクセスできます。
| オプション | 説明 |
|---|---|
| 統合 タイプ | [インテグレーション] または [タイプ](コネクタ、アクション、ジョブ、マネージャー)を選択します。 |
| エクスポート インポート | 統合から個々のアイテムまたは複数のアイテムをエクスポートします。依存アイテムは、個々のアイテムをエクスポートするときに含まれますが、パッケージ全体をエクスポートするときには含まれません。 エクスポートされるファイルは、JSON ファイルを含む ZIP アーカイブです。インポート時に、個々のアイテムを既存の統合に追加するか、パッケージ全体をインポートするかを選択できます。以前の(V1 - データプレーンが無効)エクスポート / インポート形式の場合、パッケージには integrations.def ファイルと、ActionsDefinitions、ActionsScripts、Dependencies、Managers の各フォルダが含まれている必要があります。新しい(V2 - データプレーンが有効)エクスポート / インポート形式の場合、パッケージ フォルダには metadata.json ファイルを含める必要があります。また、actions、connectors、jobs、dependencies の各フォルダを含めることができます。 データプレーンが有効になっている環境から統合をエクスポートし、データプレーンが有効になっていない環境にインポートすることはサポートされていません。逆方向(データプレーンが有効になっていない環境からデータプレーンが有効になっている環境へのエクスポート)はサポートされています。 |
| [Hide Inactive/Show All] をクリックして、無効化されたアイテム(アクション、コネクタ)を表示または非表示に切り替えます。 | |
| 新しいカスタム統合、コネクタ、アクション、ジョブ、マネージャーを追加します。 |
コネクタを追加する
コネクタを追加する手順は次のとおりです。
- [Create New Item] をクリックし、[Connector] を選択します。
- 名前と必要な統合を入力します。
- [作成] をクリックします。
- 統合の詳細を追加します。
- 必要なパラメータを追加します。
- [コネクタ] トグルをクリックして、コネクタを有効にします。
- 完了したら、[保存] をクリックするか、
Ctrl + Sキーを押します。
[詳細] タブでは、次のオプションを使用できます。
| オプション | 説明 |
|---|---|
| 削除 | カスタム統合のアイテムでのみ使用できます。 |
| Play | スクリプトのテストメソッドを実行します。結果は [Testing] タブに表示され、デバッグ出力は [Debug Output] セクションに表示されます。 |
| file_json JSON サンプルを管理 | JSON サンプルのインポート / エクスポート ダイアログで、[Include JSON Result] が有効になっていることを確認します。その後、アクションの JSON 結果サンプルをインポートまたはエクスポートできます。 |
| 詳細 | ユーザー指定の入力と、統合名などの他のパラメータを入力します。 |
| バージョン管理 | バージョン管理 - アクション、ジョブ、コネクタを選択し、クリックして次のオプションを表示します。 新しいバージョンとして保存: オブジェクトを新しいバージョンとして保存します。オプションでコメントを追加できます。変更履歴を表示: 以前のバージョンを表示、復元できます。少なくとも 1 つのバージョンが保存されている場合にのみ使用できます。[復元] をクリックすると、いつでも以前のバージョンに戻すことができます。これは、以前にアクション、ジョブ、コネクタ、マネージャーで [Save as New Version] をクリックした場合にのみ使用できます。 |
| 重複アイテム | アイテム(ジョブ、アクション、コネクタ、マネージャー)を複製します。保存すると、複製されたアイテムが 鍵 ロックアイコンなしでリストに表示されます。 |
カスタム インテグレーションを作成する
- [Create New Item] をクリックし、[Integration] を選択します。
- 名前を入力して [Create] をクリックします。
-
作成した統合をリストから選択し、次の情報を入力します。
- 説明: Content Hub に表示され、すべての Google Security Operations ユーザーに表示されます。
- SVG アイコン: 統合とともに表示される SVG アイコンをアップロードします。
- 画像: Google SecOps ユーザー向けの Content Hub 画像をアップロードします。
- ライブラリ: pip を使用して Python ライブラリを追加します。
- スクリプトの依存関係: .WHL、.PY、.TAR、.GZ ファイルをアップロードします。これらのスクリプトにより、統合にさらに機能が追加されます。
- パラメータ: タイプ、デフォルト値、必須ステータスが定義された構成可能なフィールドを追加します。
- 完了したら、[保存] をクリックします。
ジョブの作成
ジョブを作成する手順は次のとおりです。
- [Create New Item] をクリックし、[Job] を選択します。
- 名前と必要な統合を入力します。
- [作成] をクリックします。
- 省略可: ユーザーまたはスクリプト入力のパラメータを追加します。
- [保存] をクリックするか、
Ctrl + Sを押します。 - arrow_right [Play Item] をクリックしてスクリプトを実行します。
- [Automation] > [Jobs Scheduler] に移動します。
- [ add 新しいジョブを作成] をクリックし、作成したジョブを選択します。
- [レスポンス] > [ジョブ スケジューラ] で、作成したジョブ(スクリプト)を実行するのに必要な時間を選択します。
ハンドブックで使用する新しいアクションを作成する
ハンドブックの新しいアクションを作成する手順は次のとおりです。
- [Create New Item] をクリックし、[Action] を選択します。
- 名前と必要な統合を入力 > [作成] をクリックします。
- 必要に応じてコードを編集します。
- アクションがハンドブックで JSON 結果を返す必要がある場合は、[JSON 結果を含める] を有効にします。
- 省略可: 入力フィールドとして表示するパラメータを追加します。
- アクションを有効にして、[保存] をクリックします。
- [Polling Configuration] では、アクションがタイムアウトした場合のタイムアウトとデフォルトの戻り値を設定できます。定義されたタイムアウト期間内にアクションが完了しなかった場合に返すデフォルト値を設定することもできます。
これで、[Playbook] > [Actions] でアクションを使用できるようになりました。
カスタム マネージャーを作成する
カスタム マネージャーを作成する手順は次のとおりです。
- [Create New Item] をクリックし、[Manager] を選択します。名前と必要な統合を入力します。
- [作成] をクリックします。
- 必要に応じてコードを編集します。
- [保存] をクリックします。
IDE カスタムコードのセキュリティ
安全なコード実行環境を確保するため、IDE 内のすべてのカスタム Python コードはサンドボックス環境で実行されます。この環境はメインサーバーから分離されており、権限の低いユーザーで動作します。基盤となるオペレーティング システムへのアクセスは、一般的な統合タスクと自動化タスクに必要な非管理コマンドとディレクトリの許可リストに厳密に制限されています。このサンドボックス アプローチにより、幅広い Python コードを実行できる柔軟性を備えながら、堅牢なセキュリティを実現できます。さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。