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

שילוב של Axonius עם Google SecOps

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

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

ביצוע פעולות להעשרת הנתונים.

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

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

השם המוצג של הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
ספריית הבסיס של ה-API	String	https://{root}	כן	Axonius API root
מפתח API	String	לא רלוונטי	כן	מפתח API של Axonius
API Secret	סיסמה	לא רלוונטי	כן	‫Axonius API Secret
אימות SSL	תיבת סימון	סימן אישור	כן	אם האפשרות הזו נבחרה, האינטגרציה מאמתת את אישור ה-SSL כשהיא מתחברת לשרת Axonius.

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

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

פעולות

מידע נוסף על פעולות זמין במאמרים איך מגיבים לפעולות שממתינות לאישור ב-Your Workdesk ואיך מבצעים פעולה ידנית.

פינג

בודקים את הקישוריות ל-Axonius.

ריצה

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

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

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך
is_success	is_success=False
is_success	is_success=True

Case Wall

סוג התוצאה	ערך / תיאור	סוג
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: אם הפעולה הצליחה: "Successfully connected to the Axonius server with the provided connection parameters!" (החיבור לשרת Axonius בוצע בהצלחה עם פרמטרי החיבור שסופקו). הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם הפעולה נכשלה: "החיבור לשרת Axonius נכשל! השגיאה היא {0}".format(exception.stacktrace)	כללי

סוג התוצאה

ערך / תיאור

סוג

הודעת פלט*

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

אם הפעולה הצליחה: "Successfully connected to the Axonius server with the provided connection parameters!" (החיבור לשרת Axonius בוצע בהצלחה עם פרמטרי החיבור שסופקו).

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

אם הפעולה נכשלה: "החיבור לשרת Axonius נכשל! השגיאה היא {0}".format(exception.stacktrace)

כללי

העשרת ישויות

העשרת ישויות באמצעות מידע מ-Axonius. הישויות הנתמכות כוללות את שם המארח, כתובת ה-IP, כתובת ה-MAC, המשתמש וכתובות האימייל (ישויות משתמש שתואמות לביטוי רגולרי של אימייל).

פרמטרים

השם המוצג של הפרמטר	סוג	ערך ברירת המחדל	חובה	תיאור
יצירת תובנה לגבי נקודת קצה	תיבת סימון	נכון	לא	אם האפשרות הזו מופעלת, הפעולה תיצור תובנה שמכילה מידע על נקודות הקצה.
יצירת תובנה לגבי משתמש	תיבת סימון	נכון	לא	אם האפשרות הזו מופעלת, הפעולה תיצור תובנה שמכילה מידע על המשתמש.
המספר המקסימלי של הערות להחזרה	מספר שלם	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
hostname	כשהנתונים זמינים בפורמט 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

Case Wall

סוג התוצאות	ערך/תיאור	סוג (ישות \ כללי)
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: ‫If enriched some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier) אם לא בוצע обогащение של חלק מהישויות (is_success = true): "לא הייתה אפשרות לבצע обогащение של הישויות הבאות באמצעות Axonius:\n".format(entity.identifier) אם לא בוצע обогащение לכל הישויות (is_success = false): "לא בוצע обогащение לאף ישות". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'הוספת פרטים לישויות'. הסיבה: {0}''.format(error.Stacktrace)	כללי
טבלת ישויות		ישות
Case Wall Table (אם יש ערכים במאפיינים/בנתונים/ברשימת הנתונים)	Name: {entity.identifier}: Notes עמודה: שם משתמש נתונים שעה	כללי

סוג התוצאות

ערך/תיאור

סוג (ישות \ כללי)

הודעת פלט*

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

‫If enriched some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier)

אם לא בוצע обогащение של חלק מהישויות (is_success = true): "לא הייתה אפשרות לבצע обогащение של הישויות הבאות באמצעות Axonius:\n".format(entity.identifier)

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

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

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

כללי

טבלת ישויות

ישות

Case Wall Table

(אם יש ערכים במאפיינים/בנתונים/ברשימת הנתונים)

Name: {entity.identifier}: Notes

עמודה:

שם משתמש
נתונים
שעה

כללי

הוספת הערה

הוספת הערה לישויות ב-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"
    }
}

Case Wall

סוג התוצאות	ערך/תיאור	סוג (ישות \ כללי)
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: If at least success for one(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities) If at least fail for one(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities) אם הפעולה נכשלת עבור כל הישויות (is_success = false): "ההערה לא נוספה לישויות שצוינו". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מופיעה שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת, אחר: "Error executing action "Add Note". הסיבה: {0}''.format(error.Stacktrace)	כללי

סוג התוצאות

ערך/תיאור

סוג (ישות \ כללי)

הודעת פלט*

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

If at least success for one(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities)

If at least fail for one(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities)

אם הפעולה נכשלת עבור כל הישויות (is_success = false): "ההערה לא נוספה לישויות שצוינו".

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

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

כללי

הוספת תגים

מוסיפים תגים לישויות ב-Axonius. הישויות הנתמכות: שם מארח, כתובת IP, כתובת MAC, משתמש, כתובות אימייל (ישויות משתמש שתואמות לביטוי רגולרי של אימייל).

פרמטרים

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

ריצה

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

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

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

תוצאת סקריפט

שם התוצאה של הסקריפט	אפשרויות ערך
is_success	is_success=False
is_success	is_success=True

Case Wall

סוג התוצאות	ערך/תיאור	סוג (ישות \ כללי)
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: If at least success for one(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities) אם לפחות אחד נכשל(is_success = true): "לא הייתה אפשרות להוסיף תגים לישויות הבאות ב-Axonius: {0}".format(entities) אם הפעולה נכשלת עבור כל הישויות (is_success = false): "התגים לא נוספו לישויות שצוינו". הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה: אם מדווחת שגיאה קריטית, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת: "שגיאה בהפעלת הפעולה 'הוספת תגים'. הסיבה: {0}''.format(error.Stacktrace)	כללי

סוג התוצאות

ערך/תיאור

סוג (ישות \ כללי)

הודעת פלט*

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

If at least success for one(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities)

אם לפחות אחד נכשל(is_success = true): "לא הייתה אפשרות להוסיף תגים לישויות הבאות ב-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

Case Wall

סוג התוצאות	ערך/תיאור	סוג (ישות \ כללי)
הודעת פלט*	הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה: If at least success for one(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)	כללי

סוג התוצאות

ערך/תיאור

סוג (ישות \ כללי)

הודעת פלט*

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

If at least success for one(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.