Upgrade the Python version to 3.11

Supported in:

Both the certified and customized code in the Marketplace integrations run on Python. To help improve both security and performance, certain Python versions are being deprecated in a phased approach and the platform is moving to Python version 3.11.

If you have custom code written in an unsupported Python version (certified or custom), you need to update the integration code manually. You can use the IDE staging mode to update the integration code without impacting production.

Before you begin

Make sure that you have All Environments selected in your permission group. For more information, refer to Work with permission groups.

Upgrade integrations

  1. Go to Response > IDE.
  2. Pay attention to the banner which lets you know if there are integrations running outdated versions of Python. This banner also appears on the Marketplace and Playbooks page.
  3. Click View Integration to see a list of these integrations.
    bannerattopofscreen
  4. Click Close.
  5. Select the required integration on the integrations list.
  6. Click more_vert More > Push to staging. This step creates a copy of the integration that you can test and run new code changes in before pushing it live to production.
  7. Click the toggle from Production to Staging in order to enter the Staging mode.
    toggletostaging
  8. On the same integration, click more_vert More > Configure instance. For information on how to configure instances, read Configure instances. Note that this instance is a specific staging instance and won't appear in the integration configuration page. Only a single staging instance is supported for each integration.
  9. Continue to one of the following procedures:

Upgrade certified integrations to Python 3.11

  1. Click Upgrade to upgrades the integration and its dependencies to Python version 3.11.
  2. If this integration includes custom items, make sure to update the code.
  3. In the Testing area, enter the required parameters, including the staging instance that you configured earlier.
  4. After making sure there are no errors in the Debug Output, on the same integration click more_vert More > Push to production. Click the toggle back to Production mode if required.

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 to Python 3.11.
  3. Make a note of each of the dependency names under Script Dependencies and save them on your desktop.
  4. Delete these dependencies from the list.
  5. Click Save.
  6. 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.
  7. The platform downloads each dependency with Python 3.11 already configured.
  8. After you finish reloading each dependency, click Save.

Remote agents

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

  1. Go to SOAR Settings > Advanced > Remote Agents.
  2. Click Update Available.
  3. Upgrade the agent according to the instructions:
  4. Upgrade the integrations as described in this document.

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