Cisco ISE

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

הגדרת Cisco ISE לעבודה עם Google Security Operations

כדי להפעיל שירותי RESTful חיצוניים (ERS) וליצור חשבון שירות של Cisco ISE לשימוש בחיבור ל-API, אפשר לעיין במסמכי התיעוד של Cisco ISE. לפעמים צריך קודם להיכנס לממשק המשתמש של Cisco ISE באמצעות חשבון השירות, ואז שילוב ה-API או Google SecOps מתחיל לפעול בצורה תקינה באמצעות אותם פרטי כניסה שגרמו לכשל קודם.

הגדרת שילוב של Cisco ISE ב-Google SecOps

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

פעולות

Enrich Endpoint

תיאור

העשרת נקודת הקצה באמצעות נתונים מ-Cisco ISE.

פרמטרים

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

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

תיאור

קבלת נתוני נקודות קצה מנקודות הקצה שמנוהלות על ידי Cisco ISE.

פרמטרים

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

קבלת סשנים

תיאור

קבלת רשימה של סשנים פעילים.

פרמטרים

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

פינג

תיאור

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

פרמטרים

לא רלוונטי

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

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

כתובת ההסגר

תיאור

הסגרת נקודת קצה לפי כתובת MAC.

פרמטרים

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

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

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

סיום הסשן

תיאור

התנתקות מהסשן באמצעות קריאה ל-API.

פרמטרים

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

השם של שרת הצומת של ISE.

דוגמה: ciscoISE

מזהה התחנה של המתקשר String לא רלוונטי כן

ערך המזהה של תחנת השיחה.

דוגמה: 1

סוג הסיום String לא רלוונטי לא

הערך של Terminate Type (סוג סיום) הוא מספר שלם בין 0 ל-2.

דוגמה: 0

ערכים אפשריים:

  • 0=DYNAMIC_AUTHZ_PORT_DEFAULT
  • 1=DYNAMIC_AUTHZ_PORT_BOUNCE
  • 2=DYNAMIC_AUTHZ_PORT_SHUTDOWN

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

ביטול ההסגר של כתובת

תיאור

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

פרמטרים

לא רלוונטי

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

עדכון נקודת הקצה

תיאור

עדכון אובייקט של נקודת קצה.

פרמטרים

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

מאפיינים מותאמים אישית מתווספים לאובייקט הישות.

דוגמה: {'param':'val'}

שם שרת ה-MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
הגישה ל-MDM אפשרית String לא רלוונטי לא המאפיין של נקודת הקצה שצריך לעדכן, למשל true או false.
ההרשמה ל-MDM String לא רלוונטי לא המאפיין של נקודת הקצה שצריך לעדכן, למשל true או false.
סטטוס התאימות של MDM String לא רלוונטי לא המאפיין של נקודת הקצה שצריך לעדכן, למשל true או false.
MDM OS String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
יצרן MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
מודל MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
מוצפן באמצעות MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
MDM Pinlock String לא רלוונטי לא המאפיין של נקודת הקצה שצריך לעדכן, למשל true או false.
MDM Jail Broken String לא רלוונטי לא המאפיין של נקודת הקצה שצריך לעדכן, למשל true או false.
מספר IMEI של MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.
מספר טלפון של MDM String לא רלוונטי לא המאפיין של נקודת הקצה שרוצים לעדכן.

ריצה

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

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

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

לא רלוונטי

תובנות

לא רלוונטי

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

תיאור

רשימת קבוצות הישויות של נקודות הקצה שזמינות ב-Cisco ISE.

פרמטרים

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

יש לבחור טווח

ערכים אפשריים:

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

לא צוינה

ערכים אפשריים:

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

מציינים את הערך שבו רוצים להשתמש במסנן.

אם נבחרה האפשרות 'שווה ל', הפעולה תנסה למצוא את ההתאמה המדויקת בין התוצאות.

אם האפשרות 'מכיל' נבחרה, הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה שצוינה.

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

מספר הרשומות המקסימלי שיוחזר מספר שלם 100 לא

מציינים את מספר הרשומות שיוחזרו. אם לא מציינים כלום, הפעולה תחזיר 100 רשומות.

מקסימום: 100

ריצה

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

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

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[
    {
        "id": "73d1a120-ab0f-11ec-ae96-76398204b317",
        "name": "Windows11-Workstation",
        "description": "Identity Group for Profile: Windows11-Workstation",
    {
        "id": "21fa0600-f947-11eb-953e-0050568fa723",
        "name": "OS_X_BigSur-Workstation",
        "description": "Identity Group for Profile: OS_X_BigSur-Workstation",
    },
    {
        "id": "3b76f840-8c00-11e6-996c-525400b48521",
        "name": "Workstation",
        "description": "Identity Group for Profile: Workstation",
    }
]
העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

Case Wall
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

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

אם הנתונים זמינים (is_success=true): 'Successfully found endpoint entity groups for the provided criteria in Cisco ISE.'

אם הנתונים לא זמינים (is_success=false): "לא נמצאו קבוצות ישויות של נקודות קצה לפי הקריטריונים שצוינו ב-Cisco ISE".

אם הפרמטר Filter Value ריק (is_success=true):

"המסנן לא הוחל כי הפרמטר 'ערך המסנן' ריק".



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

אם הפרמטר Filter Key (מפתח מסנן) מוגדר לערך Select One (בחירת אפשרות אחת) והפרמטר Filter Logic (לוגיקת סינון) מוגדר לערך Equal (שווה) או Contains (מכיל):

‫"Error executing action "List Endpoint Identity Group". הסיבה: צריך לבחור שדה מהפרמטר Filter Key (מפתח מסנן).

אם מספקים ערך לא תקין לפרמטר 'מספר הרשומות המקסימלי להחזרה':

‫"Error executing action "List Endpoint Identity Group". סיבה: צוין ערך לא חוקי עבור 'מספר הרשומות המקסימלי להחזרה': . צריך לציין מספר חיובי".

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

‫"Error executing action "List Endpoint Identity Group". הסיבה: {0}''.format(error.Stacktrace)

כללי
Case Wall Table

שם הטבלה: קבוצות ישויות של נקודות קצה זמינות

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

  • שם – שם
  • תיאור – description
כללי

הוספת נקודת קצה לקבוצת זהויות של נקודות קצה

תיאור

מוסיפים נקודת קצה לקבוצת הזהויות של נקודות הקצה ב-Cisco ISE.

פרמטרים

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

ריצה

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

  • כתובת IP
  • כתובת MAC

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

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "UpdatedFieldsList": {
        "updatedField": [
            {
                "field": "groupId",
                "oldValue": "73d1a120-ab0f-11ec-ae96-76398204b317",
                "newValue": "3b76f840-8c00-11e6-996c-525400b48521"
            }
        ]
    }
}
העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

Case Wall
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

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

אם יש נתונים עבור ישות אחת (is_success=true): "Successfully added the following endpoints to the "{group name}" Endpoint Identity Group in Cisco ISE: {entity.identifier}".

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

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

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

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

אם הקבוצה לא נמצאה: "שגיאה בהרצת הפעולה {שם הפעולה}". סיבה: קבוצת הזהויות של נקודת הקצה '{שם הקבוצה}' לא נמצאה ב-Cisco ISE. כדאי לבדוק את האיות".

כללי

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