整合 ServiceNow 與 Google SecOps

本文說明如何將 ServiceNow 與 Google Security Operations (Google SecOps) 整合。

用途

ServiceNow 整合功能會使用 Google SecOps 功能，支援下列用途：

  • 自動建立事件單：自動根據 SIEM 或其他安全工具發出的安全警示，建立 ServiceNow 事件。

  • 事件擴充和應變：減少手動開立支援單，並從原始警告中擷取相關資訊來擴充事件，簡化事件應變工作流程。

  • 網路釣魚補救措施：自動執行重複的網路釣魚調查步驟，例如收集電子郵件標題、調查附件，以及搜尋類似的電子郵件，加快回應速度。

  • 自動化協調處理安全漏洞：根據安全漏洞掃描結果，自動建立 ServiceNow 變更要求，以執行修補或緩解動作，協調處理安全漏洞修復工作流程。

  • 使用者生命週期自動化：根據 ServiceNow 工作流程的觸發條件，自動在各種系統 (存取控制、電子郵件平台、應用程式) 中佈建及取消佈建使用者。

  • 威脅情報背景資訊：直接從 ServiceNow 平台取得威脅情報資料，並將這些資料加入安全警示，為分析師提供更多背景資訊，以決定回應措施的優先順序。

事前準備

在 Google SecOps 平台中設定整合功能前，請務必完成下列必要條件：

  • ServiceNow 使用者帳戶：專屬使用者帳戶，具備足夠的權限，可查詢、建立及更新目標記錄。
  • ServiceNow 角色：請確認帳戶具備必要系統角色 (sn_incident_write 和 itil)，以及自訂使用者存取權設定，可讀取記事評論。
  • 網路連線：網路設定，可讓來自 Google SecOps IP 位址或遠端代理程式基礎架構的流量，連上 ServiceNow 執行個體端點。
  • 驗證詳細資料：決定貴機構的驗證政策。您可以使用標準的基本驗證或 OAuth 2.0 驗證。

在 ServiceNow 中設定使用者存取權

如要讓整合功能順暢地同步處理註解、更新欄位及執行動作，您必須在 ServiceNow 平台中執行下列管理工作。

如需 ServiceNow 介面的具體操作說明，請參閱官方 ServiceNow 產品說明文件。

  1. 建立自訂角色：依序前往「角色」>「新增」，然後建立專門用於處理 API 註解權限的新角色。
  2. 建立新的存取控制清單 (ACL) 規則：整合功能需要 sys_journal_field 表格的讀取權限，才能追蹤留言和工作附註。依序前往「Access Controls」>「New」。您必須使用具備提升權限的帳戶登入，才能建立這項規則。

  3. 設定 ACL 參數：

    • 將「Type」(類型) 設為 record。
    • 將「Operation」設為 read。
    • 在「名稱」欄位中，從第一個下拉式選單選取「Journal Entry [sys_journal_field]」，然後從第二個下拉式選單選取「-- None --」。
    • 前往表單底部的「需要角色」清單，然後新增您新建立的自訂留言角色。按一下「提交」。

  4. 指派整合帳戶的角色：前往「使用者」，開啟專屬整合帳戶，然後授予下列角色：

    • 您建立的自訂角色，用於讀取留言。
    • sn_incident_write：基本互動時為必填，例如「取得事件」和「更新事件」動作。
    • itil：執行 CMDB 動作和相關資產設定管理查詢函式時，必須提供這項資訊。

驗證設定選項

ServiceNow 整合功能支援三種不同的驗證方法。 請根據貴機構的安全性規定，選擇下列其中一個設定選項。

方法 1：OAuth 2.0 用戶端憑證流程 (建議)

這個方法會搭配使用 OAuth 2.0 用戶端憑證授權和使用者模擬，安全地限制資料存取權，不會向平台公開靜態使用者密碼。

階段 1：在 ServiceNow 中建立 OAuth 端點

  1. 在 ServiceNow 導覽選單中搜尋「Application Registries」，然後按一下「New」。
  2. 選取「New Inbound Integration Experience」(全新整合體驗)。
  3. 從連線類型清單中，選取「OAuth - Client credentials grant」(OAuth - 用戶端憑證授權)。
  4. 在「Name」(名稱) 欄位中，輸入端點設定的描述性名稱。
  5. 提供建立身分設定檔環境所需的 OAuth 提供者名稱或 ID。
  6. 在「OAuth 應用程式使用者」欄位中，選取要模擬的專屬 ServiceNow 使用者帳戶，並將其用於所有自動化 API 活動。
  7. 按一下「提交」或「儲存」。
  8. 重新開啟新建立的登錄記錄，複製並保護產生的「用戶端 ID」和「用戶端密碼」。

第 2 階段：在 Google SecOps 中設定

  1. 在 Google SecOps 中，依序前往「Response」>「Integrations Setup」，然後開啟 ServiceNow 設定視窗。
  2. 輸入 Api Root (將預設的預留位置網域替換為實際的 ServiceNow 執行個體網址)。
  3. 提供在第 1 階段產生的用戶端 ID 和用戶端密鑰。
  4. 確認「使用者名稱」、「密碼」和「重新整理權杖」欄位完全空白。
  5. 啟用「使用 OAuth 驗證」核取方塊設定。
  6. 按一下「測試」，使用連線 Ping 測試驗證參數。如果成功，請按一下「儲存」。

選項 2：基本驗證

此方法會直接驗證憑證。設定程序很簡單，但如果企業強制執行多重驗證 (MFA) 或封鎖基本驗證標頭，就可能無法使用。

  1. 在 ServiceNow 中，確認整合使用者具有本機「使用者名稱」和「密碼」。
  2. 在 Google SecOps 中設定整合時，請提供「Api Root」(API 根目錄) (將預設的預留位置網域換成實際的 ServiceNow 執行個體網址)、「Username」(使用者名稱) 和「Password」(密碼)。
  3. 將 OAuth 相關欄位留空，並確保 Use Oauth Authentication 處於關閉狀態 (取消勾選核取方塊)。
  4. 按一下「測試」，驗證連線參數。如果成功，請按一下「儲存」。

方法 3：更新權杖流程

如果貴機構要求使用 OAuth 安全控管，並透過重新整理權杖鏈在幕後以程式輔助方式擷取存取權杖，請使用這個方法。

  1. 在 ServiceNow 執行個體中完成第 1 階段，產生「用戶端 ID」和「用戶端密鑰」。
  2. 完成「產生重新整理權杖」一節中的步驟，即可擷取有效的授權權杖字串。
  3. 在 Google SecOps 中，開啟 ServiceNow 整合執行個體設定視窗。
  4. 使用已設定的憑證完整填入參數：
    • Api Root (將預設預留網域替換為實際的 ServiceNow 執行個體網址)。
    • 使用者名稱
    • 密碼
    • 用戶端 ID
    • 用戶端密碼
  5. 勾選「Use Oauth Authentication」核取方塊。
  6. 將從「產生重新整理權杖」部分工作流程擷取的權杖字串，貼到「重新整理權杖」欄位。
  7. 按一下「測試」，驗證連線參數。如果成功，請按一下「儲存」。

產生更新權杖 (Google SecOps)

如要產生更新權杖，您必須暫時設定整合項目，執行輔助動作。

  1. 在 Google SecOps 中，依序前往「Response」>「Integrations Setup」。
  2. 請確保這個初始設定步驟的「Use Oauth Authentication」(使用 OAuth 驗證) 核取方塊維持未勾選狀態。
  3. 使用「Api Root」(API 根目錄)、「Username」(使用者名稱)、「Password」(密碼)、「Client ID」(用戶端 ID) 和「Client Secret」(用戶端密鑰)，設定暫時的 ServiceNow 整合執行個體，然後按一下「Save」(儲存)。
  4. 模擬案件或開啟現有案件。
  5. 在案件中手動執行 ServiceNow「Get Oauth Token」動作。
  6. 從動作的 JSON 結果複製 refresh_token 值，在設定最終整合執行個體時，用於「Refresh Token」欄位。

整合參數

ServiceNow 整合需要下列參數：

參數 說明
`Api Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 帳戶的使用者名稱。
`Password`

必填。

ServiceNow 帳戶的密碼。
`Incident Table`

選填。

用於事件相關動作和記錄擷取的 API 資料表名稱或路徑。

根據預設，整合功能會使用 `table/incident` 路徑。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。
`Client ID`

選填。

ServiceNow 整合的用戶端 ID，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Client Secret`

選填。

ServiceNow 整合的用戶端密鑰，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Refresh Token`

選填。

ServiceNow 整合的更新權杖，使用更新權杖進行 OAuth 2.0 驗證時需要此權杖。

設定的更新權杖每 90 天會過期。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Use Oauth Authentication`

選填。

如果選取這個選項，整合服務會使用 OAuth 2.0 進行驗證。

OAuth 2.0 驗證需要設定用戶端憑證 (`Client ID` 和 `Client Secret`) 或 `Refresh Token`。

預設為停用。

如需在 Google SecOps 中設定整合功能的操作說明，請參閱「設定整合功能」。

如有需要，您可以在稍後階段進行變更。設定整合執行個體後，您可以在應對手冊中使用該執行個體。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 從工作台回覆待處理動作」和「執行手動動作」。

新增附件

使用「Add Attachment」動作，將附件新增至 ServiceNow 的資料表記錄。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「新增附件」動作需要下列參數：

參數 說明
`Table Name`

必填。

包含要新增附件之記錄的資料表名稱。
`Record Sys ID`

必填。

附件新增至記錄的系統 ID (`sys_id`)。
`File Path`

必填。

以半形逗號分隔的附件檔案絕對路徑清單。
`Mode`

選填。

如果記錄中已有名稱相同的檔案，系統會如何處理。

可能的值如下：

  • 「新增附件」：這個動作會將檔案新增為獨立附件。允許使用相同名稱的檔案。
  • 「Overwrite Existing Attachment」(覆寫現有附件)：這個動作會取代名稱相同的現有附件。

預設值為「新增附件」。

動作輸出內容

「新增附件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「新增附件」動作時收到的 JSON 結果輸出內容：

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}
輸出訊息

「新增附件」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS`

`Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS`

`No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS`

 動作成功。
`Error executing action "Add Attachment". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「新增附件」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

新增註解

使用「新增註解」動作，在 ServiceNow 事件中新增註解。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「新增留言」動作需要下列參數：

參數 說明
`Incident Number`

必填。

要新增註解的事件編號，格式為 `INCINCIDENT_NUMBER`。
`Comment`

必填。

要新增至事件的註解。

動作輸出內容

「新增註解」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「新增註解」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

新增留言並等待回覆

使用「新增註解並等待回覆」動作，在 ServiceNow 事件中新增註解，然後暫停應對手冊執行作業，直到該事件新增註解或回覆為止。這項動作的輸出內容是新留言的內容。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「新增留言並等待回覆」動作需要下列參數：

參數 說明
`Incident Number`

必填。

要新增註解的事件編號，格式為 `INCINCIDENT_NUMBER`。
`Comment`

必填。

要新增至事件的註解。

動作輸出內容

「新增留言並等待回覆」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「新增留言並等待回覆」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`new_comment`

為記錄新增註解

使用「Add Comment To Record」(在記錄中新增註解) 動作，在 ServiceNow 的特定表格記錄中新增註解或工作記事。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add Comment To Record」動作需要下列參數：

參數 說明
`Table Name`

必填。

要新增註解或附註的資料表名稱。
`Type`

必填。

要新增的註解或附註類型。

可能的值如下：

  • `Comment`
  • `Work Note`

預設值為「Comment」。
`Record Sys ID`

必填。

要新增留言或工作筆記的系統 ID (`sys_id`)。
`Text`

必填。

留言或工作附註的內容。
`Wait For Reply`

選填。

如果選取這個選項，動作會以非同步方式執行，並暫停執行，直到記錄中新增註解或工作附註為止。

如果您新增留言，這項動作會追蹤留言；如果您新增工作附註，這項動作會追蹤工作附註。

預設為停用。

動作輸出內容

「Add Comment To Record」(為記錄新增註解) 動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「Add Comment To Record」動作時收到的 JSON 結果輸出內容：

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}
輸出訊息

「Add Comment To Record」動作可傳回下列輸出訊息：

輸出訊息 訊息說明
`Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow. ` 動作成功。
`Error executing action "Add Comment To Record". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「Add Comment To Record」(在記錄中新增註解) 動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

新增上層事件

使用「新增上層事件」動作，為 ServiceNow 中的事件新增上層事件。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「新增父項事件」動作需要下列參數：

參數 說明
`Parent Incident Number`

必填。

父項事件編號，格式為 `INCINCIDENT_NUMBER` (例如 `INC0000051`)。

這項動作會將 `Child Incident Numbers` 中的所有事件新增為父項事件的子項。
`Child Incident Numbers`

必填。

以半形逗號分隔的事件編號清單，可設為指定父項事件的子項事件，格式為 `INCINCIDENT_NUMBER` (例如 `INC0000051`)。

動作輸出內容

「新增父項事件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「新增父項事件」動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
輸出訊息

「新增父項事件」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明
`Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS.` 動作成功。
`Error executing action "Add Parent Incident". 原因：ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

關閉事件

使用「Close Incident」(關閉事件) 動作關閉 ServiceNow 事件。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「Close Incident」(結案) 動作需要下列參數：

參數 說明
`Incident Number`

必填。

要關閉的事件編號，格式為 `INCINCIDENT_NUMBER`。
`Close Reason`

必填。

關閉事件的原因。
`Resolution Code`

必填。

事件的解決代碼。

可能的值如下：

  • `Duplicate`
  • `Known error`
  • `No resolution provided`
  • `Resolved by caller`
  • `Resolved by change`
  • `Resolved by problem`
  • `Resolved by request`
  • `Solution provided`
  • `Workaround provided`
  • `User error`

預設值為「Solution provided」。
`Close Notes`

必填。

事件的結案附註。

動作輸出內容

「Close Incident」(結案) 動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「Close Incident」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

建立快訊事件

使用「Create Alert Incident」(建立快訊事件) 動作，根據啟動應對手冊執行的快訊詳細資料，在 ServiceNow 中建立新事件。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「建立快訊事件」動作需要下列參數：

參數 說明
`Impact`

必填。

事件的影響程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Urgency`

必填。

事件的緊急程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Category`

選填。

事件類別。
`Assignment Group ID`

選填。

要指派事件的群組完整名稱。
`Assigned User ID`

選填。

要指派事件的使用者全名。
`Description`

選填。

事件說明。

動作輸出內容

「建立快訊事件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

下列範例顯示使用「建立快訊事件」動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「建立快訊事件」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

建立事件

使用「建立事件」動作，在 ServiceNow 建立新事件。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「建立事件」動作需要下列參數：

參數 說明
`Short Description`

必填。

事件的簡短說明。
`Impact`

必填。

事件的影響程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Urgency`

必填。

事件的緊急程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Category`

選填。

事件類別。
`Assignment Group ID`

選填。

要指派事件的群組完整名稱。

`Assigned User ID`

選填。

要指派事件的使用者全名。

`Description`

選填。

事件說明。
`Custom Fields`

選填。

JSON 格式的字串，內含要更新的欄位名稱和對應值 (例如 `{"location":"London", "category":"database"}`)。

您可以使用這個參數修改未明確定義為動作輸入內容的欄位。

動作輸出內容

「建立事件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「建立事件」動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「建立事件」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`incident_number` `INCIDENT_NUMBER`

建立記錄

使用「建立記錄」動作，在不同的 ServiceNow 資料表中建立新記錄。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「建立記錄」動作需要下列參數：

參數 說明
`Table Name`

選填。

要在哪個 ServiceNow 資料表中建立新記錄 (例如 `incident`)。
`Object Json Data`

選填。

JSON 物件，內含定義新記錄所需的欄位值配對 (例如事件欄位或 CMDB 項目屬性)。

動作輸出內容

「建立記錄」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「建立記錄」動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「建立記錄」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`object_sys_id` `OBJECT_SYS_ID`

下載附件

使用「下載附件」動作，將特定 ServiceNow 記錄隨附的檔案和文件下載到 Google SecOps 環境的本機資料夾。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「下載附件」動作需要下列參數：

參數 說明
`Table Name`

必填。

ServiceNow 資料表的名稱，其中包含要下載附件的記錄 (例如 `incident`)。
`Record Sys ID`

必填。

系統 ID (`sys_id`)，用於記錄下載附件的來源。
`Download Folder Path`

必填。

Google SecOps 環境中資料夾的絕對路徑，下載的附件會儲存至該資料夾。
`Overewrite`

選填。

如果選取這個選項，動作會覆寫名稱相同的檔案。

預設為停用。

動作輸出內容

「下載附件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「下載附件」動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}
輸出訊息

「下載附件」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME`

`Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME`

`Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME`

 動作成功。
`Error executing action "Download Attachments". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「下載附件」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

取得子事件詳細資料

使用「Get Child Incident Details」(取得子事件詳細資料) 動作，根據 ServiceNow 中的父事件擷取子事件的相關資訊。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「取得子事件詳細資料」動作需要下列參數：

參數 說明
`Parent Incident Number`

必填。

要從中擷取子事件詳細資料的父項事件編號，格式為 `INCINCIDENT_NUMBER`。
`Max Child Incident To Return`

選填。

動作從父項事件傳回的子項事件數上限。

預設值為 `50`。

動作輸出內容

「Get Child Incident Details」(取得子事件詳細資料) 動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 可用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
案件總覽表格

「Get Child Incident Details」動作會提供下表：

表格名稱：Child Incident Details

資料表欄：

  • 系統 ID (對應為 sys_id)
  • 數字 (對應為 number)
  • 簡短說明 (對應為 short_description)
  • 建立時間 (對應為 sys_created_on)
JSON 結果

以下範例顯示使用「Get Child Incident Details」(取得子事件詳細資料) 動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
輸出訊息

「取得子事件詳細資料」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.`

`Action wasn't able to retrieve information about the child incidents in ServiceNow. 原因：找不到事件 PARENT_INCIDENT_NUMBER。

`No child incidents were found.`

 動作成功。
`Error executing action "Get Child Incident Details". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「Get Child Incident Details」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

取得 CMDB 記錄詳細資料

使用「Get CMDB Record Details」(取得 CMDB 記錄詳細資料) 動作，從 ServiceNow 的相同類別取得詳細的 CMDB 記錄。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「取得 CMDB 記錄詳細資料」動作需要下列參數：

參數 說明
`Class Name`

必填。

要從中擷取記錄的 CMDB 類別名稱，例如 `cmdb_ci_appl`。

如要進一步瞭解類別名稱，請參閱「查看及編輯類別定義和中繼資料」。
`Sys ID`

必填。

以半形逗號分隔的 CMDB 記錄系統 ID (`sys_id`) 清單，用於擷取詳細資料。
`Max Records To Return`

選填。

要為每個關係類型 (例如「與…相關」或「依附於…」) 傳回的記錄關係數量上限。

預設值為 `50`。

動作輸出內容

「Get CMDB Record Details」(取得 CMDB 記錄詳細資料) 動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

下列範例顯示使用「Get CMDB Record Details」(取得 CMDB 記錄詳細資料) 動作時收到的 JSON 結果輸出內容：

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}
輸出訊息

「Get CMDB Record Details」(取得 CMDB 記錄詳細資料) 動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST. `

`Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST`

`Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.`

`Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. 原因： 在「Class CLASS_NAME」中找不到系統 ID 為 SYS_ID 的記錄。`

`Information about the provided Sys IDs was not found.`

 動作成功。
`Error executing action "Get CMDB Record Details". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「Get CMDB Record Details」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

取得事件

使用「Get Incident」(取得事件) 動作，擷取 ServiceNow 事件的相關資訊。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「取得事件」動作需要下列參數：

參數 說明
`Incident Number`

必填。

要擷取的 ServiceNow 事件專屬 ID，格式為 `INCINCIDENT_NUMBER`。

動作輸出內容

「Get Incident」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「Get Incident」(取得事件) 動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「Get Incident」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`incident_number` `INCIDENT_NUMBER`

取得 OAuth 權杖

使用「Get Oauth Token」動作，取得 ServiceNow 的 OAuth 更新權杖。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

「取得 OAuth 權杖」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「取得 OAuth 權杖」動作時收到的 JSON 結果輸出內容：

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}
輸出訊息

「取得 OAuth 權杖」動作可以傳回下列輸出訊息：

輸出訊息 訊息說明
`Successfully generated Oauth tokens for ServiceNow. 現在請前往設定分頁，然後將「refresh_token」值放入「Refresh Token」參數中。注意：「使用者名稱」和「密碼」參數可以留空。 動作成功。
`Error executing action "Get Oauth Token". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「Get Oauth Token」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

取得記錄詳細資料

使用「Get Record Details」(取得記錄詳細資料) 動作，擷取 ServiceNow 中特定表格記錄的相關資訊。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「取得記錄詳細資料」動作需要下列參數：

參數 說明
`Table Name`

必填。

ServiceNow 資料表名稱，其中包含要擷取資訊的記錄 (例如 `incident`)。
`Record Sys ID`

必填。

要擷取詳細資料的特定 ServiceNow 記錄系統 ID (`sys_id`)。
`Fields`

選填。

逗號分隔的清單，用於從擷取的記錄傳回特定欄位 (資料欄) (例如 `sys_id,number,short_description`)。

如未提供任何值，動作會傳回記錄的預設欄位。

動作輸出內容

「取得記錄詳細資料」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「取得記錄詳細資料」動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
輸出訊息

「取得記錄詳細資料」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.`

`Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. 原因：ERROR_REASON。`

 動作成功。
`Error executing action "Get Record Details". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「取得記錄詳細資料」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

取得使用者詳細資料

使用「Get User Details」動作，透過 ServiceNow 中的 sys_id 參數擷取使用者資訊。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「取得使用者詳細資料」動作需要下列參數：

參數 說明
`User Sys IDs`

選填。

以逗號分隔的清單，其中包含對應要擷取詳細資料之使用者的系統 ID (例如 `sys_id_1,sys_id_2`)。
`Emails`

選填。

以半形逗號分隔的電子郵件地址清單，對應要擷取詳細資料的使用者 (例如 `email1@example.com,email2@example.com`)。

動作輸出內容

「取得使用者詳細資料」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 可用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
案件總覽表格

「取得使用者詳細資料」動作會提供下表：

表格名稱：User Details

資料表欄：

  • 系統 ID (對應為 sys_id)
  • 名稱 (對應為 name)
  • 使用者名稱 (對應為 user_name)
  • 電子郵件地址 (對應為 email)
JSON 結果

以下範例顯示使用「取得使用者詳細資料」動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "example@example.com",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}
輸出訊息

「Get User Details」(取得使用者詳細資料) 動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.`

`Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.`

`Information about the users with specified Sys IDs was not found in ServiceNow.`

 動作成功。
`Error executing action "Get User Details". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「取得使用者詳細資料」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

列出 CMDB 記錄

使用「列出 CMDB 記錄」動作，列出 ServiceNow 中相同類別的 CMDB 記錄。

這項操作不會在 Google SecOps 實體上執行。

產生查詢篩選器

Query Filter 參數接受標準 ServiceNow 編碼查詢字串 (sysparm_query)。您可以在 ServiceNow 介面中直接產生這些字串 (例如，在清單檢視畫面中建立篩選器，然後選取「複製查詢」)，或手動建構這些字串。

如需產生及使用這些字串的操作說明，請參閱 ServiceNow 說明文件中的「編碼查詢字串」。

動作輸入內容

「列出 CMDB 記錄」動作需要下列參數：

參數 說明
`Class Name`

必填。

要從中擷取記錄的 CMDB 類別名稱，例如 `cmdb_ci_appl`。

如要進一步瞭解 ServiceNow 類別名稱，請參閱「查看及編輯類別定義和中繼資料」。
`Query Filter`

選填。

用於篩選傳回記錄的編碼查詢字串 (例如 `sys_idLIKE1^sys_idSTARTSWITH0`)。

您可以使用 ServiceNow 清單檢視畫面中的「複製查詢」選項，產生有效的查詢字串。詳情請參閱「編碼查詢字串」。
`Max Records To Return`

選填。

根據套用的篩選條件，可擷取的記錄數量上限。

預設值為 `50`。

動作輸出內容

「列出 CMDB 記錄」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 可用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
案件總覽表格

「列出 CMDB 記錄」動作會提供下表：

表格名稱：CLASS_NAME Records

資料表欄：

  • 名稱 (對應為 name)
  • 系統 ID (對應為 sys_id)
JSON 結果

下列範例顯示使用「列出 CMDB 記錄」動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}
輸出訊息

「列出 CMDB 記錄」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.`

`Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)`

 動作成功。
`Error executing action "List CMDB Records". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「列出 CMDB 記錄」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

列出記錄註解

使用「List Record Comments」動作，列出 ServiceNow 中與特定表格記錄相關的留言。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「列出記錄註解」動作需要下列參數：

參數 說明
`Table Name`

必填。

包含要列出留言的記錄的 ServiceNow 資料表名稱 (例如 `incident`)。
`Record Sys ID`

必填。

要列出留言的記錄系統 ID (`sys_id`)。
`Type`

必填。

要擷取的註解或附註類型。

可能的值如下：

  • `Comment`
  • `Work Note`

預設值為「Comment」。
`Max Results To Return`

選填。

要傳回的留言或工作附註數量上限。

預設值為 `50`。

動作輸出內容

「列出記錄註解」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「列出記錄留言」動作時收到的 JSON 結果輸出內容：

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
輸出訊息

「列出記錄註解」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.`

`No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.`

 動作成功。
`Error executing action "List Record Comments". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「列出記錄註解」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

使用「List Records Related To User」動作，列出與 ServiceNow 使用者相關的表格記錄。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「列出與使用者相關的記錄」動作需要下列參數：

參數 說明
`Table Name`

必填。

要搜尋相關記錄的 ServiceNow 資料表名稱 (例如 `incident`)。
`Usernames`

必填。

請以逗號分隔的清單形式列出要擷取相關記錄的使用者名稱。
`Max Days Backwards`

必填。

從目前日期回溯的天數，用來搜尋相關記錄。

預設值為 `1`。
`Max Records To Return`

選填。

每個使用者最多可傳回的記錄數。

預設值為 `50`。

動作輸出內容

「列出與使用者相關的記錄」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「List Records Related To User」(列出與使用者相關的記錄) 動作時收到的 JSON 結果輸出內容：

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
輸出訊息

「List Records Related To User」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. `

`Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. `

`No related table records were retrieved for the provided users. `

 動作成功。
`Error executing action "List Records Related To User". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「List Records Related To User」(列出與使用者相關的記錄) 動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

Ping

使用「Ping」動作測試與 ServiceNow 的連線。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

「Ping」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「Ping」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

更新事件

使用「更新事件」動作更新事件資訊。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「更新事件」動作需要下列參數：

參數 說明
`Incident Number`

必填。

要更新的 ServiceNow 事件專屬 ID，格式為 `INCINCIDENT_NUMBER`。
`Short Description`

選填。

事件的簡短說明。
`Impact`

選填。

事件的影響程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Urgency`

選填。

事件的緊急程度。

可能的值如下：

  • `1` 代表「高」
  • `2` 代表中
  • `3` 代表低

預設值為 `1`。
`Category`

選填。

事件的類別。
`Assignment Group ID`

選填。

要指派事件的群組完整名稱。
`Assigned User ID`

選填。

要指派事件的使用者全名。
`Description`

選填。

事件說明。
`Incident State`

選填。

事件狀態的基礎 ServiceNow 值 (例如 `1` 或 `in_progress`)，而非標籤 (例如 `New` 或 `In Progress`)。
`Custom Fields`

選填。

JSON 格式的字串，內含要更新的欄位名稱和對應值 (例如 `{"location":"London", "category":"database"}`)。

您可以使用這個參數修改未明確定義為動作輸入內容的欄位。

動作輸出內容

「更新事件」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「更新事件」動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「更新事件」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`incident_number` `INCIDENT_NUMBER`

更新記錄

使用「更新記錄」動作，修改 ServiceNow 中各種資料表的現有記錄。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「更新記錄」動作需要下列參數：

參數 說明
`Table Name`

選填。

包含要更新記錄的 ServiceNow 資料表名稱 (例如 `incident`)。
`Object Json Data`

必填。

JSON 物件，內含要套用至記錄的欄位值配對 (例如 `{"short_description": "Updated description"}`)。
`Record Sys ID`

必填。

要更新的特定記錄系統 ID (`sys_id`)。

動作輸出內容

「更新記錄」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「更新記錄」動作時收到的 JSON 結果輸出內容：

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
指令碼結果

下表列出使用「更新記錄」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`record_sys_id` `RECORD_SYS_ID`

等待註解

使用「等待註解」動作，暫停執行劇本，直到在 ServiceNow 的特定表格記錄中新增註解或工作附註為止。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「等待留言」動作需要下列參數：

參數 說明
`Table Name`

必填。

ServiceNow 資料表名稱，其中包含要等待註解的記錄 (例如 `incident`)。
`Record Sys ID`

必填。

要監控留言的記錄系統 ID (`sys_id`)。
`Type`

必填。

動作應等待的註解或附註類型。

可能的值如下：

  • `Comment`
  • `Work Note`

預設值為「Comment」。
`Wait Mode`

必填。

決定動作何時停止等待並繼續執行的條件。

可能的值如下：

  • `Until Timeout`：動作會等待整個逾時期間，然後傳回所有累積的註解。
  • `Until First Message`：動作會等待，直到動作開始後發布的第一則新留言或工作附註。
  • `Until Specific Text`：動作會等待，直到含有 `Text` 中指定文字的留言或工作附註發布為止。

預設值為「直到逾時」。
`Text`

選填。

動作在新留言或工作記事中等待的特定文字字串。

只有在為「等待模式」的值選取「直到特定文字」時，才會使用這項參數。

動作輸出內容

「等待註解」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼結果 可用
JSON 結果

以下範例顯示使用「Wait For Comments」動作時收到的 JSON 結果輸出內容：

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
輸出訊息

「Wait For Comments」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

`Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.`

`No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.`

 動作成功。
`Error executing action "Wait For Comments". 原因： ERROR_REASON`

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼結果

下表列出使用「等待留言」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`is_success` `true` 或 `false`

等待欄位更新

使用「等待欄位更新」動作暫停劇本執行，直到 ServiceNow 資料記錄中的特定欄位更新為預期值為止。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「等待欄位更新」動作需要下列參數：

參數 說明
`Table Name`

必填。

包含要監控記錄的 ServiceNow 資料表名稱 (例如 `incident`)。
`Record Sys ID`

必填。

要監控欄位更新的記錄系統 ID (`sys_id`)。
`Field - Column Name`

必填。

動作監控變更的資料欄 (欄位) 名稱。
`Field - Values`

必填。

以半形逗號分隔的值清單。如果監控欄位中出現這些值，動作就會停止等待並繼續執行 (例如「處理中」、「已解決」)。

動作輸出內容

「等待欄位更新」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「等待欄位更新」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`updated_field` `UPDATED_FIELD`

等待狀態更新

使用「Wait for Status Update」(等待狀態更新) 動作暫停劇本執行，直到特定 ServiceNow 事件狀態更新為預期值為止。

這項操作不會在 Google SecOps 實體上執行。

動作輸入內容

「Wait for Status Update」動作需要下列參數：

參數 說明
`Incident Number`

必填。

要監控的 ServiceNow 事件專屬 ID，格式為 `INCINCIDENT_NUMBER`。
`Statuses`

必填。

以半形逗號分隔的事件狀態清單 (狀態)，如果達到這些狀態，動作就會停止等待並繼續執行 (例如「處理中」、「已解決」)。

動作輸出內容

「等待狀態更新」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼結果 可用
指令碼結果

下表列出使用「等待狀態更新」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
`new_status` `STATUS`

連接器

如要進一步瞭解如何在 Google SecOps 中設定連接器，請參閱「擷取資料 (連接器)」。

ServiceNow 連接器

使用 ServiceNow 連接器從 ServiceNow 擷取事件。

使用動態查詢清單

在「ServiceNow Connector」(ServiceNow 連接器) 中，動態清單會修改連接器用來查詢 ServiceNow 的 sysparm_query。這項功能可讓您根據記錄類型支援的任何欄位篩選記錄。

如要定義篩選器，請將每個動態清單項目設定為包含一個欄位值配對，格式如下： FIELD_NAME=VALUE.

例如：category=security。

啟用 Use whitelist as a blacklist 後，連接器會反轉查詢邏輯，導致動態清單變成封鎖清單，而非篩選器。

連接器輸入內容

ServiceNow 連接器需要下列參數：

參數 說明
`Product Field Name`

必填。

儲存產品名稱的欄位名稱。

產品名稱主要會影響對應。為簡化及改善連接器的對應程序，預設值會解析為程式碼參照的回退值。這個參數的任何無效輸入內容，預設都會解析為備用值。

預設值為 Product Name。
`Event Field Name`

必填。

決定事件名稱 (子類型) 的欄位名稱。

預設值為 `sys_class_name`。
`Rule Generator`

選填。

欄位名稱，其值會定義在擷取記錄時套用的特定查詢或規則集。
`Api Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 帳戶的使用者名稱。
`Password`

必填。

ServiceNow 帳戶的密碼。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。
`Use sys_domain Environment`

選填。

如果選取這個選項，連接器會使用 ServiceNow `sys_domain` 欄位做為擷取案件的環境。

如果缺少或無法使用這個欄位，連接器預設會使用 `Environment` 參數中指定的值。
`Days Backwards`

選填。

從目前時間回溯的天數，用來擷取記錄。

這個參數用於初始連接器執行作業，或做為先前的連接器時間戳記過期時的回溯值。

預設值為 `5`。
`Disable Overflow`

選填。

如果選取此選項，連接器會忽略 Google SecOps 溢位機制。
`Max Incidents Per Cycle`

選填。

每次連接器疊代作業可擷取的事件數量上限。

預設值為 `10`。
`Environments Whitelist`

選填。

以半形逗號分隔的環境 (網域) 清單，供連接器擷取資料至 Google SecOps，例如 `env1,env2`。
`Use whitelist as a blacklist`

選填。

如果選取這個選項，連接器會將動態清單做為封鎖清單。

預設為停用。
`PythonProcessTimeout`

必填。

執行目前指令碼的 Python 程序逾時限制 (以秒為單位)。

預設值為 `60`。
`Incident Table`

選填。

用於事件相關動作和記錄擷取的 API 資料表名稱或路徑。

根據預設，整合功能會使用 `table/incident` 路徑。
`Client ID`

選填。

ServiceNow 整合的用戶端 ID，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Client Secret`

選填。

ServiceNow 整合的用戶端密鑰，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Refresh Token`

選填。

ServiceNow 整合的更新權杖，使用更新權杖進行 OAuth 2.0 驗證時需要此權杖。

設定的更新權杖每 90 天會過期。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Assignment Group`

選填。

連接器應擷取記錄的指派群組名稱。
`Use Oauth Authentication`

選填。

如果選取這個選項，整合服務會使用 OAuth 2.0 進行驗證。

OAuth 2.0 驗證需要設定用戶端憑證 (`Client ID` 和 `Client Secret`) 或 `Refresh Token`。

預設為停用。
`Server Time Zone`

選填。

在 ServiceNow 伺服器上設定的時區 (例如 `UTC` 或 `Asia/Jerusalem`)。

預設值為 `UTC`。
`Table Name`

選填。

要從中擷取記錄的資料表名稱，例如 `incident`。
`Event Name`

選填。

系統擷取記錄時建立的 Google SecOps 事件名稱 (例如 `ServiceNowEvent`)。
`Proxy Server Address`

選填。

要使用的 Proxy 伺服器位址。
`Proxy Username`

選填。

用於驗證的 Proxy 使用者名稱。
`Proxy Password`

選填。

用於驗證的 Proxy 密碼。
`Get User Information`

選填。

如果選取這個選項，連接器還會擷取與事件相關的使用者資訊。

預設為停用。

工作

如要進一步瞭解工作，請參閱「 設定新工作」和「 進階排程」。

ServiceNow - Sync Closed Incidents

使用「ServiceNow - Sync Closed Incidents」工作，將已結案的 ServiceNow 事件與對應的 Google SecOps 快訊和案件同步處理。

這項工作會處理以快訊和案件形式擷取的 ServiceNow 事件，其中包含 ServiceNow 標記和具有事件號碼的 TICKET_ID 內容值。

工作參數

「ServiceNow - Sync Closed Incidents」工作需要下列參數：

參數 說明
`Api Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 執行個體的使用者名稱。
`Password`

必填。

ServiceNow 執行個體的密碼。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。
`Client ID`

選填。

ServiceNow 整合的用戶端 ID，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Client Secret`

選填。

ServiceNow 整合的用戶端密鑰，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Refresh Token`

選填。

ServiceNow 整合的更新權杖，使用更新權杖進行 OAuth 2.0 驗證時需要此權杖。

設定的更新權杖每 90 天會過期。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Use Oauth Authentication`

選填。

如果選取這個選項，整合服務會使用 OAuth 2.0 進行驗證。

OAuth 2.0 驗證需要設定用戶端憑證 (`Client ID` 和 `Client Secret`) 或 `Refresh Token`。

預設為停用。
`Max Hours Backwards`

選填。

從目前時間回溯幾小時，搜尋並同步處理已結案的事件。

預設值為 `24`。
`Table Name`

必填。

要搜尋已結案事件的資料庫表格名稱 (例如 `incident`)。

ServiceNow - 同步處理事件

使用「ServiceNow - Sync Incidents」工作，將 ServiceNow 事件欄位和附件與 Google SecOps 中相關的案件和快訊同步。

工作需求

如要讓工作正常運作，請確保在 Google SecOps 案件或快訊 (視 Sync Level 參數而定) 中設定下列項目：

  • 標記：案件必須有 ServiceNow Incident Sync 標記。

  • 內容值：案件或快訊必須有 TICKET_ID 內容鍵，其中包含以半形逗號分隔的 ServiceNow 事件編號清單 (例如 INC0000050,INC0000051)。 注意：您可以使用 Siemplify Utilities 整合服務的「Set Scope Context Value」動作，設定 TICKET_ID 內容值。

工作參數

「ServiceNow - Sync Incidents」工作需要下列參數：

參數 說明
`Api Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 執行個體的使用者名稱。
`Password`

必填。

ServiceNow 執行個體的密碼。
`Sync Level`

必填。

工作同步處理資料的層級。

可能的值如下：

  • `Case`
  • `Alert`

預設值為「Case」。
`Max Hours Backwards`

必填。

從目前時間回溯搜尋案件的小時數上限，以進行同步處理。

預設值為 `24`。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。

同步處理資料表記錄留言

使用「Sync Table Record Comments」(同步處理表格記錄註解) 工作，在 ServiceNow 表格記錄和 Google SecOps 案件之間同步處理註解。

工作參數

「同步處理資料表記錄留言」工作需要下列參數：

參數 說明
`Api Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 執行個體的使用者名稱。
`Password`

必填。

ServiceNow 執行個體的密碼。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。
`Client ID`

選填。

ServiceNow 整合的用戶端 ID，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Client Secret`

選填。

ServiceNow 整合的用戶端密鑰，使用用戶端憑證進行 OAuth 2.0 驗證時必須提供。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Refresh Token`

選填。

ServiceNow 整合的更新權杖，使用更新權杖進行 OAuth 2.0 驗證時需要此權杖。

設定的更新權杖每 90 天會過期。

您可以使用更新權杖或用戶端憑證進行驗證。如果同時設定更新權杖和用戶端憑證，整合服務會使用更新權杖進行驗證。
`Use Oauth Authentication`

選填。

如果選取這個選項，整合服務會使用 OAuth 2.0 進行驗證。

OAuth 2.0 驗證需要設定用戶端憑證 (`Client ID` 和 `Client Secret`) 或 `Refresh Token`。

預設為停用。
`Table Name`

必填。

要搜尋記錄的 ServiceNow 資料表名稱，以便同步處理留言 (例如 `incident`)。

依標記同步處理表格記錄註解

使用「Sync Table Record Comments By Tag」工作，同步處理 ServiceNow 表格記錄和 Google SecOps 案件之間的留言。

工作需求

如要讓這項工作正常運作，Google SecOps 案件必須具備下列兩個標記：

  • ServiceNow TABLE_NAME (其中 <var class="readonly">TABLE_NAME</var> 是 ServiceNow 資料表的名稱，例如 incident)。

  • ServiceNow TicketId: TICKET_ID (其中 <var class="readonly">TICKET_ID</var> 是對應記錄的系統 ID 或編號)。

工作參數

「依標記同步處理資料表記錄留言」工作需要下列參數：

參數 說明
`API Root`

必填。

ServiceNow 執行個體的 API 根層級。

預設值為 `https://INSTANCE.service-now.com/api/now/v1/`。
`Username`

必填。

ServiceNow 執行個體的使用者名稱。
`Password`

必填。

ServiceNow 執行個體的密碼。
`Table Name`

必填。

要搜尋的資料庫表格名稱，例如 `incident`。
`Verify SSL`

選填。

如果選取這個選項，整合服務會在連線至 ServiceNow 伺服器時驗證 SSL 憑證。

(預設為啟用)。

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