Trend Micro Vision One

הגדרת השילוב של Trend Micro Vision One ב-Google Security Operations

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

פרמטרים להגדרת שילוב

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

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
ספריית הבסיס של ה-API String https://{instance} כן נתיב הבסיס של ה-API של מופע Trend Micro Vision One.
טוקן API String לא רלוונטי כן מפתח ה-API של חשבון Trend Micro Vision One.
אימות SSL תיבת סימון סימן אישור לא אם ההגדרה מופעלת, האינטגרציה בודקת שאישור ה-SSL של החיבור לשרת Trend Micro Vision One תקף.

איך ליצור אסימון API

מידע נוסף על יצירת אסימון API זמין במאמר קבלת אסימון אימות של חשבון.

פעולות

העשרת ישויות

תיאור הפעולה

העשרת ישויות באמצעות מידע מ-Trend Micro Vision One. ישויות נתמכות: שם מארח, כתובת IP.

פרמטרים להגדרת פעולות

לפעולה הזו אין פרמטרים להגדרה.

הפעלה ב-

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

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

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

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאה בפורמט JSON
{
           "agentGuid": "3b3ff9df-d588-45a2-bb90-d73904accf46",
           "osName": "Windows",
           "osVersion": "6.1.7601",
           "osDescription": "Windows 7 Professional (64 bit) build 7601",
           "productCode": "xes",
           "loginAccount": {
               "value": [
                   "WINDOWS7\\devs"
               ],
               "updatedDateTime": "2022-12-26T17:28:51.000Z"
           },
           "endpointName": {
               "value": "WINDOWS7",
               "updatedDateTime": "2022-12-27T17:47:17.000Z"
           },
           "macAddress": {
               "value": [
                   "00:50:56:b6:3e:a1",
                   "00:00:00:00:00:00:00:e0"
               ],
               "updatedDateTime": "2022-12-27T17:47:17.000Z"
           },
           "ip": {
               "value": [
                   "172.30.201.12"
               ],
               "updatedDateTime": "2022-12-27T17:47:17.000Z"
           },
           "installedProductCodes": [
               "xes"
           ]
}
העשרה של ישויות

תחילית TrendMicroVisionOne_

שם שדה ההעשרה מקור (מפתח JSON) לוגיקה – מתי להחיל
os osDescription כשהנתונים זמינים בפורמט JSON
login_account קובץ CSV של loginAccount.value כשהנתונים זמינים בפורמט JSON
endpoint_name endpointName.value כשהנתונים זמינים בפורמט JSON
ip ‫Csv ip.value כשהנתונים זמינים בפורמט JSON
installedProductCodes קובץ CSV של installedProductCodes כשהנתונים זמינים בפורמט JSON
Case wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

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

אם הנתונים לא זמינים לכל הישויות (is_success=false): 'אף אחת מהישויות שסופקו לא עברה העשרה'.

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

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

כללי
Case Wall Table

כותרת: {entity.identifier}

עמודות של ערך מפתח

ישות

הפעלת סקריפט בהתאמה אישית

תיאור הפעולה

הפעלת סקריפט מותאם אישית בנקודת הקצה ב-Trend Micro Vision One. ישויות נתמכות: שם מארח, כתובת IP. הפעולה מופעלת באופן אסינכרוני. צריך לשנות את ערך הזמן הקצוב לתפוגה של הסקריפט בסביבת הפיתוח המשולבת (IDE) של Google SecOps SOAR עבור הפעולה לפי הצורך.

פרמטרים להגדרת פעולות

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

הפעלה ב-

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

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

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

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

תוצאת ה-JSON מוצגת גם אם הפעולה נכשלת.

{
   "Entity": "qweqwe",
   "EntityResult": {
    "task_id": "{task id}"
       "status": "{task status}"
   }
}
Case wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם הנתונים זמינים לנקודת קצה אחת (הערך is_success הוא true רק אם כל נקודות הקצה הצליחו, אחרת הוא false): "Successfully executed custom script "{script name}" on the following endpoints in Trend Micro Vision One: {entity.identifier}"

אם הנתונים לא זמינים עבור נקודת קצה אחת או שלא נמצא נכס (is_success=false): "לא הייתה אפשרות להפעיל את הסקריפט המותאם אישית {scrip name} בנקודות הקצה הבאות באמצעות Trend Micro Vision One: {entity.identifier}"

אם הנתונים לא זמינים לכל נקודות הקצה (is_success=false): 'הסקריפטים לא הופעלו בנקודות הקצה שסופקו'.

הודעה אסינכרונית: 'נקודות קצה בהמתנה: {entities}'

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

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

אם לא נמצא סקריפט מותאם אישית: "שגיאה בהפעלת הפעולה 'הפעלת סקריפט מותאם אישית'. הסיבה: לא נמצא סקריפט עם השם '{שם הסקריפט}'.

אם הפעולה נתקלה בפסק זמן: "שגיאה בהפעלת הפעולה 'הפעלת סקריפט בהתאמה אישית'. הסיבה: הפעולה נתקלה בפסק זמן במהלך הביצוע. נקודות קצה בהמתנה: {endpoints that are still in progress}. צריך להגדיל את הזמן הקצוב לתפוגה ב-IDE. הערה: הפעולה תריץ שוב את הסקריפט המותאם אישית".

כללי

בידוד נקודת קצה

תיאור הפעולה

בידוד נקודות קצה ב-Trend Micro Vision One. יש תמיכה בישויות הבאות: כתובת IP, שם מארח. הפעולה מופעלת באופן אסינכרוני, לכן צריך להתאים את ערך הזמן הקצוב לתפוגה של הסקריפט ב-IDE של Google SecOps SOAR לפעולה לפי הצורך.

פרמטרים להגדרת פעולות

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

הפעלה ב-

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

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

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

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

תוצאת ה-JSON מוצגת גם אם הפעולה נכשלת.

{
   "Entity": "qweqwe",
   "EntityResult": {
       "status": "{task status}"
   }
}
Case wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם הנתונים זמינים לנקודת קצה אחת (הערך is_success=true רק אם כל נקודות הקצה בודדו בהצלחה, אחרת הערך הוא false): "Successfully isolated the following endpoints in Trend Micro Vision One: {entity.identifier}"

אם הנתונים לא זמינים עבור נקודת קצה אחת או אם הנכס לא נמצא (is_success=false): "לא הייתה אפשרות לבודד את נקודות הקצה הבאות באמצעות Trend Micro Vision One: {entity.identifier}"

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

הודעה אסינכרונית: 'נקודות קצה בהמתנה: {entities}'

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

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

אם הפעולה נתקלה בפסק זמן: 'שגיאה בהפעלת הפעולה 'בידוד נקודות קצה'. הסיבה: הפעולה נתקלה בפסק זמן במהלך הביצוע. נקודות קצה בהמתנה: {endpoints that are still in progress}. צריך להגדיל את הזמן הקצוב לתפוגה ב-IDE".

כללי

ביטול הבידוד של נקודת קצה

תיאור הפעולה

ביטול הבידוד של נקודות קצה ב-Trend Micro Vision One. יש תמיכה בישויות הבאות: כתובת IP, שם מארח. הפעולה מופעלת באופן אסינכרוני, לכן צריך להתאים את ערך הזמן הקצוב לתפוגה של הסקריפט ב-IDE של Google SecOps SOAR לפעולה לפי הצורך.

פרמטרים להגדרת פעולות

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

הפעלה ב-

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

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

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

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

תוצאת ה-JSON מוצגת גם אם הפעולה נכשלת.

{
   "Entity": "qweqwe",
   "EntityResult": {
       "status": "{task status}"
   }
}
Case wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם הנתונים זמינים עבור נקודת קצה אחת (הערך is_success=true רק אם כל נקודות הקצה בודדו בהצלחה, אחרת הערך הוא false): "הסרת הבידוד של נקודות הקצה הבאות ב-Trend Micro Vision One בוצעה בהצלחה: {entity.identifier}"

אם הנתונים לא זמינים עבור נקודת קצה אחת או שנכס לא נמצא (is_success=false): "לא הייתה אפשרות לבטל את הבידוד של נקודות הקצה הבאות באמצעות Trend Micro Vision One: {entity.identifier}"

אם הנתונים לא זמינים לכל נקודות הקצה (is_success=false): "אף אחת מנקודות הקצה שסופקו לא בוטלה מהבידוד".

הודעה אסינכרונית: 'נקודות קצה בהמתנה: {entities}'

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

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

אם הפעולה נתקלה בפסק זמן: "שגיאה בהפעלת הפעולה 'ביטול הבידוד של נקודות הקצה'. הסיבה: הפעולה נתקלה בפסק זמן במהלך הביצוע. נקודות קצה בהמתנה: {endpoints that are still in progress}. צריך להגדיל את הזמן הקצוב לתפוגה ב-IDE".

כללי

עדכון התראה ב-Workbench

תיאור הפעולה

עדכון התראה ב-Trend Micro Vision One.

פרמטרים להגדרת פעולות

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

יש לבחור טווח

ערך אפשרי:

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

הפעלה ב-

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

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

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאה בפורמט JSON
{
      "artifacts": [],
      "assignedTo": "tip.labops",
      "assignee": {
          "displayName": "tip.labops@siemplify.co",
          "username": "tip.labops"
      },
      "closed": "2022-03-23T11:04:33.731971",
      "closedBy": "tip.labops",
      "confidence": 0.1,
      "created": "2022-03-11T08:48:26.030204",
      "description": "Detects multiple failed login attempts from a single source with unique usernames over a 24 hour timeframe. This is designed to catch both slow and quick password spray type attacks. The threshold and time frame can be adjusted based on the customer's environment.",
      "entity": {
          "entityType": "_ip",
          "hostname": null,
          "id": "_ip-172.30.202.30",
          "macAddress": null,
          "name": "172.30.202.30",
          "sensorZone": "",
          "value": "172.30.202.30"
      },
      "id": "dbc30c20-6d99-4f6f-8580-157ce70368a5",
      "lastUpdated": "2022-03-23T11:04:33.740470",
      "lastUpdatedBy": null,
      "name": "Initial Access",
      "orgId": "siemplify",
      "readableId": "INSIGHT-13927",
      "recordSummaryFields": [],
      "resolution": "False Positive",
      "severity": "CRITICAL",
      "signals": [
          {
              "allRecords": [
                  {
                      "action": "failed password attempt",
                      "bro_dns_answers": [],
                      "bro_file_bytes": {},
                      "bro_file_connUids": [],
                      "bro_flow_service": [],
                      "bro_ftp_pendingCommands": [],
                      "bro_http_cookieVars": [],
                      "bro_http_origFuids": [],
                      "bro_http_origMimeTypes": [],
                      "bro_http_request_headers": {},
                      "bro_http_request_proxied": [],
                      "bro_http_response_headers": {},
                      "bro_http_response_respFuids": [],
                      "bro_http_response_respMimeTypes": [],
                      "bro_http_tags": [],
                      "bro_http_uriVars": [],
                      "bro_kerberos_clientCert": {},
                      "bro_kerberos_serverCert": {},
                      "bro_sip_headers": {},
                      "bro_sip_requestPath": [],
                      "bro_sip_responsePath": [],
                      "bro_ssl_certChainFuids": [],
                      "bro_ssl_clientCertChainFuids": [],
                      "cseSignal": {},
                      "day": 11,
                      "device_ip": "172.30.202.30",
                      "device_ip_ipv4IntValue": 2887698974,
                      "device_ip_isInternal": true,
                      "device_ip_version": 4,
                      "fieldTags": {},
                      "fields": {
                          "auth_method": "ssh2",
                          "endpoint_ip": "172.30.202.30",
                          "endpoint_username": "1ewk0XJn",
                          "event_message": "Failed password for invalid user",
                          "src_port": "59088"
                      },
                      "friendlyName": "record",
                      "hour": 8,
                      "http_requestHeaders": {},
                      "listMatches": [],
                      "matchedItems": [],
                      "metadata_deviceEventId": "citrix_xenserver_auth_message",
                      "metadata_mapperName": "Citrix Xenserver Auth Message",
                      "metadata_mapperUid": "bcc62402-2870-49ad-ba8d-64ddf22fd342",
                      "metadata_parseTime": 1646987453926,
                      "metadata_product": "Hypervisor",
                      "metadata_productGuid": "6751ee25-4ef9-4f9f-9c8b-c39668856994",
                      "metadata_receiptTime": 1646987443,
                      "metadata_relayHostname": "centos-002",
                      "metadata_schemaVersion": 3,
                      "metadata_sensorId": "0b52e838-2dbd-4fc0-a2b5-7135a5dc72b7",
                      "metadata_sensorInformation": {},
                      "metadata_sensorZone": "default",
                      "metadata_vendor": "Citrix",
                      "month": 3,
                      "normalizedAction": "logon",
                      "objectType": "Authentication",
                      "srcDevice_ip": "172.30.202.30",
                      "srcDevice_ip_ipv4IntValue": 2887698974,
                      "srcDevice_ip_isInternal": true,
                      "srcDevice_ip_version": 4,
                      "success": false,
                      "timestamp": 1646987443000,
                      "uid": "c2e6188b-202c-5736-9b4d-248ab6ba88dd",
                      "user_username": "1ewk0XJn",
                      "user_username_raw": "1ewk0XJn",
                      "year": 2022
                  }
              ],
              "artifacts": [],
              "contentType": "ANOMALY",
              "description": "Detects multiple failed login attempts from a single source with unique usernames over a 24 hour timeframe. This is designed to catch both slow and quick password spray type attacks. The threshold and time frame can be adjusted based on the customer's environment.",
              "id": "b4adb0dc-1340-56ec-87aa-c6f1fc0fa247",
              "name": "Password Attack",
              "recordCount": 10,
              "recordTypes": [],
              "ruleId": "THRESHOLD-S00095",
              "severity": 4,
              "stage": "Initial Access",
              "tags": [
                  "_mitreAttackTactic:TA0001"
              ],
              "timestamp": "2022-03-11T08:31:28"
          }
      ],
      "source": "USER",
      "status": {
          "displayName": "Closed",
          "name": "closed"
      },
      "subResolution": null,
      "tags": [
          "aaa3"
      ],
      "teamAssignedTo": null,
      "timeToDetection": 1271.030204,
      "timeToRemediation": 1044967.701767,
      "timeToResponse": 21.186055,
      "timestamp": "2022-03-11T08:31:28"
  }
Case wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם קוד הסטטוס 200 מדווח (is_success=true): "Successfully updated workbench alert with ID "{id}" in Trend Micro Vision One."

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

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

אם השגיאה מדווחת בתגובה: "שגיאה בהפעלת הפעולה 'עדכון התראה של Workbench'". הסיבה: {message}.'"

כללי

מחברים

Trend Micro Vision One - Workbench Alerts Connector

תיאור המחבר

שליפת מידע על התראות של סביבת העבודה מ-Trend Micro Vision One.

הגדרת המחבר

הוראות ליצירה ולהגדרה של המחבר ב-Chronicle SOAR מופיעות במאמר הגדרת המחבר.

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

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

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

מתאר את שם השדה שבו מאוחסן שם הסביבה.

אם לא נמצא שדה סביבה, הסביבה היא סביבת ברירת המחדל.

תבנית ביטוי רגולרי (regex) של סביבה String .* לא

תבנית regex להפעלה על הערך שנמצא בשדה Environment Field Name (שם שדה הסביבה).

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

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

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

זמן קצוב לסקריפט (בשניות) מספר שלם 180 כן מגבלת הזמן הקצוב לתהליך Python שמריץ את הסקריפט הנוכחי.
ספריית הבסיס של ה-API String https://{instance} כן נתיב הבסיס של ה-API של מופע Trend Micro Vision One.
טוקן API String כן מפתח ה-API של חשבון Trend Micro Vision One.
רמת החומרה הנמוכה ביותר לאחזור String לא רלוונטי לא

רמת החומרה הכי נמוכה שצריך להשתמש בה כדי לאחזר התראות.

הערכים האפשריים: נמוך, בינוני, גבוה, קריטי.

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

מספר השעות המקסימלי אחורה מספר שלם 1 לא מספר השעות שממנו יאוחזרו ההתראות.
מספר ההתראות המקסימלי לאחזור מספר שלם 10 לא מספר ההתראות לעיבוד בכל איטרציה של המחבר.
שימוש ברשימה דינמית כרשימת חסימה תיבת סימון התיבה לא מסומנת כן אם האפשרות הזו מופעלת, המערכת משתמשת ברשימות דינמיות כרשימת חסימה.
אימות SSL תיבת סימון סימן אישור לא אם ההגדרה מופעלת, האינטגרציה בודקת שאישור ה-SSL של החיבור לשרת Trend Micro Vision One תקף.
כתובת שרת ה-Proxy String לא רלוונטי לא הכתובת של שרת ה-Proxy שבו רוצים להשתמש.
שם משתמש של שרת proxy String לא רלוונטי לא שם המשתמש ב-proxy לאימות.
סיסמת שרת Proxy סיסמה לא רלוונטי לא סיסמת ה-proxy לאימות.

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