Python のバージョンをアップグレードする

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

このドキュメントでは、Google Security Operations Marketplace で認定済みインテグレーションとカスタム インテグレーションを最新の Python バージョンにアップグレードする方法について説明します。古い Python バージョンは非推奨になるため、サポートされていないバージョンを使用している統合は、継続的な運用を容易にするために更新する必要があります。

認定インテグレーションまたはカスタム インテグレーションのコードで非推奨の Python バージョンが使用されている場合は、手動で更新する必要があります。IDE ステージング モードを使用して、本番環境に影響を与えることなく統合コードを更新します。

始める前に

権限グループに [すべての環境] へのアクセスが含まれていることを確認します。詳細については、 権限グループを操作するをご覧ください。

インテグレーションをアップグレードする

  1. [Response>IDE] に移動します。古いバージョンの Python を使用しているインテグレーションがある場合は、IDE、Marketplace、Playbooks の各ページにバナーが表示されます。
  2. [統合を表示] をクリックして、統合のリストを表示します。
  3. [閉じる] をクリックしてバナーを閉じます。
  4. 統合のリストで、アップグレードする統合を選択します。
  5. more_vert [その他] > [ステージングにプッシュ] をクリックします。この手順では、テスト用のインテグレーションのコピーを作成します。
  6. [Production](本番環境)の切り替えボタンをクリックして、[Production](本番環境)から [Staging](ステージング)に切り替えます。
  7. 同じ統合で、 more_vert (その他)> [インスタンスを構成] をクリックします。
  8. 次のいずれかのアップグレード パスに進みます。

インスタンスの構成方法については、 インスタンスを構成するをご覧ください。これにより、メインの構成リストに表示されないステージング インスタンスが作成されます。インテグレーションごとに許可されるステージング インスタンスは 1 つのみです。

認定インテグレーションを最新の Python バージョンにアップグレードする

  1. [Response > IDE] で、[Upgrade] をクリックして、インテグレーションとその依存関係を最新の Python バージョンに切り替えます。
  2. この統合にカスタム要素が含まれている場合は、それに応じてコードを更新します。
  3. [テスト] セクションで、前に構成したステージング インスタンスなど、必要なパラメータを入力します。
  4. [Debug Output] にエラーがないことを確認します。
  5. 同じ統合で、 more_vert [その他] > [本番環境にプッシュ] をクリックします。
  6. 必要に応じて、[本番環境] 切り替えボタンをクリックして [本番環境] モードに戻します。

カスタム統合を最新の Python バージョンにアップグレードする

カスタム統合で Script Dependencies を更新する手順は次のとおりです。

  1. more_vert [その他] > [カスタム統合を構成] をクリックします。
  2. [Python で実行] ダイアログの [Python で実行] フィールドを最新の Python バージョン(Python 3.11 など)に変更します。
  3. [スクリプトの依存関係] で、依存関係の名前をコピーしてローカルに保存します。
  4. リストからこれらの依存関係を削除し、[保存] をクリックします。
  5. ファイルの各依存関係名(バージョンまたはターゲット OS を除く)を [ライブラリ] フィールドにコピーし、[追加] をクリックします。たとえば、requests-2.27.1-none-any.whlrequests に変更して、[ライブラリ] フィールドに追加します。プラットフォームは、最新の Python バージョンがすでに構成されている各依存関係をダウンロードします。

リモート エージェントをアップグレードする

リモート エージェントを使用している場合は、エージェントと、そのエージェントで実行されているインテグレーションの両方を次のようにアップグレードする必要があります。

  1. [SOAR 設定] > [詳細設定] > [リモート エージェント] に移動します。
  2. [アップデートが利用可能] をクリックします。
  3. 適切な方法でエージェントをアップグレードします。
  4. エージェントをアップグレードしたら、このドキュメントで説明する統合のアップグレード手順を行います。

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