Upgrade the Python version to 3.11

Supported in:

This document explains how to upgrade certified and custom integrations in the Google Security Operations Marketplace to Python 3.11. As older Python versions are deprecated, integrations using unsupported versions must be updated to facilitate continued operation.

If your certified or custom integration code uses a deprecated Python version, you must manually update it. Use IDE Staging mode to update integration code without impacting production environments.

Before you begin

Make sure that your permission group includes All Environments access. For more information, refer to Work with permission groups.

Upgrade integrations

  1. Go to Response > IDE; if any integrations are using outdated Python versions, a banner appears in the IDE, Marketplace, and Playbooks pages.
  2. Click View Integration to see a list of integrations.
  3. Click Close to dismiss the banner.
  4. In the integrations list, select the integration to upgrade.
  5. Click more_vert More > Push to staging. This step creates a copy of the integration for testing.
  6. Click the Production toggle from Production to Staging.
  7. On the same integration, click more_vert More > Configure instance.
  8. Continue with either of the following upgrade paths:

For information on how to configure instances, read Configure instances. This creates a staging instance that does not appear in the main configuration list. Only one staging instance is allowed per integration.

Upgrade certified integrations to Python 3.11

  1. In Response > IDE, click Upgrade to switch the integration and its dependencies to Python 3.11.
  2. If this integration includes custom elements, update their code accordingly.
  3. In the Testing section, enter the required parameters, including the staging instance that you configured earlier.
  4. Verify that there are no errors in the Debug Output.
  5. On the same integration, click more_vert More > Push to production.
  6. Click the Production toggle back to Production mode, if needed.

Upgrade custom integrations to Python 3.11

Follow this procedure to update the Script Dependencies in custom integrations.

  1. Click more_vert More > Configure custom integration.
  2. In the dialog Running on Python field, change the Running on Python field to Python 3.11.
  3. Under Script Dependencies, copy and save the dependency names locally.
  4. Delete these dependencies from the list, and click Save
  5. Copy each of the dependency names (without the version or target OS) from your file to the Libraries field and click Add. For example, change requests-2.27.1-none-any.whl to requests and then add it to the Libraries field. The platform downloads each dependency with Python 3.11 already configured.

Upgrade remote agents

If you're working with Remote Agents, you need to upgrade both the agent and its integrations, running on them as follows:

  1. Go to SOAR Settings > Advanced > Remote Agents.
  2. Click Update Available.
  3. Upgrade the agent using the appropriate method:
  4. After upgrading the agent, follow the integration upgrade steps described in this document.

Need more help? Get answers from Community members and Google SecOps professionals.