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