איסוף יומנים של IONIX ניהול שטחי מתקפה
במאמר הזה מוסבר איך להגדיר את IONIX Attack Surface Management כדי לשלוח יומנים ל-Google Security Operations באמצעות תגובות לפעילות אינטרנט.
IONIX היא פלטפורמה לניהול שטחי מתקפה חיצוניים (EASM) שמזהה, מעריכה ומאמתת חשיפות אבטחה בנכסים של הארגון שגלויים באינטרנט ובשרשרת האספקה הדיגיטלית. IONIX מספקת פעולות לביצוע לממצאי DNS, בעיות ב-PKI, חשיפות בענן ונקודות חולשה, ומספקת תהליכי עבודה לתיקון שגיאות לפי סדר עדיפויות.
לפני שמתחילים
ודאו שאתם עומדים בדרישות המוקדמות הבאות:
- מכונה של Google SecOps
- IONIX Attack Surface Management תומך בדחיפת HTTP POST למשלוח יומנים
- גישה למסוף Google Cloud (כדי ליצור מפתח API)
- חשבון פעיל בפורטל IONIX עם הרשאת אדמין להגדרות > שילובים
יצירת פיד של תגובה לפעולה מאתר אחר (webhook) ב-Google SecOps
יצירת הפיד
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
IONIX ASM Logs). - בקטע Source type, בוחרים באפשרות Webhook.
- בוחרים באפשרות IONIX בתור Log type.
- לוחצים על הבא.
- מציינים ערכים לפרמטרים הבאים של הקלט:
- תו מפריד לפיצול (אופציונלי): מזינים תו מפריד כדי לפצל אירועים עם כמה שורות. ערכים נפוצים:
-
\n– תו מפריד של שורה חדשה (הכי נפוץ ב-NDJSON) - אם כל בקשה מכילה אירוע אחד, אפשר להשאיר את השדה ריק
-
- מרחב השמות של הנכס: מרחב השמות של הנכס
- תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה
- תו מפריד לפיצול (אופציונלי): מזינים תו מפריד כדי לפצל אירועים עם כמה שורות. ערכים נפוצים:
- לוחצים על הבא.
- בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
יצירה ושמירה של מפתח סודי
אחרי שיוצרים את הפיד, צריך ליצור מפתח סודי לאימות:
- בדף הפרטים של הפיד, לוחצים על יצירת מפתח סודי.
- תיפתח תיבת דו-שיח עם המפתח הסודי.
- מעתיקים ושומרים את המפתח הסודי באופן מאובטח.
איך מקבלים את כתובת ה-URL של נקודת הקצה של הפיד
- עוברים לכרטיסייה פרטים של הפיד.
- בקטע Endpoint Information, מעתיקים את Feed endpoint URL.
הפורמט של כתובת ה-URL הוא:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importכאשר
{region}הוא האזור של המופע של Google SecOps (לדוגמה,us,europeאוasia-southeast1), ו-{parent}הוא נתיב המשאב בפורמטprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.שומרים את כתובת ה-URL הזו לשלבים הבאים.
לוחצים על סיום.
יצירת Google Cloud מפתח API
כדי לבצע אימות ב-Google SecOps, צריך מפתח API. יוצרים מפתח API מוגבל במסוף Google Cloud .
יצירת מפתח ה-API
- נכנסים לדף Credentials במסוףGoogle Cloud .
- בוחרים את הפרויקט (הפרויקט שמשויך למכונה של Google SecOps).
- לוחצים על Create credentials > מפתח API.
- מפתח ה-API נוצר ומוצג בתיבת דו-שיח.
- לוחצים על Edit API key כדי להגביל את מפתח ה-API.
הגבלת מפתח ה-API
- בדף ההגדרות של מפתח ה-API:
- שם: מזינים שם תיאורי (לדוגמה,
Google SecOps Webhook API Key)
- שם: מזינים שם תיאורי (לדוגמה,
- בקטע API restrictions:
- לוחצים על הגבלת המפתח.
- בתפריט הנפתח Select APIs, מחפשים ובוחרים את Google SecOps API (או Chronicle API).
- לוחצים על Save.
- מעתיקים את הערך של מפתח ה-API מהשדה API key שבחלק העליון של הדף.
- שומרים את מפתח ה-API בצורה מאובטחת.
הגדרת ה-webhook של IONIX ניהול שטחי מתקפה
מערכת IONIX תומכת באופן מובנה בדחיפה של נתוני אירועי אבטחה לנקודות קצה חיצוניות באמצעות HTTP POST, בעזרת מסגרת השילוב שלה. השילוב מוגדר בפורטל של IONIX ומשתמש באותו מנגנון כמו השילוב של Splunk HEC, שמותאם לדחיפת נתונים לנקודת הקצה של ה-webhook ב-Google SecOps.
יצירת כתובת ה-URL של ה-webhook
משלבים את כתובת ה-URL של נקודת הקצה (endpoint) ואת מפתח ה-API של Google SecOps לכתובת URL אחת:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>לדוגמה:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
הגדרת השילוב בפורטל של IONIX
- נכנסים לפורטל IONIX (לדוגמה,
https://<your-portal-name>.ionix.com). - עוברים אל הגדרות > שילובים.
- לוחצים על Splunk Integration (שילוב Splunk) > Settings (הגדרות).
ממלאים את פרטי ההגדרה הבאים:
- טוקן HEC: מזינים את המפתח הסודי שנוצר מהפיד של Google SecOps webhook.
שרת Splunk: מזינים את כתובת ה-URL המלאה של נקודת הקצה של ה-webhook ב-Google SecOps, עם מפתח ה-API שמצורף כפרמטר של שאילתה. צריך להשתמש בפורמט הבא:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=<API_KEY>
מגדירים את מרווח הזמן לשליחה כדי לקבוע באיזו תדירות IONIX תשלח נתונים לנקודת הקצה (לדוגמה, כל 60 דקות).
ממלאים את שדות הנתונים הנוספים שרלוונטיים לסביבה שלכם.
לוחצים על Save.
מפעילים את השילוב על ידי העברת המתג של השילוב למצב מופעל.
הנתונים יתחילו להופיע ב-Google SecOps בתוך מחזור אחד של מרווח זמן לשליחה. העברת הנתונים הראשונית עשויה להימשך עד שעה.
חלופה: שימוש ב-IONIX API בארכיטקטורת REST עם סקריפט בהתאמה אישית
אם השילוב המקורי של Splunk HEC לא עונה על הדרישות שלכם, אתם יכולים להשתמש ב-IONIX API בארכיטקטורת REST כדי לשלוף נתונים ולהעביר אותם ל-Google SecOps.
יצירת מפתח API של IONIX
- נכנסים לפורטל IONIX.
- לוחצים על הגדרות API.
- נותנים שם לטוקן.
- בוחרים את סוג הטוקן:
- לקריאה בלבד (מומלץ לאיסוף נתונים)
- קריאה-כתיבה
- מגדירים תאריך תפוגה לטוקן.
- לוחצים על Create Token.
- מעתיקים את הטוקן שנוצר ושומרים אותו במקום מאובטח.
נקודות קצה ל-API של IONIX
כדי לאחזר נתוני אבטחה מ-IONIX, משתמשים בנקודות הקצה הבאות ל-API:
| נקודת קצה (endpoint) | תיאור |
|---|---|
/api/v1/remediation/action-items/open/ |
פעולות פתוחות לביצוע (דומיינים, נקודת קצה בסיסית) |
/api/v1/remediation/action-items/all/detailed |
כל הפעולות לביצוע עם מידע מפורט |
/api/v1/discovery/org-assets/export-discovery-evidence |
סיכון לנכס והוכחות לגילוי |
/api/v1/discovery/org-assets |
נכסי הארגון (כולל התאריך first_seen) |
/api/v1/tests |
תוצאות של בדיקות אבטחה |
דוגמה לבקשת API
curl -X GET "https://api.portal.ionix.io/api/v1/remediation/action-items/all/detailed" \ -H "Authorization: Token <IONIX_API_KEY>" \ -H "Content-Type: application/json"
העברת נתונים ל-Google SecOps
אחרי שאחזרתם את הנתונים מ-IONIX API, העבירו אותם לנקודת הקצה של ה-webhook ב-Google SecOps:
curl -X POST "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>" \ -H "Content-Type: application/json" \ -d @ionix_events.json
מידע על שיטות אימות
פידים של Google SecOps webhook תומכים בכמה שיטות אימות. בוחרים את השיטה שבה הספק תומך.
שיטה 1: כותרות בהתאמה אישית (מומלץ)
אם הספק תומך בכותרות HTTP בהתאמה אישית, כדאי להשתמש בשיטה הזו כדי לשפר את האבטחה.
פורמט הבקשה:
POST <ENDPOINT_URL> HTTP/1.1 Content-Type: application/json x-goog-chronicle-auth: <API_KEY> x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
יתרונות:
- מפתח ה-API והסוד לא גלויים בכתובת ה-URL
- מאובטח יותר (הכותרות לא מתועדות ביומני הגישה של שרת האינטרנט)
- השיטה המועדפת כשהספק תומך בה
שיטה 2: פרמטרים של שאילתה
אם הספק לא תומך בכותרות בהתאמה אישית, צריך להוסיף את פרטי הכניסה לכתובת ה-URL.
פורמט כתובת ה-URL:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>- לדוגמה:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...פורמט הבקשה:
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
החסרונות:
- פרטי כניסה שגלויים בכתובת ה-URL
- יכול להיות שהם יתועדו ביומני הגישה של שרת האינטרנט
- פחות מאובטח מכותרות
שיטה 3: משולבת (כתובת URL + כותרת)
בחלק מההגדרות, מפתח ה-API נמצא בכתובת ה-URL והמפתח הסודי נמצא בכותרת.
פורמט הבקשה:
POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1 Content-Type: application/json x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
שמות של כותרות אימות
Google SecOps מקבל את שמות הכותרות הבאים לאימות:
למפתח API:
x-goog-chronicle-auth(מומלץ)X-Goog-Chronicle-Auth(לא תלוי-רישיות)
למפתח סודי:
x-chronicle-auth(מומלץ)X-Chronicle-Auth(לא תלוי-רישיות)
טבלת מיפוי UDM
כדי לקבל מידע על האופן שבו שדות היומן של IONIX ממופים לשדות של Unified Data Model (UDM) ב-Google Security Operations, חפשו את סוג היומן IONIX בחומר העזר בנושא מנתחי ברירת המחדל הנתמכים.
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.