IDE を使用する

以下でサポートされています。

このドキュメントでは、統合開発環境（IDE）の本番環境モードについて説明します。IDE は、コードの表示、編集、テストを行うためのフレームワークです。商用統合のコードを表示し、カスタム統合をゼロから作成するか、商用統合コードを複製して作成できます。

IDE は、カスタム統合の管理、インポート、エクスポートを行う場所です。

IDE を開く

IDE を開く手順は次のとおりです。

  • IDE を開くには、メインメニューで [レスポンス] > [IDE] に移動します。[IDE] ページが開きます。

[IDE] ページでは、次のオプションにアクセスできます。

オプション 説明
統合
タイプ		 [インテグレーション] または [タイプ]（コネクタ、アクション、ジョブ、マネージャー）を選択します。
エクスポート
インポート		 インテグレーションから 1 つまたは複数のアイテムをエクスポートします。依存アイテムは、個々のアイテムをエクスポートするときに含まれますが、パッケージ全体をエクスポートするときには含まれません。
エクスポートされたファイルは、JSON ファイルを含む ZIP アーカイブです。インポート時に、個々のアイテムを既存の統合に追加するか、パッケージ全体をインポートするかを選択できます。以前の（V1 - データプレーンが無効）エクスポート/インポート形式の場合、パッケージには integrations.def ファイルと、ActionsDefinitions、ActionsScripts、Dependencies、Managers の各フォルダが含まれている必要があります。新しい（V2 - データプレーンが有効）エクスポート/インポート形式の場合、パッケージ フォルダには metadata.json ファイルが含まれている必要があります。また、actions、connectors、jobs、dependencies の各フォルダを含めることもできます。
データプレーンが有効になっている環境からインテグレーションをエクスポートし、データプレーンが有効になっていない環境にインポートすることはできません。逆方向（データプレーンが有効になっていない環境からデータプレーンが有効になっている環境へのエクスポート）はサポートされています。
[Hide Inactive/Show All] 切り替えをクリックして、無効化されたアイテム（アクション、コネクタ）を表示または非表示にします。
新しいカスタム統合、コネクタ、アクション、ジョブ、マネージャーを追加します。

コネクタを追加する

コネクタを追加する手順は次のとおりです。

  1. [Create New Item] をクリックし、[Connector] を選択します。
  2. 名前と必要な統合を入力します。
  3. [作成] をクリックします。
  4. 統合の詳細を追加します。
  5. 必要なパラメータを追加します。
  6. [コネクタ] トグルをクリックして、コネクタを有効にします。
  7. 完了したら [保存] をクリックするか、Ctrl + S キーを押します。

[詳細] タブには、次のオプションがあります。

オプション 説明
削除 カスタム統合のアイテムでのみ使用できます。
再生 スクリプトのテストメソッドを実行します。結果は [テスト] タブに表示され、デバッグ出力は [デバッグ出力] セクションに表示されます。
file_json JSON サンプルを管理する [JSON サンプルのインポート/エクスポート] ダイアログで、[JSON 結果を含める] が有効になっていることを確認します。アクションの JSON 結果のサンプルをインポートまたはエクスポートできます。
詳細ユーザーが指定した入力や、統合名などの他のパラメータを入力します。
バージョン管理 バージョン管理 - アクション、ジョブ、コネクタを選択してクリックすると、次のオプションが表示されます。 Save as New Version: オブジェクトを新しいバージョンとして保存します（コメントは省略可）。変更履歴を表示: 以前のバージョンを表示して復元します。少なくとも 1 つのバージョンが保存されている場合にのみ使用できます。[復元] をクリックすると、いつでも以前のバージョンに戻すことができます。これは、以前にアクション、ジョブ、コネクタ、マネージャーで [新規バージョンとして保存] をクリックした場合にのみ使用できます。
アイテムの複製 アイテム（ジョブ、アクション、コネクタ、マネージャー）を複製します。保存すると、複製がリストに表示されます。このとき、 ロック アイコンは表示されません。

カスタム統合を作成する

  1. [Create New Item] をクリックし、[Integration] を選択します。
  2. 名前を入力して [Create] をクリックします。
  3. リストから作成した統合を選択し、次の情報を入力します。
    • 説明: コンテンツ ハブに表示され、すべての Google Security Operations ユーザーに表示されます。
    • SVG アイコン: 統合とともに表示される SVG アイコンをアップロードします。
    • 画像: Google SecOps ユーザー向けの Content Hub の画像をアップロードします。
    • ライブラリ: pip を使用して Python ライブラリを追加します。
    • スクリプトの依存関係: .WHL、.PY、.TAR、.GZ ファイルをアップロードします。これらのスクリプトにより、インテグレーションに機能が追加されます。
    • パラメータ: 定義された型、デフォルト値、必須ステータスを持つ構成可能なフィールドを追加します。
  4. 完了したら、[保存] をクリックします。

ジョブの作成

ジョブを作成する手順は次のとおりです。

  1. [Create New Item] をクリックし、[Job] を選択します。
  2. 名前と必要な統合を入力します。
  3. [作成] をクリックします。
  4. 省略可: ユーザーまたはスクリプトの入力用のパラメータを追加します。
  5. [保存] をクリックするか、Ctrl + S を押します。
  6. arrow_right [Play Item] をクリックして、スクリプトを実行します。
  7. [レスポンス] > [ジョブ スケジューラ] に移動します。
  8. [ add 新しいジョブを作成] をクリックし、作成したジョブを選択します。
  9. [レスポンス>ジョブ スケジューラ] で、作成したジョブ（スクリプト）を実行する必要な時間を選択します。

ハンドブックで使用する新しいアクションを作成する

プレイブックの新しいアクションを作成する手順は次のとおりです。

  1. [Create New Item] をクリックし、[Action] を選択します。
  2. 名前と必要な統合を入力 > [作成] をクリックします。
  3. 必要に応じてコードを編集します。
  4. アクションがハンドブックで JSON 結果を返す必要がある場合は、[Include JSON Result] を有効にします。
  5. 省略可: 入力フィールドとして表示するパラメータを追加します。
  6. アクションを有効にして、[保存] をクリックします。
  7. [Polling Configuration] では、タイムアウトと、アクションがタイムアウトした場合のデフォルトの戻り値を設定できます。定義されたタイムアウト時間内にアクションが完了しなかった場合に返すデフォルト値を設定することもできます。

これで、[Playbook] > [Actions] でアクションを使用できるようになりました。

カスタム マネージャーを作成する

カスタム マネージャーを作成する手順は次のとおりです。

  1. [Create New Item] をクリックし、[Manager] を選択します。名前と必要な統合を入力します。
  2. [作成] をクリックします。
  3. 必要に応じてコードを編集します。
  4. [保存] をクリックします。

IDE カスタムコードのセキュリティ

安全なコード実行環境を確保するため、IDE 内のすべてのカスタム Python コードはサンドボックス環境で実行されます。この環境はメインサーバーから分離され、低権限ユーザーで動作します。基盤となるオペレーティング システムへのアクセスは、一般的な統合タスクと自動化タスクに必要な管理者以外のコマンドとディレクトリの許可リストに厳しく制限されています。このサンドボックス アプローチにより、堅牢なセキュリティを確保しながら、幅広い Python コードを実行できる柔軟性が提供されます。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。