שילוב של Cisco Vulnerability Management עם Google SecOps

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

תרחישים לדוגמה

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

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

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

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
הרמה הבסיסית (root) של ה-API String כן שורש ה-API של השילוב של Cisco ניהול נקודות חולשה.
טוקן API סיסמה כן אסימון ה-API של השילוב עם Cisco ניהול נקודות חולשה.
אימות SSL bool סימן אישור כן אם בוחרים באפשרות זו, השילוב מאמת את אישור ה-SSL כשמתחברים ל-Cisco ניהול נקודות חולשה. האפשרות הזו מסומנת כברירת מחדל.

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

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

פעולות

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

פינג

בודקים את הקישוריות ל-Cisco ניהול נקודות חולשה.

פרמטרים

לא רלוונטי

הפעלה ב-

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון is_success:False
קיר נרתיק הטעינה
סוג התוצאות תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק:
אם הפעולה הצליחה:
print "Successfully connected to the Cisco Vulnerability Management server with the provided connection parameters!"

הפעולה אמורה להיכשל ולעצור את הרצת הפלייבוק:
If not successful:
print "Failed to connect to the Cisco ניהול נקודות חולשה server! השגיאה היא {0}".format(exception.stacktrace)
כללי

העשרת ישויות

העשרת ישויות באמצעות מידע מ-Cisco Vulnerability Management.

פרמטרים

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

הפעלה ב-

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

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
   "Entity": "Entity",
   "EntityResult":
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li><i>Operating System</i> <b>microsoft windows_server_2016</b></li><li><i>Operating System</i> <b>microsoft windows_server_2019</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022_23h2</b></li></ul>The following remediations or software updates can fix your system:<ul><li><b>windows_11_24h2</b> version needs to be updated to version 10.0.26100.1457 or greater.</li><li><b>windows_server_2022_23h2</b> version needs to be updated to version 10.0.25398.1085 or greater.</li><li><b>Windows 10 Version 20H2 Build 10240</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041782\">5041782</a>.</li><li><b>Windows 10 Version 1607 Build 14393</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows 10 Version 1809 Build 17763</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows 10 Version 21H2 Build 19044</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 10 Version 22H2 Build 19045</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 11 Version 21H2 Build 22000</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041592\">5041592</a>.</li><li><b>Windows 11 Version 22H2 Build 22621</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows 11 Version 23H2 Build 22631</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows Server 2012</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041851\">5041851</a>.</li><li><b>Windows Server 2012 R2</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041828\">5041828</a>.</li><li><b>Windows Server 2016</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows Server 2019</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows Server 2022 Build 20348</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041160\">5041160</a>.</li></ul>Refer to these referenced URL(s) for more information on remediation:<br/><ul><li><a href=\"https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107\">https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107</a></li></ul>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }

}
העשרת ישויות

קידומת: CiscoVM_‎

שם שדה ההעשרה לוגיקה – מתי להחיל
עדיפות כשהוא זמין ב-JSON
severity כשהוא זמין ב-JSON
איום כשהוא זמין ב-JSON
פתרון כשהוא זמין ב-JSON
patch_available כשהוא זמין ב-JSON
description כשהוא זמין ב-JSON
published_at כשהוא זמין ב-JSON
risk_score כשהוא זמין ב-JSON
נכס של טבלת העשרה

קידומת: CiscoVM_‎

שם שדה ההעשרה לוגיקה – מתי להחיל
os כשהוא זמין ב-JSON
עדיפות כשהוא זמין ב-JSON
vulnerabilities_count כשהוא זמין ב-JSON
סטטוס כשהוא זמין ב-JSON
last_seen_time כשהוא זמין ב-JSON
תגים כשהוא זמין ב-JSON
ip_address כשהוא זמין ב-JSON
שם המארח כשהוא זמין ב-JSON
fqdn כשהוא זמין ב-JSON
risk_score כשהוא זמין ב-JSON
asset_groups כשהוא זמין ב-JSON
קיר נרתיק הטעינה
סוג התוצאות תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של הפלייבוק:

אם יש נתונים זמינים לישות אחת (is_success = true):
מדפיסים את ההודעה "Successfully enriched the following entities in Cisco ניהול נקודות חולשה: {entity.identifier}".

אם אין נתונים זמינים לישות אחת (is_success=true):
print "The action wasn't able to enrich the following entities in Cisco Vulnerability Management: {entity.identifier}"

אם אין נתונים זמינים לכל הישויות (is_success=false):
No information was found for the provided entities.

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

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

עדכון נכס

עדכון פרטי הנכסים שמשויכים לישויות של Google SecOps מ-Cisco ניהול נקודות חולשה.

פרמטרים

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

ערכים אפשריים:
  • פעיל
  • לא פעיל
  • יש לבחור טווח
לא סטטוס הנכס.
נתונים String לא הערה לגבי הנכס.

הפעלה ב-

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

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

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

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

קיר נרתיק הטעינה

סוג התוצאות תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את הרצת הפלייבוק:

אם יש נתונים זמינים לישות אחת (is_success = true):
מדפיסים את ההודעה "Successfully updated the following entities in Cisco ניהול נקודות חולשה: {entity.identifier}".

אם ישות אחת לא נמצאה (is_success=true):
print "The action wasn't able to update the following entities in Cisco ניהול נקודות חולשה: {entity.identifier}"

אם אין נתונים זמינים לכל הישויות (is_success=false):
None of the provided entities were updated.


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

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

הצגת רשימה של נקודות חולשה בנכסים

החזרת מידע על נקודות חולשה שמשויכות לישויות מ-Cisco Vulnerability Management.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה חיצוני CSV לא רשימה מופרדת בפסיקים של מזהים חיצוניים שמשויכים לנכס. חיפוש נכסים לפי מזהה חיצוני יתבצע במקביל לחיפוש ישויות.
ציון הסיכון הנמוך ביותר להחזרה Int לא ציון הסיכון שמשויך לנקודות החולשה. אם מציינים את הפרמטר הזה, הפעולה תסנן את כל נקודות החולשה שציון הסיכון שלהן נמוך מהציון שצוין ב-Lowest Risk Score To Return.

הפעלה ב-

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

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

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

תוצאת הסקריפט
שם תוצאת הסקריפט אפשרויות לערכים דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
   "Entity": "Entity",
   "EntityResult": [
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }
   ]
}
קיר נרתיק הטעינה
סוג התוצאות תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של הפלייבוק:

אם יש נתונים זמינים לישות אחת (is_success = true):
מדפיסים את ההודעה "Successfully listed vulnerabilities for the following entities in Cisco ניהול נקודות חולשה: {entity.identifier}".

אם ישות אחת לא נמצאה (is_success=true):
print "The action wasn't able to find the following entities in Cisco Vulnerability Management: {entity.identifier}"

אם אין נתונים זמינים לכל הישויות (is_success=false):
None of the provided entities were found.

אם לא נמצאו נקודות חולשה בחלק מהישויות (is_success=true):

לא נמצאו נקודות חולשה לפי הקריטריונים שצוינו בישויות הבאות ב-Cisco Vulnerability Management: {entity.identifier}

אם לא נמצאו נקודות חולשה בכל הישויות (is_success=true):

לא נמצאו נקודות חולשה לפי הקריטריונים שצוינו בישויות שצוינו.

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

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

בקשה לייצוא נתונים

מבקשים ייצוא נתונים מ-Cisco Vulnerability Management ומצרפים את התוצאות לקיר של בקשת התמיכה. הפעולה הזו לא פועלת על ישויות של Google SecOps.

הפעולה הזו היא אסינכרונית. במידת הצורך, משנים את ערך הזמן הקצוב לתפוגה של הסקריפט ב-Google SecOps IDE לפעולה.

פרמטרים

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

ערכים אפשריים:
  • JSON
  • JSONL
  • XML
כן הפורמט של ייצוא הנתונים.
ייצוא מודל DDL נכס

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

הפעלה ב-

לא רלוונטי

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

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

אם הנתונים זמינים(is_success = true):
מדפיסים את ההודעה "Successfully performed data export in Cisco Vulnerability Management".

הודעה אסינכרונית:
ממתין להשלמת ייצוא הנתונים…


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

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

If error_message in response:

print "Error executing action "Request Data Export". הסיבה: {error_message}''.
כללי

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