לפני שתתחילו
נדרשים לכם:- הרשאה לנהל אינטגרציות ומפתחות גישה ב-Living Security
- שולח בצד השרת המסוגל לבצע בקשות HTTPS
POST - אזור Living Security של הארגון שלכם
- שם מקור קבוע ולפחות שם זרם אחד
1. רישום המקור והזרמים
1
פתיחת Custom Push Source
עברו אל הגדרות → שילובי → קטלוג, אתרו את Custom Push Source ובחרו הוסף.
2
מתן שם למקור
הזינו את מפתח הניתוב של המקור ותיאור אופציונלי. לדוגמה, השתמשו ב-
custom-phishing-sim ולא בשם תצוגה הכולל רווחים.3
הוספת זרמים
הוסיפו כל זרם שבו ישתמש השולח. זוג המקור והזרם חייב להתקיים לפני השליחה הראשונה; זוג לא מוכר מחזיר
404 Not Found.4
שמירת המקור
לאחר היצירה, פתחו את המקור תחת הגדרות → שילובי → מחובר. התצוגה Push via API מציגה את תבנית נקודת הקצה ואת ההרצות האחרונות.
2. יצירת מפתח Push Ingest
עברו אל הגדרות → Access Keys, בחרו Create Access Key ובחרו את ההיקף Push Ingest. העתיקו מיד את הערך שנוצר; הוא מוצג פעם אחת בלבד. המפתח קשור לארגון Living Security אחד. בקשת השליחה אינה דורשת כותרת ארגון. לפרטים על החלפה וביטול, ראו מפתחות גישה ל-API.3. בחירת נקודת הקצה האזורית
השתמשו בשם המארח המתאים לארגון ה-Living Security שלכם:
הוסיפו בסוף
/push-ingest/{integrationKey}/{streamName}. הנתיב רגיש לאותיות גדולות וקטנות ועליו להתאים במדויק למקור ולזרם הרשומים.
string
נדרש
שם המקור הרשום. השתמשו ב-1–64 תווים: אותיות לטיניות קטנות, ספרות או מקפים, כאשר התו הראשון הוא אות או ספרה.
string
נדרש
שם הזרם הרשום. חלים אותם כללים, וקווים תחתונים מותרים אף הם.
string
נדרש
שלחו את מפתח הגישה מסוג Push Ingest בתור
Bearer <access-key>.string
השתמשו ב-
application/json עבור JSON או ב-text/csv עבור CSV. השרת יכול גם לזהות מערך JSON כאשר כותרת זו מושמטת.string
UUID אופציונלי של ארגון. מפתח הגישה כבר קובע את הארגון. אם תשלחו כותרת זו, עליה להתאים לארגון של המפתח; אי אפשר להשתמש בה לבחירת ארגון אחר.
גוף הבקשה
שלחו מערך JSON ברמה העליונה, שאינו ריק ומכיל אובייקטים, או בתים של קובץ CSV עם שורת כותרת. אין שדה עוטף בשם כלשהו ב-JSON. כל אצווה יכולה להכיל עד 10,000 רשומות ו-10 MB.4. שליחת אצוות JSON
שלחו מערך JSON שאינו ריק, שרכיביו הם אובייקטים.Content-Type: application/json מומלץ, ונדרש על ידי מוצרי שליחה רבים, אף ש-Living Security יכולה לזהות גוף שהוא מערך גם בלעדיו.
202 Accepted. הכרטיסייה של השגיאה מציגה 400 Bad Request כאשר גוף ה-JSON פגום:
400, תקנו את ה-JSON או שלחו CSV עם Content-Type: text/csv, ולאחר מכן נסו שוב.
string
נדרש
מזהה ההרצה של האצווה שהתקבלה. שמרו אותו כדי לבדוק את סטטוס העיבוד.
number
נדרש
מספר הרשומות שהתקבלו ונשמרו.
string
נדרש
שם המקור ששימש לשליחה זו.
string
נדרש
שם הזרם ששימש לשליחה זו.
שליחת CSV במקום זאת
הגדירוContent-Type: text/csv ושלחו את בתי הקובץ, כפי שמוצג בדוגמת הבקשה CSV file שלמעלה. השורה הראשונה מספקת את שמות השדות.
טקסט בוליאני הופך לערך בוליאני, וטקסט מספרי רגיל הופך למספר. ערכים עם אפסים מובילים, מספרים שלמים גדולים שאינם בטוחים, תאריכים וטקסט אחר נשארים מחרוזות. תאים ריקים גורמים להשמטת השדה. שורות פגומות, מרכאות לא מאוזנות וקובצי UTF-16 נדחים.
מגבלות בקשה וניסיונות חוזרים
פצלו ייצואים גדולים יותר לאצוות העומדות בשתי המגבלות. המתינו לכל תגובה ושמרו ביומני השולח את
runId שהוחזר.
מגבלת הארגון הרגילה המאומתת מחזירה
503 ולא 429, ולכן שולחי webhook מתייחסים אליה כניתנת לניסיון חוזר. 503 מוחזר לפני שהאצווה נשמרת; שליחה חוזרת של אותה אצווה לאחר המרווח שצוין אינה יוצרת כפילות של הרצה שהתקבלה.
אימות זרימת הנתונים
פתחו את Custom Push Source ובדקו את Push History. ודאו את הזרם, מספר הרשומות, שיוך המפתח וסטטוס העיבוד. נתונים שיש להם מפענח מתוחזק יכולים להפוך לאנשים ולפעילות מנורמלת. נתונים ללא מפענח נשארים שמורים אך אינם מפיקים פעילות.השתמשו בשמות השדות המדויקים ובמבנה המטען מהמדריך הייעודי לספק, אם קיים כזה.
202 מוצלח מוכיח מסירה, ולא שסכמה שרירותית ממופה לפעילות ב-Living Security.רשימת בדיקות לפתרון בעיות
- העתיקו את נקודת הקצה מהמקור הנכון והחליפו את מציין המקום של הזרם.
- שלחו את מפתח הגישה בתור
Authorization: Bearer …;x-api-keyאינו מתקבל. - ודאו שהגוף הוא מערך JSON ברמה העליונה, ולא אובייקט יחיד או מעטפת סביב הרשומות.
- ודאו את האיות של המקור והזרם, כולל מקפים, קווים תחתונים ואותיות גדולות וקטנות.
- בדקו את Push History לפני שליחה חוזרת של אצווה שהתגובה אליה אבדה.
- בעת פנייה אל התמיכה של Living Security, צרפו את הארגון, המקור, הזרם, זמן הבקשה,
runIdכאשר הוא זמין, וסטטוס התגובה. אל תצרפו את מפתח הגישה או את מטען האירועים.
נושאים קשורים
Zscaler ZIA Cloud NSS
הגדירו הזנת יומני אינטרנט נתמכת של Zscaler עם המקור, הזרם, הכותרות ומבנה ה-JSON המדויקים.
מפתחות גישה ל-API
יצירה, החלפה וביטול של אישורי גישה בעלי היקף הרשאות מוגדר.
מקורות נתונים של אותות
למדו כיצד פעילות מפוענחת של אינטגרציות תומכת באותות.

