איסוף יומני 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

  1. נכנסים למסוף Google Cloud.
  2. בוחרים את הפרויקט או יוצרים פרויקט חדש.
  3. בתפריט הניווט, נכנסים ל-Cloud Storage > Buckets.
  4. לוחצים על Create bucket.
  5. ממלאים את פרטי ההגדרה הבאים:

    הגדרה ערך
    Name your bucket מזינים שם ייחודי ברמה גלובלית (לדוגמה, vercel-waf-logs)
    סוג המיקום בוחרים לפי הצרכים (אזור, שני אזורים, מספר אזורים)
    Location בוחרים את המיקום הכי קרוב למכונת Google SecOps (לדוגמה, us-central1)
    סוג אחסון (storage class) רגיל (מומלץ ליומנים שהגישה אליהם תכופה)
    בקרת גישה אחידה (מומלץ)
    כלי הגנה אופציונלי: הפעלת ניהול גרסאות של אובייקטים או מדיניות שמירת נתונים
  6. לוחצים על יצירה.

ייצוא של יומני Vercel WAF ל-GCS

‫Vercel מספקת יומני WAF דרך Log Drains ו-Vercel API בארכיטקטורת REST. מגדירים ייצוא של יומנים ואז מעלים אותם ל-GCS.

התכונה Vercel Log Drains מעבירה בסטרימינג יומנים בזמן אמת לנקודת קצה חיצונית.

  1. נכנסים אל מרכז הבקרה של Vercel.
  2. עוברים להגדרות הצוות: הגדרות > Log Drains.
  3. לוחצים על Add Log Drain.
  4. מגדירים את ניקוז היומנים:
    • פורמט מסירה: בוחרים באפשרות JSON.
    • מקורות: בוחרים באפשרות חומת אש כדי לכלול אירועי WAF.
    • סביבות: בוחרים את הסביבות למעקב (ייצור, תצוגה מקדימה, פיתוח).
    • נקודת קצה (endpoint): מזינים את כתובת ה-URL של המקלט המתווך (לדוגמה, נקודת קצה של פונקציית Cloud Run שכותבת ל-GCS).
  5. לוחצים על Add Log Drain.
  6. מוודאים שהיומנים נשלחים לנקודת הקצה.

אפשרות ב': ייצוא באמצעות Vercel REST API

  1. יוצרים אסימון API של Vercel בקטע Settings > Tokens (הגדרות > אסימונים).
  2. משתמשים ב-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

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Vercel WAF Logs).
  5. בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
  6. בוחרים באפשרות Vercel WAF בתור Log type.
  7. לוחצים על Get Service Account (קבלת חשבון שירות). תוצג כתובת אימייל ייחודית של חשבון שירות, לדוגמה:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. מעתיקים את כתובת האימייל הזו כדי להשתמש בה בשלב הבא.

מתן הרשאות IAM לחשבון השירות של Google SecOps

לחשבון השירות של Google SecOps צריך להיות התפקיד צפייה באובייקט אחסון בקטגוריה של GCS.

  1. נכנסים לדף Cloud Storage > Buckets.
  2. לוחצים על שם הקטגוריה (לדוגמה, vercel-waf-logs).
  3. עוברים לכרטיסייה Permissions.
  4. לוחצים על הענקת גישה.
  5. מזינים את פרטי ההגדרה הבאים:
    • הוספת חשבונות משתמשים: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps (לדוגמה, chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com).
    • הקצאת תפקידים: בוחרים באפשרות צפייה באובייקטים באחסון.
  6. לוחצים על Save.

הגדרת הפיד של Google SecOps

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Vercel WAF Logs).
  5. בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
  6. בוחרים באפשרות Vercel WAF בתור Log type.
  7. לוחצים על הבא.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:

    • כתובת ה-URL של קטגוריית האחסון: מזינים את ה-URI של קטגוריית ה-GCS:

      gs://vercel-waf-logs/vercel-waf/
      
      • מחליפים את vercel-waf-logs בשם של קטגוריית GCS.
      • מחליפים את vercel-waf בנתיב הקידומת שהגדרתם.
    • אפשרות מחיקת המקור: בוחרים את אפשרות המחיקה המועדפת:

      • Never: אף פעם לא למחוק קבצים אחרי העברות (מומלץ לבדיקה).
      • מחיקת קבצים שהועברו וספריות ריקות: מחיקת קבצים וספריות ריקות אחרי שההעברה מסתיימת.

    • גיל הקובץ המקסימלי: כולל קבצים ששונו במספר הימים האחרונים (ברירת המחדל היא 180 ימים).

    • מרחב השמות של הנכס: מרחב השמות של הנכס.

    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.

  9. לוחצים על הבא.

  10. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

טבלת מיפוי 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.