使用應對手冊模擬工具

支援的國家/地區:

應對手冊模擬工具提供簡化的方法,可減少時間和工作量,加快應對手冊的開發速度。

應對手冊模擬工具提供多項重要功能,可讓您:

  • 在預先發布環境中作業,測試動作並觀察結果,不會影響實際工作環境資料 (特別是停用劇本時)。
  • 協助測試每個劇本步驟或區塊,確認工作流程運作正常。
  • 測試劇本中的所有可能條件分支,確認涵蓋範圍全面且行為可預測。

搭配應對手冊使用應對手冊模擬工具

無論是使用現有應對手冊或建立新應對手冊,請務必先開啟應對手冊模擬工具。頂端會顯示綠色指標,確認這項功能已啟用。

如果您在有效應對手冊上使用應對手冊模擬工具,會影響觸發該應對手冊的所有傳入快訊。這是因為儲存含有模擬資料的應對手冊,會將該資料套用至正式環境中的即時案件,可能影響實際結果。

  1. 將指標懸停在案件快訊上,依序點選 more_vert「快訊選項」,然後選取「將快訊擷取為測試案例」。這項動作會建立測試案例,用於執行模擬劇本。測試案例中修改的實體不會影響一般案例中的實體。
  2. 將指標移至「Playbooks」(應對手冊) 頁面底部,然後選取測試案例。請確認所選測試案例與要執行的應對手冊相符。如要確認,請點選「實體」,並驗證應對手冊是否能處理該測試案例中的實體。
  3. 按一下「執行」。模擬器會處理步驟、執行定義的動作,並提供結果。

解讀每個步驟的模擬器結果

按一下「執行」後,控制台的第一列會顯示為即時劇本。每個模擬步驟都會顯示選項,通常包括「案件資料」、「查看結果」和「固定結果」(或「插入結果」)。手動步驟會提示按鈕輸入參數、提供回應,並執行步驟。

案件資料

「案例資料」圖示會開啟對話方塊,顯示特定階段的案例資訊 (目前動作執行完畢後)。這個對話方塊會動態更新,顯示目前步驟的結果。如果動作為案件新增了擴充功能,這裡就會顯示。由於顯示的是步驟執行後的案件狀態,模擬控制台中的每個步驟資料都會有所不同。檢查不同步驟的案件資料,有助於瞭解劇本執行期間套用至案件的變更。對話方塊中的多個分頁提供其他詳細資料。

查看結果

「查看結果」選項會顯示目前步驟的具體動作結果。顯示的資訊與案件總覽或案件牆類似,也包含任何擴充功能的詳細資料。

您可以存取下列資訊:

  • 主要分頁會顯示輸出訊息、表格、連結和附件。
  • 「技術詳細資料」分頁會顯示動作結果和 JSON 結果 (如有)。

與其他選項類似,您可以點選資料進行深入檢查。在「查看結果」頁面中,您也可以點選「設定 JSON 結果」。這項功能可讓您取代目前動作的 JSON 範例。您可以直接在整合開發環境 (IDE) 中修改這個 JSON 範例,然後在運算式建構工具中以此為基礎,從 JSON 結果中擷取特定資料。

釘選結果

步驟順利執行後,即可使用「固定結果」選項。這項功能非常實用,可讓您將動作的結果視為固定值。

釘選結果可節省時間,原因如下:

  • 不必等待第三方服務傳回結果。
  • 減少對這些服務發出的查詢數量,有助於節省憑證。

基本上,重新執行劇本時,系統會「略過」任何有釘選結果的步驟,不會再次執行其程式碼,並直接使用釘選結果。您也可以插入自己的模擬資料,修改這項結果。啟用「固定結果」後,動作會進入模擬模式,步驟的視覺呈現通常會從藍色背景變為灰色,清楚指出該步驟已啟用「模擬」模式。

插入結果

如果步驟失敗,「插入結果」選項就會顯示。這項功能可讓您手動插入模擬資料。下次執行這個特定步驟時,系統會將您手動提供的資料做為結果傳回。

按一下這個選項後,系統會自動為動作啟用「模擬」模式。步驟的視覺化呈現方式會從藍色背景變更為灰色背景,清楚指出「模擬」模式已啟用。處於「模擬」模式時,所有步驟都必須填寫「指令碼結果」欄位。

插入模擬資料

如要插入模擬資料,請考量下列幾個應用實例:

  • 隨時隨地建構及測試教戰手冊:您可以執行步驟、查看結果,並立即瞭解如何在教戰手冊中進一步使用該資料。
  • 成功執行後節省時間:你可能想釘選步驟的結果。這樣一來,後續測試時就不會重複對第三方 API 執行這個步驟,可節省時間。
  • 測試不同情境:您可以變更步驟結果,在各種情況下測試劇本。設定不同的模擬資料,即可影響後續條件和動作 (這些條件和動作會依據先前的結果)。舉例來說,如果劇本的條件會分支成兩條以上的路徑,您可以透過模擬資料「強制」劇本採取特定分支路徑。

插入模擬資料

您可以透過兩種主要方式,將模擬 (虛擬) 資料插入劇本:透過「Playbook step configuration」(劇本步驟設定) 對話方塊,或在模擬器執行後使用「Pin Results」(釘選結果) (或「Insert Results」(插入結果))

使用 Playbook 步驟設定對話方塊

  1. 在應對手冊中,按一下步驟設定對話方塊。
  2. 切換「模擬模式」即可啟用。動作的視覺呈現方式會變更為灰色,表示動作處於「模擬模式」
  3. 在「動作結果」部分,您可以插入模擬 (虛擬) 資料。包括:
    • 指令碼結果:為以指令碼為基礎的動作提供模擬結果。
    • JSON 結果:輸入 JSON 資料,可能需要從 JSON 程式碼中擷取特定資料。您也可以點按「載入範例」載入範例輸出內容。這會載入動作的預期 JSON 結果,在下列情況下特別實用:
      • 模擬尚未執行,輸出內容為空白。
      • 模擬失敗,因此不會顯示任何結果。
      • 您想以範例覆寫現有結果 (來自先前的釘選或插入)。
    • 擴充功能:您可以使用先前模擬執行的擴充功能,也可以建立自訂擴充功能鍵。

使用模擬工具執行後的結果

釘選結果

如果步驟順利執行,您可以按一下該動作旁的「固定結果」。之後會發生以下情況:

  • 系統會自動以「模擬」模式開啟步驟
  • .
  • 最近一次成功執行的模擬結果會固定在步驟中。你可以使用這些結果,也可以編輯。
  • 您可以使用 JSON 編輯器編輯 JSON 結果,或按一下「載入範例」來覆寫。
  • 您可以使用先前模擬執行的擴充功能,或建立自訂擴充功能鍵。

插入結果

如果某個步驟失敗,可以按一下該動作旁的「插入結果」。之後會發生以下情況:

  1. 現在,每當步驟執行時,系統都會傳回這項資料。

關閉應對手冊模擬工具

關閉「應對手冊模擬工具」後,系統會隱藏底部控制台,且「模擬模式」中的所有步驟都會還原為一般的「即時」模式。但應對手冊區塊是例外情況,您必須關閉區塊模擬工具,才能關閉區塊的模擬模式。插入的模擬資料會儲存起來,下次開啟模擬器時即可使用。

使用應對手冊區塊

您也可以使用應對手冊模擬工具,建構及測試新的應對手冊區塊。 如果模塊處於模擬模式,使用該模塊的所有父項應對手冊也會使用模塊的模擬資料。

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