שילוב של Automox עם Google SecOps

במאמר הזה מוסבר איך לשלב את Automox עם Google Security Operations ‏ (Google SecOps).

פרמטרים של שילוב

כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
הרמה הבסיסית (root) של ה-API String https://#123;#123;api_root#125;#125; כן שורש ה-API של המכונה של Automox.
מפתח API סיסמה לא רלוונטי לא מפתח ה-API של המכונה של Automox.
אימות SSL תיבת סימון סימן אישור כן אם ההגדרה מופעלת, המערכת מאמתת שאישור ה-SSL לחיבור ל-Automox תקף.

איך מגדירים שילובים ב-Google SecOps

אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.

איך יוצרים מפתח API

מידע נוסף על יצירת מפתח API זמין בשלב Find your API key in the console במסמך Newbie's Guide to Getting Started with Automox API.

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

העשרת ישויות

העשרת ישויות באמצעות מידע מ-Automox.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
החזרת טלאים תיבת סימון סימן אישור לא

אם הפעולה מופעלת, היא מחזירה רשימה של תיקונים שצריך לעדכן במכונה.

הערה: הפעולה לא מחזירה תיקונים שהותקנו או תיקונים שהמערכת התעלמה מהם.
מספר התיקונים המקסימלי להחזרה מספר שלם 50 לא מציינים את מספר התיקונים שרוצים להחזיר. אם לא מציינים ערך, הפעולה מחזירה 50 תיקונים.

הפעלה ב-

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • שם המארח

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון 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): "None of the provided entities were enriched."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'העשרת ישויות'. הסיבה: {0}''.format(error.Stacktrace)

 כללי
שולחן קיר עם ויטרינה

כותרת: {entity.identifier}

עמודות:

  • מפתח
  • ערך
 ישות

הרצת פקודה במכשיר

מריצים פקודה בנקודת הקצה ב-Automox.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
פקודה DDL

סריקת המכשיר

ערכים אפשריים:

  • סריקת המכשיר
  • התקנת תיקונים ספציפיים
  • התקנת כל התיקונים הזמינים
  • הפעלה מחדש של המכשיר
 לא

מציינים פקודה שצריך להפעיל במכשיר.

הערה: אם בוחרים באפשרות "התקנת תיקונים ספציפיים", הפרמטר "שמות התיקונים" הוא חובה.
שמות של תיקונים CSV לא רלוונטי לא מציינים רשימה מופרדת בפסיקים של תיקונים שצריך להתקין.

הפעלה ב-

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • שם המארח

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון 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): "הפקודה "{Command}" בוצעה בהצלחה בישויות הבאות ב-Automox:‏ {entity.identifier}. כדאי לבדוק את תוצאת ה-JSON כדי לוודא שהפקודה בוצעה בצורה נכונה."

אם המכשיר לא נמצא או שהוא מחובר לישות אחת (is_success=true): "הפעולה לא הצליחה להריץ את הפקודה "{Command}" בישויות הבאות ב-Automox: ‏{entity.identifier}. צריך לבדוק את האיות ואת הקישוריות.

אם המכשיר לא נמצא או שהוא מחובר לכל הישויות (is_success=false): "לא בוצעו פקודות בישויות שצוינו. צריך לבדוק את האיות ואת הקישוריות.

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'ביצוע פקודת מכשיר'. הסיבה: {0}''.format(error.Stacktrace)

 כללי

הפעלת המדיניות

מפעילים מדיניות ב-Automox.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
היקף התיקון DDL

כל המכשירים

ערכים אפשריים:

  • רק ישויות
  • כל המכשירים
 לא

מציינים את היקף התיקון של הפעולה.

אם בוחרים באפשרות "רק ישויות", הפעולה מפעילה כללי מדיניות רק על הישויות התקינות בהיקף.

אם בוחרים באפשרות "כל המכשירים", הפעולה מפעילה את המדיניות בכל המכשירים בארגון.
שם המדיניות String לא רלוונטי לא צריך לציין את שם המדיניות שצריך להפעיל.

הפעלה ב-

הפעולה הזו פועלת על הישויות הבאות:

  • כתובת IP
  • שם המארח

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון is_success=False
תוצאת JSON
{
"status": "done/failure if entity not found"
}
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם השרת תוקן והפעולה הצליחה בישות אחת (is_success=true): "המדיניות {Policy} הופעלה בהצלחה בישויות הבאות ב-Automox:‏ {entity.identifier}."

אם הטיפול בבעיה בוצע בשרת ושרת אחד לא נמצא (is_success=true): "הפעולה לא הצליחה להפעיל את המדיניות {Policy} בישויות הבאות ב-Automox: ‏{entity.identifier}."

אם השרת טופל ולא נמצאו שרתים (is_success=false): "לא נמצאו ישויות. המדיניות {Policy} לא בוצעה".

אם כל השרתים תוקנו (is_success=true): "Successfully executed policy {Policy} in Automox."‎

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'ביצוע מדיניות'. הסיבה: {0}''.format(error.Stacktrace)

אם המדיניות לא נמצאה: "Error executing action "Execute Policy".‎ סיבה: המדיניות "{policy name}" לא נמצאה ב-Automox. צריך לבדוק את האיות.''

כללי

רשימת כללי המדיניות

מציגים את כללי המדיניות הזמינים ב-Automox.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
מפתח סינון DDL

יש לבחור טווח

ערכים אפשריים:

  • שם
  • מזהה
  • שם סוג המדיניות
  • סטטוס
 לא מציינים את המפתח שצריך להשתמש בו כדי לסנן את המדיניות.
לוגיקת הסינון DDL

לא צוינה

ערכים אפשריים:

  • לא צוינה
  • שווה
  • מכיל
 לא

מציינים את לוגיקת הסינון שרוצים להחיל.

לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key (מפתח סינון).
ערך המסנן String לא רלוונטי לא

מציינים את הערך שבו רוצים להשתמש במסנן.

אם בוחרים באפשרות "שווה", הפעולה מנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות "מכיל", הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה הזו.

אם לא מציינים ערך בפרמטר הזה, המסנן לא מופעל.

לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key (מפתח סינון).
מספר הרשומות המקסימלי להחזרה מספר שלם 50 לא מציינים את מספר הרשומות שרוצים להחזיר. אם לא מציינים ערך, הפעולה מחזירה 50 רשומות.

הפעלה ב-

הפעולה הזו לא פועלת על ישויות.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון 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".

אם הפרמטר Filter Value ריק (is_success=true): "המסנן לא הופעל כי הפרמטר Filter Value ריק".

אם הפרמטר "לוגיקת סינון" מוגדר כ "לא צוין" (is_success=true): "המסנן לא הוחל כי הפרמטר "לוגיקת סינון" לא צוין".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם הפרמטר "מפתח סינון" מוגדר כ "בחירת אפשרות אחת" ו "לוגיקת הסינון" מוגדרת כ "שווה" או "מכיל": "שגיאה בביצוע הפעולה "{action name}". הסיבה: צריך לבחור שדה מהפרמטר "מפתח סינון".

אם צוין ערך לא חוקי בפרמטר "מספר הרשומות המקסימלי להחזרה": "שגיאה בביצוע הפעולה "{action name}". הסיבה: "צוין ערך לא חוקי בשדה 'מספר הרשומות המקסימלי להחזרה': . צריך להזין מספר חיובי"."

אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "List Policies".‎ הסיבה: {0}''.format(error.Stacktrace)

 כללי
שולחן קיר עם ויטרינה

שם הטבלה: כללי מדיניות זמינים

עמודות בטבלה:

  • שם – שם
  • סוג – policy_type_name
  • אינדונזית – id
  • סטטוס – סטטוס
  • Notes - notes
 כללי

פינג

בודקים את הקישוריות ל-Automox.

פרמטרים

לא רלוונטי

הפעלה ב-

הפעולה לא פועלת על ישויות, ואין לה פרמטרים של קלט חובה.

תוצאות הפעולה

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון is_success=False
קיר תיקים
סוג התוצאות ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:

אם החיבור הצליח: "החיבור לשרת Automox בוצע בהצלחה באמצעות פרמטרי החיבור שסופקו".

הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק:

אם התגובה נכשלה: "החיבור לשרת Automox נכשל! השגיאה היא {0}".format(exception.stacktrace)

 כללי

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.