將 Automox 與 Google SecOps 整合

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

整合參數

請使用下列參數設定整合：

參數顯示名稱 類型 預設值 為必填 說明
API 根層級 字串 https://#123;#123;api_root#125;#125; 是 Automox 執行個體的 API 根目錄。
API 金鑰 密碼 不適用 否 Automox 執行個體的 API 金鑰。
驗證 SSL 核取方塊 已勾選 是 啟用後，系統會驗證與 Automox 連線的 SSL 憑證是否有效。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

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

如何產生 API 金鑰

如要進一步瞭解如何產生 API 金鑰，請參閱「Newbie's Guide to Getting Started with Automox API」文件中的「Find your API key in the console」步驟。

動作

如要進一步瞭解動作，請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

充實實體

使用 Automox 的資訊擴充實體。

參數

參數名稱 類型 預設值 為必填 說明
傳回修補程式 核取方塊 已勾選 否

如果啟用，這項動作會傳回機器上需要更新的修補程式清單。

注意：這項動作不會傳回已安裝或已忽略的修補程式。
要傳回的修補程式數量上限 整數 50 否 指定要傳回的修補程式數量。如未提供，動作會傳回 50 個修補程式。

執行日期

這項動作會對下列實體執行：

  • IP 位址
  • 主機名稱

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項 範例
is_success True/False is_success=False
JSON 結果
{
    "id": 2263017,
    "agent_version": "1.41.125",
    "commands": [],
    "compatibility_checks": {
        "missing_wmi_integrity_check": false,
        "missing_powershell": false,
        "low_diskspace": false
    },
    "compliant": true,
    "connected": false,
    "create_time": "2022-10-24T09:14:12+0000",
    "custom_name": "",
    "deleted": false,
    "detail": {
        "IPS": [
            "192.0.2.176",
            "2001:db8:1:1:1:1:1:1"
        ],
        "UPDATE_SOURCE_CHECK": {
            "CONNECTED": "True",
            "ERROR": "Succeeded"
        },
        "MDM_SERVER": null,
        "FQDNS": [
            "DESKTOP-65M05SE.WORKGROUP"
        ],
        "RAM": "8589934592",
        "SECURE_TOKEN_ACCOUNT": null,
        "LAST_USER_LOGON": {
            "SRC": "DESKTOP-65M05SE",
            "USER": "DESKTOP-65M05SE\\Admin",
            "TIME": "10/24/2022 2:59:45 AM"
        },
        "VOLUME": [
            {
                "IS_SYSTEM_DISK": "True",
                "VOLUME": "C:",
                "FSTYPE": "NTFS",
                "LABEL": "Local Disk",
                "AVAIL": "63766056960",
                "FREE": "39201988608"
            }
        ],
        "DISTINGUISHED_NAME": "",
        "MODEL": "VMware7,1",
        "CPU": "Intel(R) Xeon(R) CPU E5-2698 v3 @ 2.30GHz",
        "MDM_PROFILE_INSTALLED": null,
        "VENDOR": "VMware, Inc.",
        "AUTO_UPDATE_OPTIONS": {
            "OPTIONS": "off",
            "ENABLED": "1"
        },
        "SERVICETAG": "No Asset Tag",
        "PS_VERSION": "5",
        "WSUS_CONFIG": {
            "WSUS_REACHABLE": "1",
            "WSUS_MANAGED": "0",
            "WSUS_SERVER": ""
        },
        "SERIAL": "VMware",
        "NICS": [
            {
                "VENDOR": "Intel(R) 82574L Gigabit Network Connection",
                "DEVICE": "Ethernet0",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": [
                    "172.30.201.176",
                    "2001:db8:1:1:1:1:1:1"
                ],
                "CONNECTED": true
            },
            {
                "IPS": [],
                "CONNECTED": false,
                "VENDOR": "WAN Miniport (IP)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF"
            },
            {
                "VENDOR": "WAN Miniport (IPv6)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": [],
                "CONNECTED": false
            },
            {
                "CONNECTED": false,
                "VENDOR": "WAN Miniport (Network Monitor)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": []
            }
        ],
        "WMI_INTEGRITY_CHECK": "True",
        "VERSION": "440BX Desktop Reference Platform",
        "DISKS": [
            {
                "TYPE": "VMware Virtual disk SCSI Disk Device",
                "SIZE": "64420392960"
            }
        ]
    },
    "display_name": "DESKTOP-65M05SE",
    "exception": false,
    "instance_id": "",
    "ip_addrs": [
        "192.0.2.139"
    ],
    "ip_addrs_private": [
        "192.0.2.176",
        "2001:db8:1:1:1:1:1:1"
    ],
    "is_compatible": true,
    "is_delayed_by_notification": false,
    "is_delayed_by_user": false,
    "last_disconnect_time": "2022-10-25T09:19:29+0000",
    "last_logged_in_user": "DESKTOP-65M05SE\\Admin",
    "last_process_time": "2022-10-25T08:19:24+0000",
    "last_refresh_time": "2022-10-25T08:23:48+0000",
    "last_scan_failed": false,
    "last_update_time": "2022-10-25T08:22:14+0000",
    "mdm": null,
    "name": "DESKTOP-65M05SE",
    "needs_attention": false,
    "needs_reboot": false,
    "next_patch_time": null,
    "notification_count": 0,
    "organization_id": 104513,
    "organizational_unit": "",
    "os_family": "Windows",
    "os_name": "10 Enterprise Evaluation",
    "os_version": "10.0.19043",
    "os_version_id": 4876,
    "patch_deferral_count": 0,
    "patches": 1,
    "pending": false,
    "pending_patches": 0,
    "policy_status": [
        {
            "id": 316123693,
            "organization_id": 104513,
            "policy_id": 245687,
            "server_id": 2263017,
            "policy_name": "Apply All Patches",
            "policy_type_name": "patch",
            "status": 1,
            "result": "{}",
            "create_time": "2022-10-25T08:23:48+0000",
            "will_reboot": false,
            "pending_count": 0,
            "next_remediation": null
        }
    ],
    "reboot_deferral_count": 0,
    "reboot_is_delayed_by_notification": false,
    "reboot_is_delayed_by_user": false,
    "reboot_notification_count": 0,
    "refresh_interval": 1440,
    "serial_number": "VMware",
    "server_group_id": 145150,
    "server_policies": [],
    "status": {
        "device_status": "not-ready",
        "agent_status": "disconnected",
        "policy_status": "compliant",
        "policy_statuses": [
            {
                "id": 245687,
                "compliant": true
            },
            {
                "id": 245688,
                "compliant": true
            }
        ]
    },
    "tags": [
        "Recently Added"
    ],
    "timezone": "UTC-0700",
    "total_count": 1,
    "uptime": "1872",
    "uuid": "UUID",
    "list_of_patches": [
        {
            "id": 2077952013,
            "server_id": 2263017,
            "package_id": 227229243,
            "software_id": 167943,
            "installed": true,
            "ignored": false,
            "group_ignored": false,
            "deferred_until": null,
            "group_deferred_until": null,
            "name": "example",
            "display_name": "MSXML 6.0 RTM Security Update  (925673)",
            "version": "103",
            "repo": "WindowsUpdate",
            "cves": [],
            "cve_score": "9.0",
            "agent_severity": "9.0",
            "severity": "critical",
            "package_version_id": 233355423,
            "os_name": "10 Enterprise Evaluation",
            "os_version": "10.0.19043",
            "os_version_id": 4876,
            "create_time": "2021-06-28T15:45:57+0000",
            "requires_reboot": true,
            "patch_classification_category_id": 8,
            "patch_scope": "important",
            "is_uninstallable": false,
            "secondary_id": null,
            "is_managed": true,
            "impact": 0,
            "organization_id": 104513
        }
    ]
}
實體充實
補充資料欄位名稱 邏輯 - 應用時機
id JSON 格式 (如有)
agent_version JSON 格式 (如有)
符合 JSON 格式 (如有)
已連接 JSON 格式 (如有)
create_time JSON 格式 (如有)
custom_name JSON 格式 (如有)
ip_addrs_private JSON 格式 (如有)
last_disconnect_time JSON 格式 (如有)
last_logged_in_user JSON 格式 (如有)
last_update_time JSON 格式 (如有)
os JSON 格式 (如有)
pending_patches JSON 格式 (如有)
標記 JSON 格式 (如有)
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果一個實體有資料 (is_success=true)：「已成功使用 Automox 的資訊擴充下列實體：{entity.identifier}」。

如果無法取得某個實體的資料 (is_success=true)：「動作無法使用 Automox 的資訊充實下列實體：{entity.identifier}」

如果所有實體都沒有資料 (is_success=false)：「提供的實體都沒有經過擴充。」

動作應失敗並停止執行應對手冊：

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『擴充實體』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
案件總覽表格

標題：{entity.identifier}

欄：

  • 鍵
  • 值
 實體

執行裝置指令

在 Automox 的端點上執行指令。

參數

參數名稱 類型 預設值 為必填 說明
指令 DDL

掃描裝置

可能的值：

  • 掃描裝置
  • 安裝特定修補程式
  • 安裝所有可用的修補程式
  • 重新啟動裝置
 否

指定要在裝置上執行的指令。

注意：如果選取「Install Specific Patches」，則必須提供「Patch Names」參數。
修補程式名稱 CSV 不適用 否 指定要安裝的修補程式清單，並以半形逗號分隔。

執行日期

這項動作會對下列實體執行：

  • IP 位址
  • 主機名稱

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項 範例
is_success True/False is_success=False
JSON 結果
{
    "id": 8527028217,
    "server_id": 2263017,
    "command_id": 164850699,
    "organization_id": 104513,
    "args": "ASD",
    "reboot": 0,
    "exec_time": "2022-10-25T08:02:43+0000",
    "response": [
        "0",
        "Installing MS updates: ASD\\r\\nCouldn't find update for ASD, skipping.\\r\\nNothing left to do",
        null
    ],
    "response_time": "2022-10-25T08:22:14+0000",
    "policy_id": null,
    "agent_command_type": 0,
    "command_type_name": "InstallUpdate"
}
{
    "reason": "Device is offline. Please check the connectivity."
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果找到裝置且已連線 (is_success=true)：「已成功在 Automox 的下列實體上執行『{Command}』指令：{entity.identifier}。請檢查 JSON 結果，確認指令正確執行。

如果找不到裝置，或裝置已連線至一個實體 (is_success=true)：「動作無法在 Automox 的下列實體上執行「{Command}」指令：{entity.identifier}。請檢查拼字和連線狀態。」

如果找不到裝置，或裝置已連線至所有實體 (is_success=false)：「未對提供的實體執行任何指令。請檢查拼字和連線狀態。」

動作應失敗並停止執行應對手冊：

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『執行裝置指令』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

執行政策

在 Automox 中執行政策。

參數

參數名稱 類型 預設值 為必填 說明
修復範圍 DDL

所有裝置

可能的值包括：

  • 僅限實體
  • 所有裝置
 否

指定動作的修復範圍。

如果選取「僅限實體」，系統只會對範圍內的有效實體執行政策。

如果選取「所有裝置」，系統會對組織中的所有裝置執行政策。
政策名稱 字串 不適用 否 指定要執行的政策名稱。

執行日期

這項動作會對下列實體執行：

  • IP 位址
  • 主機名稱

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項 範例
is_success True/False is_success=False
JSON 結果
{
"status": "done/failure if entity not found"
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果已修復伺服器，且一個實體成功 (is_success=true)：「已成功在 Automox 的下列實體上執行政策 {Policy}：{entity.identifier}。」

如果已修復伺服器，但找不到其中一個伺服器 (is_success=true)：「動作無法在 Automox 的下列實體上執行政策 {Policy}：{entity.identifier}。」

如果已修復伺服器，但找不到任何伺服器 (is_success=false)：「找不到任何實體。未執行政策「{Policy}」。

如果修復所有伺服器 (is_success=true)：「已成功在 Automox 執行政策 {Policy}。」

動作應失敗並停止執行應對手冊：

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『執行政策』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

如果找不到政策：「Error executing action "Execute Policy". 原因：在 Automox 中找不到「{policy name}」政策。請檢查拼字。

一般

可列出政策

列出 Automox 中的可用政策。

參數

參數名稱 類型 預設值 為必填 說明
篩選鍵 DDL

請選取一項

可能的值包括：

  • 名稱
  • ID
  • 政策類型名稱
  • 狀態
 否 指定要用來篩選政策的鍵。
篩選邏輯 DDL

未指定

可能的值包括：

  • 未指定
  • 等於
  • 包含
 否

指定要套用的篩選邏輯。

篩選邏輯會根據「篩選條件索引鍵」參數中提供的值運作。
篩選器值 字串 不適用 否

指定篩選條件應使用的值。

如果選取「等於」，動作會嘗試在結果中找出完全比對的項目；如果選取「包含」，動作會嘗試找出包含該子字串的結果。

如果未在這個參數中提供任何內容，系統就不會套用篩選器。

篩選邏輯會根據「篩選條件索引鍵」參數中提供的值運作。
要傳回的記錄數量上限 整數 50 否 指定要傳回的記錄數量。如未提供，動作會傳回 50 筆記錄。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項 範例
is_success True/False is_success=False
JSON 結果
[
    {
        "id": 245687,
        "name": "Apply All Patches",
        "policy_type_name": "patch",
        "organization_id": 104513,
        "configuration": {
            "auto_patch": false,
            "patch_rule": "all",
            "auto_reboot": false,
            "notify_user": false,
            "include_optional": true,
            "notify_reboot_user": true,
            "missed_patch_window": true,
            "custom_notification_max_delays": 3,
            "custom_notification_deferment_periods": [
                1,
                2,
                4
            ]
        },
        "schedule_days": 254,
        "schedule_weeks_of_month": 62,
        "schedule_months": 8190,
        "schedule_time": "17:00",
        "notes": "",
        "create_time": "2022-10-24T08:44:37+0000",
        "server_groups": [
            145150
        ],
        "server_count": 1,
        "status": "inactive"
    }
]
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果資料可用 (is_success=true)：「Successfully found policies for the provided criteria in Automox」。

如果沒有資料 (is_success=false)：「在 Automox 中找不到符合指定條件的政策。」

如果「篩選器值」參數為空白 (is_success=true)：「未套用篩選器，因為『篩選器值』參數的值為空白。」

如果「篩選邏輯」參數設為「未指定」(is_success=true)：「未指定『篩選邏輯』參數，因此未套用篩選器。」

動作應失敗並停止執行應對手冊：

如果「篩選鍵」參數設為「選取一項」，且「篩選邏輯」設為「等於」或「包含」：「執行動作『{action name}』時發生錯誤。原因：您必須從「篩選條件鍵」參數中選取欄位。

如果為「Max Records to Return」參數提供的值無效：「Error executing action "{action name}". 原因：「『要傳回的記錄數量上限』的值無效：。請提供正數。

如果系統回報嚴重錯誤，例如憑證錯誤、無法連線至伺服器或其他錯誤：「執行『列出政策』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
案件總覽表格

表格名稱：可用的政策

表格欄：

  • Name - name
  • 類型 - policy_type_name
  • ID - id
  • Status - status
  • Notes - notes
 一般

乒乓

測試與 Automox 的連線能力。

參數

不適用

執行日期

這項動作不會對實體執行，也沒有必要輸入參數。

動作執行結果

指令碼執行結果
指令碼結果名稱 值選項 範例
is_success True/False is_success=False
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功：「已使用提供的連線參數成功連線至 Automox 伺服器！」

動作應失敗並停止執行應對手冊：

如果未成功：「無法連線至 Automox 伺服器！錯誤為 {0}".format(exception.stacktrace)

 一般

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