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.