‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Qualys VM

במאמר הזה מוסבר איך לשלב את Qualys VM עם Google Security Operations.

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

השילוב Qualys VM דורש את הפרמטרים הבאים:

פרמטר	תיאור
`Api Root`	חובה. כתובת ה-URL הבסיסית של המכונה ב-Qualys VM.
`Username`	חובה. שם המשתמש שמשויך לפרטי הכניסה ל-Qualys VM API.
`Password`	חובה. הסיסמה שמשויכת לפרטי הכניסה שלכם ל-Qualys VM API.
`Verify SSL`	זה שינוי אופציונלי. אם האפשרות הזו נבחרה, האינטגרציה מאמתת את אישור ה-SSL כשמתחברים לשרת Qualys VM. מופעל כברירת מחדל.
`X-Requested-With Header`	זה שינוי אופציונלי. הערך של כותרת ה-HTTP ‏`X-Requested-With` שמשמשת לזיהוי המקור של בקשות ה-API. ערך ברירת המחדל הוא `Google SecOps SOAR`.

הוראות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

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

פעולות

הורדת תוצאות סריקת מכונות וירטואליות

תיאור

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

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
מזהה סריקה	String	לא רלוונטי	כן	סריקת ערך המזהה.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

[
    {
       "username": "username",
        "city": "New York",
        "zip": "10024",
        "name": "user name",
        "add1": "Broadway",
        "country": "United States of America",
        "company": "X",
        "state": "New York",
        "scan_report_template_title": "Scan Results",
        "result_date": "01/28/2019 12:16:42",
        "role": "Manager",
        "add2": "Suite"
     },{
        "status": "Finished",
        "scanner_appliance": "1.1.1.1 (Scanner 10.10.10-1, Vulnerability Signatures 10.10.10-2)",
        "network": "Global Default Network",
        "reference": "scan/1533110666.07264",
        "ips": "1.1.1.1",
        "launch_date": "08/01/2018 08:04:26",
        "option_profile": "Initial Options",
        "total_hosts": "1",
        "scan_title": "My first scan",
        "duration": "00:06:20",
        "excluded_ips": "",
        "asset_groups": null,
        "type": "API",
        "active_hosts": "1"
    },{
        "protocol": "tcp",
        "qid": 86000,
        "results": "Server Version\\tServer Banner\\ncloudflare-nginx\\tcloudflare-nginx",
        "solution": "N/A",
        "ip_status": "host scanned, found vuln",
        "port": "80",
        "category": "Web server",
        "severity": "1",
        "title": "Web Server Version",
        "instance": null,
        "dns": "1dot1dot1dot1.cloudflare-dns.com",
        "ip": "1.1.1.1",
        "type": "Ig",
        "vendor_reference": null,
        "cve_id": null,
        "ssl": "no",
        "netbios": null,
        "associated_malware": null,
        "pci_vuln": "no",
        "impact": "N/A",
        "fqdn": "",
        "bugtraq_id": null,
        "threat": "N/A",
        "os": "Linux 3.13",
        "exploitability": null
     },{
        "target_distribution_across_scanner_appliances": "External : 1.1.1.1"
    }
]

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

מארח העשרה

תיאור

העשרה של מארח במידע מ-Qualys VMDR.

פרמטרים

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

ריצה

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

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

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

תוצאת סקריפט

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

תוצאת JSON

[
   {
     "EntityResult":
      {
       "LAST_VM_SCANNED_DATE": "2019-01-06T12: 39: 00Z",
       "LAST_VM_SCANNED_DURATION": "490",
       "NETWORK_ID": "0",
       "IP": "1.1.1.1",
       "LAST_VULN_SCAN_DATETIME": "2019-01-06T12: 39: 00Z",
       "COMMENTS": "AddedbyX",
       "TRACKING_METHOD": "IP",
       "DNS": "one.one.one.one",
       "OS": "Linux3.13",
       "ID": "54664176"
      },
    "Entity": "1.1.1.1"
   }
]

העשרה של ישויות

שם שדה ההעשרה	לוגיקה – מתי להחיל
LAST_VM_SCANNED_DATE	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
LAST_VM_SCANNED_DURATION	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
NETWORK_ID	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
קניין רוחני (IP)	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
LAST_VULN_SCAN_DATETIME	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
תגובות	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
TRACKING_METHOD	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
DNS	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
מערכת הפעלה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
מזהה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
ישות	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON

תובנות

לא רלוונטי

Case wall

סוג התוצאות	ערך/תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם יש נתונים עבור מארח אחד (is_success=true): "המארחים הבאים עברו העשרה: {entity.identifier}." אם הנתונים לא זמינים עבור מארח אחד (is_success=true): "לא הייתה אפשרות להעשיר את הישויות הבאות באמצעות מידע מ-Qualys VMDR: {entity.identifier}". אם הנתונים לא זמינים לכל המארחים (is_success=false): "לא בוצע обогащение של מארחים". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'הוספת פרטים לישויות'". הסיבה: {0}''.format(error.Stacktrace)	כללי

סוג התוצאות

ערך/תיאור

סוג

הודעת פלט*

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

אם יש נתונים עבור מארח אחד (is_success=true): "המארחים הבאים עברו העשרה: {entity.identifier}."

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

אם הנתונים לא זמינים לכל המארחים (is_success=false): "לא בוצע обогащение של מארחים".

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

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

כללי

הורד את הדוח

תיאור

שליפת דוח לפי המזהה.

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
מזהה הדוח	String	לא רלוונטי	כן	ערך מזהה הדוח.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

{
  "STATUS":
    {
     "STATE": "Finished"
     },
  "EXPIRATION_DATETIME": "2019-02-04T13:11:15Z",
  "TITLE": "Scan scan/1533110666.07264 Report",
  "USER_LOGIN": "sempf3mh",
  "OUTPUT_FORMAT": "PDF",
  "LAUNCH_DATETIME": "2019-01-28T13:11:14Z",
  "TYPE": "Scan",
  "ID": "775111",
  "SIZE": "22.17 KB"
}

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הפעלת דוח תאימות

תיאור

אתם יכולים להריץ סריקות תאימות וליצור דוחות תאימות במארחים (כתובות IP) שנוספו למחשב.

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
כותרת הדוח	String	לא רלוונטי	כן	שם הדוח שהוגדר על ידי המשתמש. האורך המקסימלי של השם הוא 128 תווים. בדוח תאימות ל-PCI, שם הדוח מסופק על ידי Qualys ואי אפשר לשנות אותו.
סוג הדוח	String	לא רלוונטי	כן	שם התבנית.
פורמט הפלט	String	לא רלוונטי	כן	אפשר לציין פורמט פלט אחד. כשמציינים output_format=pdf, יכול להיות שייעשה שימוש בהפצה מאובטחת של PDF. דוגמה: pdf,‏ mht ו-html
כתובות IP/טווחי כתובות	String	לא רלוונטי	לא	מציינים כתובות IP או טווחים כדי לשנות (לבטל) את יעד הדוח, כפי שהוגדר בתבנית הדוח של התיקון. אם יש כמה כתובות IP או טווחים, צריך להפריד ביניהם בפסיקים.
קבוצות של נכסים דיגיטליים	String	לא רלוונטי	לא	רשימה מופרדת בפסיקים של קבוצות נכסים.
הפניה לסריקה	String	לא רלוונטי	לא	הצגת סריקה רק עם קוד הפניה מסוים לסריקה.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

דוח על תיקון באגים בגרסת ההשקה

תיאור

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

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
כותרת הדוח	String	לא רלוונטי	כן	שם הדוח שהוגדר על ידי המשתמש. האורך המקסימלי של השם הוא 128 תווים. בדוח תאימות ל-PCI, שם הדוח מסופק על ידי Qualys ואי אפשר לשנות אותו.
סוג הדוח	String	לא רלוונטי	כן	שם התבנית.
פורמט הפלט	String	לא רלוונטי	כן	אפשר לציין פורמט פלט אחד. כשמציינים output_format=pdf, יכול להיות שייעשה שימוש בהפצה מאובטחת של PDF. לדוגמה: pdf, ‏ mht ו-html
כתובות IP/טווחי כתובות	String	לא רלוונטי	לא	מציינים כתובות IP או טווחים כדי לשנות (לבטל) את יעד הדוח, כפי שהוגדר בתבנית הדוח של התיקון. אם יש כמה כתובות IP או טווחים, צריך להפריד ביניהם בפסיקים.
קבוצות של נכסים דיגיטליים	String	לא רלוונטי	לא	קבוצות נכסים. אם יש יותר מאחד, צריך להפריד ביניהם באמצעות פסיק.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הפעלת דוח התיקונים

תיאור

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

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

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
כותרת הדוח	String	לא רלוונטי	כן	שם הדוח שהוגדר על ידי המשתמש. האורך המקסימלי של השם הוא 128 תווים. בדוח תאימות ל-PCI, שם הדוח מסופק על ידי Qualys ואי אפשר לשנות אותו.
סוג הדוח	String	לא רלוונטי	כן	שם התבנית.
פורמט הפלט	String	לא רלוונטי	כן	אפשר לציין פורמט פלט אחד. כשמציינים output_format=pdf, יכול להיות שייעשה שימוש בהפצה מאובטחת של PDF. לדוגמה: pdf, ‏ mht ו-html
כתובות IP/טווחי כתובות	String	לא רלוונטי	לא	מציינים כתובות IP או טווחים כדי לשנות (לבטל) את יעד הדוח, כפי שהוגדר בתבנית הדוח של התיקון. אם יש כמה כתובות IP או טווחים, צריך להפריד ביניהם בפסיקים.
קבוצות של נכסים דיגיטליים	String	לא רלוונטי	לא	קבוצות נכסים. אם יש יותר מאחד, צריך להפריד ביניהם באמצעות פסיק.
הצגת התוצאות של כל הכרטיסים	תיבת סימון	סימן אישור	לא	מציין אם הדוח כולל כרטיסים שהוקצו למשתמש הנוכחי (המשתמש מוגדר כברירת מחדל) או את כל הכרטיסים בחשבון המשתמש. כברירת מחדל, הכרטיסים שהוקצו למשתמש הנוכחי נכללים.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הצגת דוח הסריקה

תיאור

מפעילים דוח סריקה.

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
כותרת הדוח	String	לא רלוונטי	כן	שם הדוח שהוגדר על ידי המשתמש. האורך המקסימלי של השם הוא 128 תווים. בדוח תאימות ל-PCI, שם הדוח מסופק על ידי Qualys ואי אפשר לשנות אותו.
סוג הדוח	String	לא רלוונטי	כן	שם התבנית.
פורמט הפלט	String	לא רלוונטי	כן	אפשר לציין פורמט פלט אחד. כשמציינים output_format=pdf, אפשר להשתמש בהפצה מאובטחת של PDF. לדוגמה: pdf, ‏ mht ו-html.
כתובות IP/טווחי כתובות	String	לא רלוונטי	לא	מציינים כתובות IP או טווחים כדי לשנות (לבטל) את יעד הדוח, כפי שהוגדר בתבנית הדוח של התיקון. אם יש כמה כתובות IP או טווחים, צריך להפריד ביניהם בפסיקים.
קבוצות של נכסים דיגיטליים	String	לא רלוונטי	לא	קבוצות נכסים. אם יש יותר מאחד, צריך להפריד ביניהם באמצעות פסיקים.
הפניה לסריקה	String	לא רלוונטי	לא	הצגת סריקה רק עם קוד הפניה מסוים לסריקה.

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הפעלת סריקת מכונה וירטואלית ואחזור תוצאות

תיאור

הפעלת סריקת פגיעויות במארח ברשת ואחזור התוצאות.

הרישיון שמגביל את מספר המארחים תלוי במינוי שלכם.

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
כותרת	String	לא רלוונטי	לא	שם הסריקה. האורך המקסימלי הוא 2,000 תווים (ASCII).
עדיפות העיבוד	String	לא רלוונטי	כן	מציינים ערך בין 0 ל-9 כדי להגדיר רמת עדיפות לעיבוד הסריקה. אם לא מציינים ערך, נעשה שימוש בערך 0 (ללא עדיפות). הערכים החוקיים הם: ‫0 ללא עדיפות (ברירת המחדל) ‫1 למקרה חירום ‫2 for Ultimate ‫3 לבעיות קריטיות ‫4 לדרגת חומרה גבוהה ‫5 לרמה גבוהה ‫6 למינוי Standard ‫7 עבור Medium ‫8 לטיפול קטן ‫9 לרמה נמוכה
סריקת פרופיל	String	לא רלוונטי	כן	השם של פרופיל אפשרויות התאימות שבו רוצים להשתמש. חובה לציין אחד מהפרמטרים האלה בבקשה: option_title option_id
סורק	String	לא רלוונטי	לא	השמות הידידותיים של מכשירי הסריקה שבהם רוצים להשתמש, או 'חיצוני' אם רוצים להשתמש בסורקים חיצוניים. אם יש כמה ערכים, צריך להפריד ביניהם בפסיקים.
רשת	String	לא רלוונטי	לא	המזהה של רשת שמשמשת לסינון כתובות ה-IP או הטווחים שצוינו בפרמטר ip. הגדרה למזהה רשת בהתאמה אישית. הערה: הפעולה הזו לא מסננת כתובות IP או טווחים שצוינו ב-asset_groups או ב-asset_group_ids. אפשר גם להגדיר את הערך 0 (ברירת המחדל) עבור רשת ברירת המחדל הגלובלית. הערך הזה משמש לסריקת מארחים מחוץ לרשתות המותאמות אישית.

ריצה

הפעולה הזו מופעלת על ישות של כתובת IP.

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

העשרה של ישויות

שם שדה ההעשרה	לוגיקה – מתי להחיל
שם משתמש	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
עיר	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
מיקוד	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
name	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
add1	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
מדינה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
חברה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
הסמוי הסופי	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
can_report_template_title	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
result_date	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
תפקיד	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
add2	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
סטטוס	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
scanner_appliance	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
network	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
הפניה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
ips	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
launch_date	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
option_profile	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
total_hosts	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
scan_title	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
משך	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
excluded_ips	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
asset_groups	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
סוג	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
active_hosts	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
פרוטוקול	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
qid	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
תוצאות	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
פתרון	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
severity	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
כותרת	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
מכונה	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
dns	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
ip	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
vendor_reference	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
cve_id	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
ssl	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
netbios	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
associated_malware	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
pci_vuln	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
fqdn	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
bugtraq_id	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
איום	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
os	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON
אפשרות ניצול	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON

תובנות

לא רלוונטי

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך	דוגמה
scan_ref	לא רלוונטי	לא רלוונטי

תוצאת JSON

[
  {
    "username": "username",
    "city": "New York",
    "zip": "10024",
    "name": "user name",
    "add1": "Broadway",
    "country": "United States of America",
    "company": "X",
    "state": "New York",
    "scan_report_template_title": "Scan Results",
    "result_date": "01/28/2019 12:16:42",
    "role": "Manager",
    "add2": "Suite"
  },{
    "status": "Finished",
    "scanner_appliance": "1.1.1.1 (Scanner 10.10.10-1, Vulnerability Signatures 10.10.10-2)",
    "network": "Global Default Network",
    "reference": "scan/1533110666.07264",
    "ips": "1.1.1.1",
    "launch_date": "08/01/2018 08:04:26",
    "option_profile": "Initial Options",
    "total_hosts": "1",
    "scan_title": "My first scan",
    "duration": "00:06:20",
    "excluded_ips": "",
    "asset_groups": null,
    "type": "API",
    "active_hosts": "1"
  },{
    "protocol": "tcp",
    "qid": 86000,
    "results": "Server VersiontServer Banner\\ncloudflare-nginx\\tcloudflare-nginx",
    "solution": "N/A",
    "ip_status": "host scanned, found vuln",
    "port": "80",
    "category": "Web server",
    "severity": "1",
    "title": "Web Server Version",
    "instance": null,
    "dns": "1dot1dot1dot1.cloudflare-dns.com",
    "ip": "1.1.1.1",
    "type": "Ig",
    "vendor_reference": null,
    "cve_id": null,
    "ssl": "no",
    "netbios": null,
    "associated_malware": null,
    "pci_vuln": "no",
    "impact": "N/A",
    "fqdn": "",
    "bugtraq_id": null,
    "threat": "N/A",
    "os": "Linux 3.13",
    "exploitability": null
   },{
    "target_distribution_across_scanner_appliances": "External : 1.1.1.1"
   }
]

הצגת רשימה של קבוצות

תיאור

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

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

[{
   "TITLE": "All",
   "IP_SET":
      {
        "IP": ["1.1.1.1"]
       },
   "DOMAIN_LIST":
      {
        "DOMAIN":
          [{
             "@network_id": "0",
             "#text": "google.com"
           },{
             "@network_id": "0",
             "#text": "none",
             "@netblock": "1.1.1.1-1.1.1.1"
           }]
      },
   "LAST_UPDATE": "2018-07-25T14:56:05Z",
   "NETWORK_ID": "0",
   "OWNER_USER_NAME": "Global User",
   "BUSINESS_IMPACT": "High",
   "ID": "1111"
 },{
   "TITLE": "G",
   "NETWORK_ID": "0",
   "LAST_UPDATE": "2018-08-13T08:14:55Z",
   "OWNER_USER_NAME": "user (Manager)",
   "OWNER_USER_ID": "11111",
   "BUSINESS_IMPACT": "High",
   "ID": "11111"
 }]

העשרה של ישויות

לא רלוונטי ##### תובנות

לא רלוונטי

הצגת רשימת כתובות IP

תיאור

רשימת כתובות ה-IP בחשבון של המשתמש. כברירת מחדל, כל המארחים בחשבון של המשתמש כלולים.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

[
  "1.1.1.1",
  "1.1.100.100",
  "10.10.10.10"
]

העשרה של ישויות

לא רלוונטי ##### תובנות

לא רלוונטי

דוחות רשימה

תיאור

רשימת הדוחות בחשבון של המשתמש כשהתכונה Report Share (שיתוף דוחות) מופעלת. פלט רשימת הדוחות כולל את כל סוגי הדוחות, כולל דוחות כרטיסי ניקוד.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

[
  {
    "STATUS":
      {
        "STATE": "Finished"
      },
    "EXPIRATION_DATETIME": "2019-02-04T13:11:15Z",
    "TITLE": "Scan scan/1533110666.07264 Report",
    "USER_LOGIN": "sempf3mh",
    "OUTPUT_FORMAT": "PDF",
    "LAUNCH_DATETIME": "2019-01-28T13:11:14Z",
    "TYPE": "Scan",
    "ID": "775111",
    "SIZE": "22.17 KB"
  }
]

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הצגת רשימה של סריקות

תיאור

רשימה של סריקות שהופעלו ב-30 הימים האחרונים.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

    [
       {
         "STATUS":
           {
              "STATE": "Finished"
           },
        "TARGET": "1.1.1.1",
        "TITLE": "Test Scan",
        "USER_LOGIN": "sempf3mh",
        "LAUNCH_DATETIME": "2019-01-06T12:29:52Z",
        "PROCESSED": "1",
        "REF": "scan/1546777792.44756",
        "PROCESSING_PRIORITY": "0 - No Priority",
        "DURATION": "00:08:24",
        "TYPE": "On-Demand"
       }
     ]

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

פינג

תיאור

בדיקת הקישוריות.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

הצגת רשימה של זיהויים בנקודות קצה

תיאור

איך רואים את רשימת הזיהויים של נקודות קצה ב-Qualys VMDR.

פרמטרים

השם המוצג של הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
סינון לפי סטטוס	CSV	חדש, פעיל, נפתח מחדש	לא	מציינים רשימה מופרדת בפסיקים של סטטוסים שבהם צריך להשתמש במהלך ההטמעה. אם לא מספקים כלום, הפעולה מטמיעה זיהויים עם הסטטוסים 'חדש', 'פעיל' ו'נפתח מחדש'. ערכים אפשריים: New, ‏ Active, ‏ Fixed, ‏ Re-Opened.
הטמעת זיהויים שהמערכת התעלמה מהם	תיבת סימון	התיבה לא מסומנת	לא	אם האפשרות הזו מופעלת, הפעולה מחזירה גם זיהויים שהמערכת התעלמה מהם.
הוספה של זיהויים מושבתים	תיבת סימון	התיבה לא מסומנת	לא	אם האפשרות הזו מופעלת, הפעולה מחזירה גם זיהויים מושבתים.
רמת החומרה הנמוכה ביותר לאחזור	DDL	בינוני	לא	מציינים את רמת החומרה הנמוכה ביותר שמשמשת לאחזור זיהויים.
יצירת תובנה	תיבת סימון	סימן אישור	לא	אם האפשרות הזו מופעלת, הפעולה יוצרת תובנה שמכילה מידע על נקודות חולשה שנמצאו בישות.
מספר הזיהויים המקסימלי שיוחזרו	מספר שלם	50	לא	מציינים את מספר הזיהויים שיוחזרו לכל ישות. מקסימום: 200

ריצה

הפעולה לא מופעלת בישויות.

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

תוצאת סקריפט

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

תוצאת JSON

N/A

העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

Case wall

סוג התוצאות	ערך/תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם נמצאו נתונים של לפחות נקודת קצה אחת (is_success=true): "הצלחנו לרשום את הגילויים שקשורים לנקודות הקצה הבאות ב-Qualys VMDR: {entity.identifier} אם לא נמצאה נקודת קצה אחת או שסופקה כתובת IP לא חוקית (is_success=true): "Action wasn't able to find the following endpoints in Qualys VMDR: {entity.identifier}." אם לא נמצאו נתונים לפחות עבור נקודת קצה אחת (is_success=true): "לא נמצאו נקודות חולשה בנקודות הקצה הבאות: {entity.identifier}". אם לא נמצאו נתונים לגבי כל נקודות הקצה (is_success=true): "לא נמצאו נקודות חולשה בנקודות הקצה שצוינו". אם לא נמצאו נקודות קצה או שסופקה כתובת IP לא חוקית (is_success=false): 'לא נמצאו נקודות הקצה שסופקו ב-Qualys VMDR'. הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "Error executing action "List Endpoint Detections''. הסיבה: {0}''.format(error.Stacktrace) אם מדווח על 'מסנן סטטוס' לא תקין: 'שגיאה בהפעלת הפעולה 'List Endpoint Detections''. הסיבה: ערך לא תקין סופק לפרמטר 'מסנן סטטוס': {value}. הערכים האפשריים: new, open, reopened, fixed.	כללי
Case Wall	עמודות הטבלה: QID כותרת חוּמרה אבחון השלכות פתרון ניתן להחיל תיקון קטגוריה	ישות

סוג התוצאות

ערך/תיאור

סוג

הודעת פלט*

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

אם נמצאו נתונים של לפחות נקודת קצה אחת (is_success=true): "הצלחנו לרשום את הגילויים שקשורים לנקודות הקצה הבאות ב-Qualys VMDR: {entity.identifier}

אם לא נמצאה נקודת קצה אחת או שסופקה כתובת IP לא חוקית (is_success=true): "Action wasn't able to find the following endpoints in Qualys VMDR: {entity.identifier}."

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

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

אם לא נמצאו נקודות קצה או שסופקה כתובת IP לא חוקית (is_success=false): 'לא נמצאו נקודות הקצה שסופקו ב-Qualys VMDR'.

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

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

אם מדווח על 'מסנן סטטוס' לא תקין: 'שגיאה בהפעלת הפעולה 'List Endpoint Detections''. הסיבה: ערך לא תקין סופק לפרמטר 'מסנן סטטוס': {value}. הערכים האפשריים: new, open, reopened, fixed.

כללי

Case Wall

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

QID
כותרת
חוּמרה
אבחון
השלכות
פתרון
ניתן להחיל תיקון
קטגוריה

ישות

מחברים

Qualys VM - Detections Connector

תיאור

שליפת ממצאים מ-Qualys VMDR.

הגדרה של מחבר הזיהויים של Qualys VM ב-Google SecOps

הוראות מפורטות להגדרת מחבר ב-Google SecOps מופיעות במאמר בנושא הגדרת המחבר.

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

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

השם המוצג של הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
שם שדה המוצר	String	שם המוצר	כן	מזינים את שם שדה המקור כדי לאחזר את שם שדה המוצר.
שם השדה של האירוע	String	סוג האירוע	כן	מזינים את שם שדה המקור כדי לאחזר את שם שדה האירוע.
שם השדה בסביבה	String	""	לא	מתאר את שם השדה שבו מאוחסן שם הסביבה. אם לא נמצא שדה סביבה, הסביבה היא סביבת ברירת המחדל.
תבנית ביטוי רגולרי (regex) של סביבה	String	.*	לא	תבנית regex להפעלה על הערך שנמצא בשדה 'שם שדה הסביבה'. ברירת המחדל היא ‎ .* ‎ כדי לתפוס את כל הערכים ולהחזיר אותם ללא שינוי. משמש כדי לאפשר למשתמש לשנות את שדה הסביבה באמצעות לוגיקה של ביטוי רגולרי. אם תבנית הביטוי הרגולרי היא null או ריקה, או שערך הסביבה הוא null, התוצאה הסופית של הסביבה היא סביבת ברירת המחדל.
זמן קצוב לסקריפט (בשניות)	מספר שלם	300	כן	מגבלת הזמן הקצוב לתהליך Python שמריץ את הסקריפט הנוכחי.
ספריית הבסיס של ה-API	String	לא רלוונטי		כתובת ה-API הבסיסית של מופע Qualis VM.
שם משתמש	String	לא רלוונטי	כן	שם המשתמש של מכונת ה-VM של Qualis.
סיסמה	סיסמה	לא רלוונטי	כן	הסיסמה של מכונת ה-VM של Qualis.
רמת החומרה הנמוכה ביותר לאחזור	מספר שלם	0	לא	רמת החומרה הנמוכה ביותר שתשמש לאחזור זיהויים. אם לא מספקים כלום, המחבר יאחזר את כל הזיהויים. מקסימום: 5.
סינון לפי סטטוס	CSV	חדש, פעיל, נפתח מחדש	לא	מסנן סטטוס למחבר. אם לא מצוין ערך, המחבר יקלוט זיהויים עם הסטטוסים 'חדש', 'פעיל' ו'נפתח מחדש'. הערכים האפשריים: NEW, ACTIVE, FIXED, REOPENED.
הטמעת זיהויים שהמערכת התעלמה מהם	תיבת סימון	התיבה לא מסומנת	לא	אם ההגדרה הזו מופעלת, המחבר יקלוט זיהויים שהמערכת התעלמה מהם.
הוספה של זיהויים מושבתים	תיבת סימון	התיבה לא מסומנת	לא	אם ההגדרה הזו מופעלת, המחבר יקלוט זיהויים מושבתים.
מנגנון קיבוץ	String	זיהוי	כן	מנגנון קיבוץ שישמש ליצירת התראות ב-Google SecOps. ערכים אפשריים: Host (מארח), Detection (זיהוי), None (ללא). אם מצוין מארח, המחבר ייצור התראה אחת ב-Google SecOps שתכלול את כל הזיהויים שקשורים למארח. אם מסופק זיהוי, המחבר ייצור התראה אחת ב-Google SecOps שתכיל מידע על כל המארחים שזוהו. אם לא מספקים ערך או שמספקים ערך לא תקין, המחבר יוצר התראה חדשה ב-Google SecOps לכל זיהוי נפרד לכל מארח.
שימוש ברשימת ההיתרים כרשימה שחורה	תיבת סימון	התיבה לא מסומנת	כן	אם האפשרות הזו מופעלת, רשימת ההיתרים תשמש כרשימת חסימות.
אימות SSL	תיבת סימון	סימן אישור	כן	אם האפשרות הזו מופעלת, צריך לוודא שאישור ה-SSL של החיבור לשרת Qualys VMDR תקף.
כתובת שרת ה-Proxy	String	לא רלוונטי	לא	הכתובת של שרת ה-Proxy שבו רוצים להשתמש.
שם משתמש של שרת proxy	String	לא רלוונטי	לא	שם המשתמש ב-proxy לאימות.
סיסמת שרת Proxy	סיסמה	לא רלוונטי	לא	סיסמת ה-proxy לאימות.
הכותרת X-Requested-With	String	Google SecOps SOAR	לא	הערך של כותרת ה-HTTP ‏`X-Requested-With` שמשמשת לזיהוי המקור של בקשות ה-API.

כללים של Connectors

תמיכה ב-Proxy

המחבר תומך בשרת proxy.

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