升級 Python 版本

支援的服務:

本文說明如何將 Content Hub 中經過認證和自訂的整合項目、遠端代理程式和連接器,升級至最新 Python 版本。由於舊版 Python 已淘汰,使用不支援版本的整合項目必須更新,才能繼續運作。 將整合項目更新至最新 Python 版本後,也必須升級每個連接器。

如果您的認證或自訂整合代碼使用已淘汰的 Python 版本,請務必手動更新。使用 IDE 預備環境模式更新整合代碼,不影響正式環境。

事前準備

請確認權限群組包含「所有環境」存取權。詳情請參閱「使用權限群組」。

升級整合項目

  1. 依序前往「自動化」>「IDE」。如果使用的是 SOAR 專用平台,請依序前往「Response」>「IDE」。如果有任何整合項目使用過時的 Python 版本,IDE、內容中心和應對手冊頁面就會顯示橫幅。
  2. 按一下「查看整合」,即可查看整合清單。
  3. 按一下「關閉」即可關閉橫幅。
  4. 在整合清單中,選取要升級的整合項目。
  5. 依序點選「 more_vert 更多」>「推送至測試環境」。這個步驟會建立整合項目的副本,用於測試。
  6. 按一下「正式環境」切換鈕,從「正式環境」切換至「測試環境」。
  7. 在同一個整合項目中,依序點選「more_vert」 more_vert 「更多」>「設定執行個體」。
  8. 請繼續採用下列任一升級路徑:

如要瞭解如何設定執行個體,請參閱「設定執行個體」。這會建立一個不顯示在主要設定清單中的測試執行個體。每項整合只能有一個測試執行個體。

請務必更新每個連接器。

將認證整合項目升級至最新 Python 版本

  1. 在「自動化」>「IDE」中,按一下「升級」,將整合項目及其依附元件切換至最新 Python 版本。如果使用的是 SOAR 專用平台,請依序前往「Response」>「IDE」。
  2. 如果這項整合包含自訂元素,請一併更新其程式碼。
  3. 在「Testing」(測試) 部分,輸入必要參數,包括您先前設定的測試執行個體。
  4. 確認「Debug Output」中沒有錯誤。
  5. 在同一個整合項目中,依序點選「more_vert」 more_vert 「更多」>「推送至正式環境」。
  6. 如有需要,請按一下「正式環境」切換鈕,切換回「正式環境」模式。

將自訂整合項目升級至最新 Python 版本

請按照下列程序,更新自訂整合中的指令碼依附元件。

  1. 依序點選「more_vert」 more_vert 「Configure custom integration」。
  2. 在對話方塊的「Running on Python」(在 Python 上執行) 欄位中,將「Running on Python」(在 Python 上執行) 欄位變更為最新 Python 版本 (例如 Python 3.11)。
  3. 在「Script Dependencies」下方,複製並在本機儲存依附元件名稱。
  4. 從清單中刪除這些依附元件,然後按一下「儲存」。
  5. 將檔案中的每個依附元件名稱 (不含版本或目標 OS) 複製到「Libraries」欄位,然後按一下「Add」。例如,將 requests-2.27.1-none-any.whl 變更為 requests,然後新增至「Libraries」欄位。平台會下載各項依附元件,並預先設定最新 Python 版本。

升級遠端代理程式

如果您使用遠端代理程式,則必須升級代理程式及其整合項目,並在代理程式上執行下列操作:

  1. 依序前往「設定」>「管理」>「SOAR 遠端代理程式」。如果使用 SOAR 專用平台,請依序前往「設定」>「進階」>「遠端代理程式」。
  2. 按一下「有可用的更新」。
  3. 使用適當的方法升級代理程式:
  4. 升級代理程式後,請按照本文所述的整合升級步驟操作。

升級連接器

您必須將自訂和商用連接器升級至最新 Python 版本。

  1. 依序前往「設定」>「資料管理」>「連接器」。如果使用僅限 SOAR 的平台,請依序前往「設定」>「擷取」>「連接器」。
  2. 按一下畫面頂端的黃色「更新」按鈕。
  3. 按一下 [儲存]。

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。