שילוב של Axonius עם Google SecOps
במאמר הזה מוסבר איך לשלב את Axonius עם Google Security Operations (Google SecOps).
תרחישים לדוגמה
לבצע פעולות העשרה.
פרמטרים של שילוב
כדי להגדיר את השילוב, משתמשים בפרמטרים הבאים:
| השם המוצג של הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| הרמה הבסיסית (root) של ה-API | String | https://{root} | כן | שורש ה-API של Axonius |
| מפתח API | String | לא רלוונטי | כן | מפתח API של Axonius |
| API Secret | סיסמה | לא רלוונטי | כן | סוד ה-API של Axonius |
| אימות SSL | תיבת סימון | סימן אישור | כן | אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Axonius. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. במאמר תמיכה במספר מופעים מוסבר איך להגדיר מספר מופעים ולתמוך בהם.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
פינג
בודקים את הקישוריות ל-Axonius.
ריצה
הפעולה לא פועלת על ישויות, ואין לה פרמטרים של קלט חובה.
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות ערך |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
קיר תיקים
| סוג התוצאות | ערך / תיאור | סוג |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם החיבור הצליח: "Successfully connected to the Axonius server with the provided connection parameters!" הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם החיבור נכשל: "החיבור לשרת Axonius נכשל! השגיאה היא {0}".format(exception.stacktrace) |
כללי |
העשרת ישויות
העשרת ישויות באמצעות מידע מ-Axonius. הישויות הנתמכות כוללות שם מארח, כתובת IP, כתובת MAC, משתמש וכתובות אימייל (ישויות משתמש שתואמות לביטוי הרגולרי של האימייל).
פרמטרים
| השם המוצג של הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| יצירת תובנה לגבי נקודת קצה (endpoint) | תיבת סימון | True | לא | אם המדיניות מופעלת, הפעולה תיצור תובנה שמכילה מידע על נקודות הקצה. |
| יצירת תובנה לגבי המשתמשים | תיבת סימון | True | לא | אם המדיניות מופעלת, הפעולה תיצור תובנה שמכילה מידע על המשתמש. |
| מספר ההערות המקסימלי להחזרה | מספר שלם | 50 | לא | מציינים כמה הערות יוצגו בטבלה של קיר הפנייה. |
ריצה
הפעולה הזו פועלת על הישויות הבאות:
- שם המארח
- כתובת IP
- כתובת MAC
- משתמש
- אימייל
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות ערך |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
תוצאת JSON – לנקודת קצה:
{
"adapters": [
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:44:19 GMT",
"client_used": "DOMAIN\\axoniusSvc",
"raw": {
"ad_distinguished_name": "CN=DESKTOP-ID,OU=Computers,DC=demo,DC=local",
"ad_object_class": [
"top",
"person",
"organizationalperson",
"user",
"computer"
],
"ad_sAMAccountName": "",
"ad_site_location": "Richmond",
"ad_site_name": "",
"device_disabled": false,
"device_managed_by": "Example User",
"domain": "example.example",
"hostname": "HOSTNAME",
"id": "CN=ID,OU=Computers,DC=demo,DC=local",
"last_seen": "Tue, 16 Mar 2021 19:44:05 GMT",
"name": "NAME",
"network_interfaces": [
{
"ips": [
"IP"
],
"ips_raw": [
"IP_RAW"
],
"ips_v4": [
"IP_V4"
],
"ips_v4_raw": [
"IP_V4_RAW"
]
}
],
"os": {
"bitness": 64,
"distribution": "10",
"is_windows_server": false,
"os_str": "windows 10 pro 64-bit",
"type": "Windows",
"type_distribution": "Windows 10"
},
"part_of_domain": true
},
"plugin_name": "",
"plugin_type": "Adapter",
"plugin_unique_name": "",
"quick_id": "active_directory_adapter_0!CN=ID,OU=OU,DC=DOMAIN,DC=DOMAIN",
"type": "entitydata"
},
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:43:52 GMT",
"client_used": "https://DOMAIN",
"raw": {
"hostname": "HOSTNAME",
"id": "ID",
"last_seen": "Sun, 21 Mar 2021 01:50:28 GMT",
"name": "NAME",
"network_id": "NETWORK_ID",
"network_interfaces": [
{
"ips": [
"IP"
],
"ips_raw": [
"IP_RAW"
],
"ips_v4": [
"IP_V4"
],
"ips_v4_raw": [
"IP_V4_RAW"
],
"mac": "01:23:45:AB:CD:EF",
"manufacturer": "(Intel Corporate)"
}
]
},
"plugin_name": "Example",
"plugin_type": "Adapter",
"plugin_unique_name": "Example",
"quick_id": "ID",
"type": "entitydata"
}
],
"Notes": [],
"internal_axon_id": "",
"labels": []
}
תוצאת JSON – למשתמשים:
{
"adapters": [
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:45:01 GMT",
"client_used": "DOMAIN\\axoniusSvc",
"raw": {
"account_disabled": false,
"ad_display_name": "",
"ad_distinguished_name": "CN=example, DC=example",
"ad_sid": "S-1-5-21-70119-3234025",
"ad_uac_dont_expire_password": false,
"ad_uac_password_not_required": false,
"display_name": "",
"domain": "example.example",
"employee_id": "ID",
"first_name": "Example",
"id": "CN=example, DC=example",
"is_admin": false,
"is_local": false,
"is_locked": false,
"last_name": "Example",
"last_password_change": "Wed, 17 Mar 2021 09:12:11 GMT",
"last_seen": "Thu, 18 Mar 2021 09:25:08 GMT",
"mail": "email@example.com",
"password_never_expires": false,
"password_not_required": false,
"user_city": "Boston",
"user_telephone_number": "(800) 555-0175",
"username": "user@example.com"
},
"user_city": "Boston",
"user_telephone_number": "(800) 555-0175",
"username": "user@example.com",
"plugin_name": "active_directory_adapter",
"plugin_type": "Adapter",
"plugin_unique_name": "active_directory_adapter_0",
"quick_id": "active_directory_adapter_0!CN=example,DC=example",
"type": "entitydata"
}
],
"Notes": [],
"internal_axon_id": "",
"labels": []
}
העשרת ישויות – לנקודות קצה:
| שם שדה ההעשרה | לוגיקה – מתי להחיל |
|---|---|
| object_classes | כשהוא זמין ב-JSON |
| site_name | כשהוא זמין ב-JSON |
| device_disabled | כשהוא זמין ב-JSON |
| device_managed_by | כשהוא זמין ב-JSON |
| שם המארח | כשהוא זמין ב-JSON |
| ad_distinguished_name | כשהוא זמין ב-JSON |
| asset_name | כשהוא זמין ב-JSON |
| ips | כשהוא זמין ב-JSON |
| os | כשהוא זמין ב-JSON |
| id | כשהוא זמין ב-JSON |
| קישור | כשהוא זמין ב-JSON |
העשרת ישויות – למשתמשים:
| שם שדה ההעשרה | לוגיקה – מתי להחיל |
|---|---|
| account_disabled | כשהוא זמין ב-JSON |
| ad_display_name | כשהוא זמין ב-JSON |
| ad_distinguished_name | כשהוא זמין ב-JSON |
| ad_sid | כשהוא זמין ב-JSON |
| employee_id | כשהוא זמין ב-JSON |
| is_admin | כשהוא זמין ב-JSON |
| is_local | כשהוא זמין ב-JSON |
| is_locked | כשהוא זמין ב-JSON |
| כתובת אימייל | כשהוא זמין ב-JSON |
| user_telephone_number | כשהוא זמין ב-JSON |
| id | כשהוא זמין ב-JSON |
| קישור | כשהוא זמין ב-JSON |
קיר תיקים
| סוג התוצאות | ערך/תיאור | סוג (ישות \ כללי) |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם חלק מהנתונים הועשרו(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier) אם חלק מהנתונים לא הועשרו (is_success = true): "Action wasn't able to enriche the following entities using Axonius:\n".format(entity.identifier) אם לא כל הישויות הועשרו (is_success = false): "No entities were enriched". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה "העשרת ישויות". הסיבה: {0}''.format(error.Stacktrace) |
כללי |
| טבלת ישויות | ישות | |
שולחן קיר עם ויטרינה (אם יש ערכים במאפיינים/נתונים/רשימת נתונים) |
שם: {entity.identifier}: הערות עמודה:
|
כללי |
הוספת הערה
הוספת הערה לישויות ב-Axonius. הישויות הנתמכות כוללות שם מארח, כתובת IP, כתובת MAC, משתמש וכתובות אימייל (ישויות משתמש שתואמות לביטוי הרגולרי של האימייל).
פרמטרים
| השם המוצג של הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| נתונים | String | לא רלוונטי | כן | ציינו איזו הערה צריך להוסיף. |
ריצה
הפעולה הזו פועלת על הישויות הבאות:
- שם המארח
- כתובת IP
- כתובת MAC
- משתמש
- כתובת אימייל
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות ערך |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
תוצאת JSON
{
"data": {
"attributes": {
"accurate_for_datetime": "2021-03-21T15:55:10.876568+00:00",
"note": "example",
"user_id": "",
"user_name": "internal/apiNAME",
"uuid": ""
},
"type": "notes_details_schema"
}
}
קיר תיקים
| סוג התוצאות | ערך/תיאור | סוג (ישות \ כללי) |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם לפחות אחת מהפעולות הצליחה(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities) אם לפחות אחד נכשל(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities) אם הפעולה נכשלה בכל הישויות (is_success = false): "ההערה לא נוספה לישויות שצוינו". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או משהו אחר: "שגיאה בביצוע הפעולה 'הוספת הערה'. הסיבה: {0}''.format(error.Stacktrace) |
כללי |
הוספת תגים
הוספת תגים לישויות ב-Axonius. ישויות נתמכות: שם מארח, כתובת IP, כתובת MAC, משתמש, כתובות אימייל (ישויות משתמש שתואמות לביטוי רגולרי של אימייל).
פרמטרים
| השם המוצג של הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| תגים | CSV | כן | צריך לציין רשימה מופרדת בפסיקים של תגים שצריך להוסיף לישויות. |
ריצה
הפעולה הזו פועלת על הישויות הבאות:
- שם המארח
- כתובת IP
- כתובת MAC
- משתמש
- כתובת אימייל
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות ערך |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
קיר תיקים
| סוג התוצאות | ערך/תיאור | סוג (ישות \ כללי) |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם לפחות אחת מהפעולות הצליחה(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities) אם לפחות אחד נכשל(is_success = true): "Action wasn't able to add tags to the following entities in Axonius: {0}".format(entities) אם הפעולה נכשלה בכל הישויות (is_success = false): "התגים לא נוספו לישויות שצוינו". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'הוספת תגים'. הסיבה: {0}''.format(error.Stacktrace) |
כללי |
הסרת תגים
הסרת תגים מישויות ב-Axonius. ישויות נתמכות: שם מארח, כתובת IP, כתובת MAC, משתמש, כתובות אימייל (ישויות משתמש שתואמות לביטוי הרגולרי של האימייל).
פרמטרים
| השם המוצג של הפרמטר | סוג | ערך ברירת המחדל | חובה | תיאור |
|---|---|---|---|---|
| תגים | CSV | כן | צריך לציין רשימה מופרדת בפסיקים של תגים שצריך להסיר מהישויות. |
ריצה
הפעולה הזו פועלת על הישויות הבאות:
- שם המארח
- כתובת IP
- כתובת MAC
- משתמש
- כתובת אימייל
תוצאות הפעולה
תוצאת הסקריפט
| שם תוצאת הסקריפט | אפשרויות ערך |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
קיר תיקים
| סוג התוצאות | ערך/תיאור | סוג (ישות \ כללי) |
|---|---|---|
| הודעת פלט* | הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של הפלייבוק: אם לפחות אחד הצליח(is_success = true): "Successfully removed tags from the following entities in Axonius: {0}".format(entities) if at least fail for one(is_success = true): "Action wasn't able to remove tags from the following entities in Axonius: {0}".format(entities) אם הפעולה נכשלה בכל הישויות (is_success = false): "התגים לא הוסרו מהישויות שצוינו". הפעולה אמורה להיכשל ולעצור את ההפעלה של הפלייבוק: אם מדווחת שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בביצוע הפעולה 'הסרת תגים'. הסיבה: {0}''.format(error.Stacktrace) |
כללי |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.