Mengintegrasikan Automox dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Automox dengan Google Security Operations (Google SecOps).

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Root API String https://#123;#123;api_root#125;#125; Ya Root API instance Automox.
Kunci API Sandi T/A Tidak Kunci API instance Automox.
Verifikasi SSL Kotak centang Dicentang Ya Jika diaktifkan, setelan ini akan memverifikasi bahwa sertifikat SSL untuk koneksi ke Automox valid.

Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan pada tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Cara membuat kunci API

Untuk mengetahui informasi selengkapnya tentang cara membuat kunci API, lihat langkah Menemukan kunci API Anda di konsol yang tersedia dalam dokumen Panduan Pemula untuk Memulai Automox API.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Memperkaya Entity

Memperkaya entity menggunakan informasi dari Automox.

Parameter

Nama Parameter Jenis Nilai Default Wajib Deskripsi
Patch Pengembalian Kotak centang Dicentang Tidak

Jika diaktifkan, tindakan ini akan menampilkan daftar patch yang perlu diupdate di komputer.

Catatan: Tindakan ini tidak menampilkan patch yang telah diinstal atau yang diabaikan.
Jumlah Maksimum Patch yang Akan Ditampilkan Bilangan bulat 50 Tidak Tentukan jumlah patch yang akan ditampilkan. Jika tidak ada yang diberikan, tindakan akan menampilkan 50 patch.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success True/False is_success=False
Hasil 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
        }
    ]
}
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
id Jika tersedia dalam JSON
agent_version Jika tersedia dalam JSON
patuh Jika tersedia dalam JSON
terhubung Jika tersedia dalam JSON
create_time Jika tersedia dalam JSON
custom_name Jika tersedia dalam JSON
ip_addrs_private Jika tersedia dalam JSON
last_disconnect_time Jika tersedia dalam JSON
last_logged_in_user Jika tersedia dalam JSON
last_update_time Jika tersedia dalam JSON
os Jika tersedia dalam JSON
pending_patches Jika tersedia dalam JSON
tags Jika tersedia dalam JSON
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia untuk satu entitas (is_success=true): "Successfully enriched the following entities using information from Automox: {entity.identifier}".

Jika data tidak tersedia untuk satu entitas (is_success=true): "Action wasn't able to enrich the following entities using information from Automox: {entity.identifier}"

Jika data tidak tersedia untuk semua entitas (is_success=false): "None of the provided entities were enriched"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)

 Umum
Tabel Repositori Kasus

Judul: {entity.identifier}

Kolom:

  • Kunci
  • Nilai
 Entity

Menjalankan Perintah Perangkat

Menjalankan perintah di endpoint di Automox.

Parameter

Nama Parameter Jenis Nilai Default Wajib Deskripsi
Perintah DDL

Pindai Perangkat

Nilai yang Mungkin Muncul:

  • Pindai Perangkat
  • Menginstal Patch Tertentu
  • Instal Semua Patch yang Tersedia
  • Mulai Ulang Perangkat
 Tidak

Tentukan perintah yang perlu dijalankan di perangkat.

Catatan: Jika "Install Specific Patches" dipilih, parameter "Patch Names" wajib diisi.
Nama Patch CSV T/A Tidak Tentukan daftar patch yang dipisahkan koma yang perlu diinstal.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success True/False is_success=False
Hasil 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."
}
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika perangkat ditemukan dan terhubung (is_success=true): "Successfully executed command "{Command}" on the following entities in Automox: {entity.identifier}. Periksa hasil JSON untuk memastikan bahwa perintah dijalankan dengan benar."

Jika perangkat tidak ditemukan atau terhubung untuk satu entitas (is_success=true): "Action wasn't able to execute command "{Command}" on the following entities in Automox: {entity.identifier}. Periksa ejaan dan konektivitas."

Jika perangkat tidak ditemukan atau terhubung untuk semua entitas (is_success=false): "No commands were executed on the provided entities. Periksa ejaan dan konektivitas."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Execute Device Command". Reason: {0}''.format(error.Stacktrace)

 Umum

Menjalankan Kebijakan

Menjalankan kebijakan di Automox.

Parameter

Nama Parameter Jenis Nilai Default Wajib Deskripsi
Cakupan Perbaikan DDL

Semua Perangkat

Nilai yang memungkinkan:

  • Hanya Entity
  • Semua Perangkat
 Tidak

Tentukan cakupan perbaikan untuk tindakan.

Jika "Hanya Entity" dipilih, tindakan akan menjalankan kebijakan hanya pada entity yang valid dalam cakupan.

Jika "Semua Perangkat" dipilih, tindakan akan menjalankan kebijakan di semua perangkat dalam organisasi.
Nama Kebijakan String T/A Tidak Tentukan nama kebijakan yang perlu dijalankan.

Dijalankan pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success True/False is_success=False
Hasil JSON
{
"status": "done/failure if entity not found"
}
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika server telah diperbaiki dan berhasil untuk satu entitas (is_success=true): "Successfully executed policy {Policy} on the following entities in Automox: {entity.identifier}."

Jika server telah diperbaiki dan satu server tidak ditemukan (is_success=true): "Action wasn't able to execute policy {Policy} on the following entities in Automox: {entity.identifier}."

Jika server telah diperbaiki dan semua server tidak ditemukan (is_success=false): "No entities were found. Kebijakan {Policy} tidak dijalankan."

Jika semua server diperbaiki (is_success=true): "Successfully executed policy {Policy} in Automox."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Execute Policy". Reason: {0}''.format(error.Stacktrace)

Jika kebijakan tidak ditemukan: "Error executing action "Execute Policy". Alasan: kebijakan "{policy name}" tidak ditemukan di Automox. Periksa ejaannya.''

Umum

Mencantumkan Kebijakan

Mencantumkan kebijakan yang tersedia di Automox.

Parameter

Nama Parameter Jenis Nilai Default Wajib Deskripsi
Kunci Filter DDL

Pilih Satu

Nilai yang memungkinkan:

  • Nama
  • ID
  • Nama Jenis Kebijakan
  • Status
 Tidak Tentukan kunci yang perlu digunakan untuk memfilter kebijakan.
Logika Filter DDL

Tidak Ditentukan

Nilai yang memungkinkan:

  • Tidak Ditentukan
  • Sama dengan
  • Berisi
 Tidak

Tentukan logika filter yang harus diterapkan.

Logika pemfilteran berfungsi berdasarkan nilai yang diberikan dalam parameter "Filter Key".
Nilai Filter String T/A Tidak

Tentukan nilai yang harus digunakan dalam filter.

Jika "Sama dengan" dipilih, tindakan akan mencoba menemukan kecocokan persis di antara hasil dan jika "Berisi" dipilih, tindakan akan mencoba menemukan hasil yang berisi substring tersebut.

Jika tidak ada yang diberikan dalam parameter ini, filter tidak akan diterapkan.

Logika pemfilteran berfungsi berdasarkan nilai yang diberikan dalam parameter "Filter Key".
Jumlah Data Maksimum yang Akan Ditampilkan Bilangan bulat 50 Tidak Tentukan jumlah kumpulan data yang akan ditampilkan. Jika tidak ada yang diberikan, tindakan akan menampilkan 50 data.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success True/False is_success=False
Hasil 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"
    }
]
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia (is_success=true): "Successfully found policies for the provided criteria in Automox".

Jika data tidak tersedia (is_success=false): "No policies were found for the provided criteria in Automox."

Jika parameter "Filter Value" kosong (is_success=true): "Filter tidak diterapkan karena parameter "Filter Value" memiliki nilai kosong."

Jika parameter "Filter Logic" ditetapkan ke "Not Specified" (is_success=true): "The filter was not applied, because parameter "Filter Logic" is not specified."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika parameter "Kunci Filter" ditetapkan ke "Pilih Satu" dan "Logika Filter" ditetapkan ke "Sama dengan" atau "Berisi": "Terjadi error saat menjalankan tindakan "{action name}". Alasan: Anda harus memilih kolom dari parameter "Kunci Filter"."

Jika nilai yang tidak valid diberikan untuk parameter "Max Records to Return": "Error executing action "{action name}". Alasan: "Nilai yang diberikan untuk "Max Records to Return" tidak valid: . Angka positif harus diberikan"."

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "List Policies". Reason: {0}''.format(error.Stacktrace)

 Umum
Tabel Repositori Kasus

Nama tabel: Available Policies

Kolom tabel:

  • Nama - nama
  • Jenis - policy_type_name
  • ID - id
  • Status - status
  • Notes - notes
 Umum

Ping

Uji konektivitas ke Automox.

Parameter

T/A

Dijalankan pada

Tindakan ini tidak berjalan di entity, dan tidak memiliki parameter input wajib.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success True/False is_success=False
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil: "Successfully connected to the Automox server with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika tidak berhasil: "Failed to connect to the Automox server! Error is {0}".format(exception.stacktrace)

 Umum

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.