איסוף יומני Vercel WAF
במאמר הזה מוסבר איך להטמיע יומני Vercel WAF ב-Google Security Operations באמצעות Google Cloud Storage V2.
Vercel WAF היא חומת אש ליישומי אינטרנט שמשולבת ברשת הקצה של Vercel כדי להגן על אפליקציות ללא שרת (serverless). הוא בודק בקשות HTTP נכנסות בקצה ומחיל כללי אבטחה כדי לחסום תנועה זדונית לפני שהיא מגיעה לאפליקציה. כדי לייצא את היומנים של Vercel WAF מפלטפורמת Vercel, צריך להעלות אותם לקטגוריה של Google Cloud Storage (GCS) ואז להגדיר פיד של Google SecOps כדי להטמיע אותם.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- פרויקט ב-Google Cloud שהחיוב מופעל בו
- חשבון Vercel עם גישה ליומני WAF (תוכנית Pro או Enterprise)
- טוקן API של Vercel או Log Drain שמוגדר לייצא יומני WAF
יצירת קטגוריה של Google Cloud Storage
- נכנסים למסוף Google Cloud.
- בוחרים את הפרויקט או יוצרים פרויקט חדש.
- בתפריט הניווט, נכנסים ל-Cloud Storage > Buckets.
- לוחצים על Create bucket.
ממלאים את פרטי ההגדרה הבאים:
הגדרה ערך Name your bucket מזינים שם ייחודי ברמה גלובלית (לדוגמה, vercel-waf-logs)סוג המיקום בוחרים לפי הצרכים (אזור, שני אזורים, מספר אזורים) Location בוחרים את המיקום הכי קרוב למכונת Google SecOps (לדוגמה, us-central1)סוג אחסון (storage class) רגיל (מומלץ ליומנים שהגישה אליהם תכופה) בקרת גישה אחידה (מומלץ) כלי הגנה אופציונלי: הפעלת ניהול גרסאות של אובייקטים או מדיניות שמירת נתונים לוחצים על יצירה.
ייצוא של יומני Vercel WAF ל-GCS
Vercel מספקת יומני WAF דרך Log Drains ו-Vercel API בארכיטקטורת REST. מגדירים ייצוא של יומנים ואז מעלים אותם ל-GCS.
אפשרות א': הגדרת Vercel Log Drains (מומלץ)
התכונה Vercel Log Drains מעבירה בסטרימינג יומנים בזמן אמת לנקודת קצה חיצונית.
- נכנסים אל מרכז הבקרה של Vercel.
- עוברים להגדרות הצוות: הגדרות > Log Drains.
- לוחצים על Add Log Drain.
- מגדירים את ניקוז היומנים:
- פורמט מסירה: בוחרים באפשרות JSON.
- מקורות: בוחרים באפשרות חומת אש כדי לכלול אירועי WAF.
- סביבות: בוחרים את הסביבות למעקב (ייצור, תצוגה מקדימה, פיתוח).
- נקודת קצה (endpoint): מזינים את כתובת ה-URL של המקלט המתווך (לדוגמה, נקודת קצה של פונקציית Cloud Run שכותבת ל-GCS).
- לוחצים על Add Log Drain.
מוודאים שהיומנים נשלחים לנקודת הקצה.
אפשרות ב': ייצוא באמצעות Vercel REST API
- יוצרים אסימון API של Vercel בקטע Settings > Tokens (הגדרות > אסימונים).
משתמשים ב-Vercel API בארכיטקטורת REST כדי לאחזר אירועי חומת אש:
curl -H "Authorization: Bearer YOUR_VERCEL_TOKEN" \ "https://api.vercel.com/v1/security/firewall/events?teamId=YOUR_TEAM_ID&projectId=YOUR_PROJECT_ID&limit=100" \ -o vercel-waf-events.json
אחזור של חשבון השירות של Google SecOps
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Vercel WAF Logs). - בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות Vercel WAF בתור Log type.
לוחצים על Get Service Account (קבלת חשבון שירות). תוצג כתובת אימייל ייחודית של חשבון שירות, לדוגמה:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comמעתיקים את כתובת האימייל הזו כדי להשתמש בה בשלב הבא.
מתן הרשאות IAM לחשבון השירות של Google SecOps
לחשבון השירות של Google SecOps צריך להיות התפקיד צפייה באובייקט אחסון בקטגוריה של GCS.
- נכנסים לדף Cloud Storage > Buckets.
- לוחצים על שם הקטגוריה (לדוגמה,
vercel-waf-logs). - עוברים לכרטיסייה Permissions.
- לוחצים על הענקת גישה.
- מזינים את פרטי ההגדרה הבאים:
- הוספת חשבונות משתמשים: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps (לדוגמה,
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com). - הקצאת תפקידים: בוחרים באפשרות צפייה באובייקטים באחסון.
- הוספת חשבונות משתמשים: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps (לדוגמה,
לוחצים על Save.
הגדרת הפיד של Google SecOps
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Vercel WAF Logs). - בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות Vercel WAF בתור Log type.
- לוחצים על הבא.
מציינים ערכים לפרמטרים הבאים של הקלט:
כתובת ה-URL של קטגוריית האחסון: מזינים את ה-URI של קטגוריית ה-GCS:
gs://vercel-waf-logs/vercel-waf/- מחליפים את
vercel-waf-logsבשם של קטגוריית GCS. - מחליפים את
vercel-wafבנתיב הקידומת שהגדרתם.
- מחליפים את
אפשרות מחיקת המקור: בוחרים את אפשרות המחיקה המועדפת:
- Never: אף פעם לא למחוק קבצים אחרי העברות (מומלץ לבדיקה).
מחיקת קבצים שהועברו וספריות ריקות: מחיקת קבצים וספריות ריקות אחרי שההעברה מסתיימת.
גיל הקובץ המקסימלי: כולל קבצים ששונו במספר הימים האחרונים (ברירת המחדל היא 180 ימים).
מרחב השמות של הנכס: מרחב השמות של הנכס.
תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
לוחצים על הבא.
בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| record.requestId, record.proxy.timestamp, record.proxy.region, record.proxy.errorCode, record.proxy.vercelCache, record.proxy.pathType, record.proxy.referer, record.proxy.cacheId, record.proxy.wafAction, record.proxy.scheme, record.proxy.userAgent, record.environment | additional.fields | מטא-נתונים נוספים של אירועים |
| metadata.event_type | סוג האירוע | |
| record.deploymentId | metadata.product_deployment_id | מזהה פריסה ספציפי למוצר |
| record.id | metadata.product_log_id | מזהה יומן ספציפי למוצר |
| record.proxy.method | network.http.method | שיטת HTTP |
| record.statusCode | network.http.response_code | קוד תגובת HTTP |
| record.source | principal.asset.hostname | שם המארח של הנכס שמשויך לחשבון הראשי |
| record.host | principal.hostname | שם המארח של הישות המורשית |
| record.message | security_result.description | תיאור של תוצאת האבטחה |
| record.proxy.wafRule | security_result.rule_name | שם הכלל שהפעיל את תוצאת האבטחה |
| record.level | security_result.severity | חומרת תוצאת האבטחה |
| record.proxy.wafRule | security_result.threat_name | שם האיום |
| record.proxy.clientIp | target.asset.ip | כתובת ה-IP של הנכס |
| record.projectId | target.cloud.project.id | מזהה הפרויקט בענן |
| record.projectName | target.cloud.project.name | שם הפרויקט בענן |
| record.proxy.path | target.file.full_path | הנתיב המלא של הקובץ |
| record.proxy.clientIp | target.ip | כתובת ה-IP של היעד |
| record.executionRegion | target.location.name | שם המיקום |
| record.proxy.vercelId | target.user.userid | מזהה המשתמש של משתמש היעד |
| metadata.product_name | שם המוצר | |
| metadata.vendor_name | שם הספק |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.