Google Cloud API

במאמר הזה מוסבר איך להגדיר אתGoogle Cloud API ולשלב אותו עם Google Security Operations.

תרחישים לדוגמה

השילוב של Google Cloud API משתמש ביכולות של Google SecOps כדי לתמוך בתרחישים הבאים:

  • ניהול משאבים אוטומטי: ביצוע פעולות בשירותי Google Cloudכמו Compute Engine או Cloud Storage כדי לטפל באיומים או לנהל את התשתית באופן דינמי.

  • ניהול זהויות והרשאות גישה: התאמה פרוגרמטית של כללי המדיניות או התפקידים בניהול זהויות והרשאות גישה (IAM) בתגובה לאירועי אבטחה שזוהו.

  • תזמור API בהתאמה אישית: אינטראקציה עם כל ממשק API מופעל Google Cloud שאין לו שילוב ייעודי, כדי לספק גמישות מקסימלית לפלייבוקים מורכבים.

  • אימות ללא מפתח: גישה מאובטחת למשאבי Google Cloud באמצעות Workload Identity, כדי למנוע את הסיכונים שקשורים למפתחות סטטיים של חשבונות שירות.

לפני שמתחילים

לפני שמגדירים את השילוב בפלטפורמת Google SecOps, צריך לוודא שיש לכם את הפרטים הבאים:

  • הפעלת ממשקי ה-API לטירגוט: מזהים ומפעילים את שירותיGoogle Cloud הספציפיים שרוצים להפוך לאוטומטיים.

  • הרשאות IAM: ודאו שלזהות שלכם יש את התפקידים הנדרשים לפעולות הספציפיות שאתם רוצים לבצע.

  • שיטת אימות: בוחרים בין שיטת האימות המומלצת Workload Identity לבין מפתח JSON של חשבון שירות.

זיהוי והפעלה של ממשקי API לטירגוט

מכיוון שהשילוב הזה הוא שער גנרי, אין ממשקי API קבועים. הדרישות תלויות בתרחיש השימוש הספציפי שלכם. כדי להפעיל את ממשקי ה-API הרצויים (כמו Compute Engine, ‏ Cloud Storage או IAM) באמצעות האינטגרציה, צריך להפעיל אותם בפרויקט.

כדי לזהות ולהפעיל את ממשקי ה-API הרצויים:

  1. במסוף Google Cloud , נכנסים לדף APIs & Services > Library.

  2. מחפשים את השירותים הנדרשים ומפעילים אותם.

הגדרת הרשאות IAM

לחשבון השירות או לזהות שמשמשים לשילוב הזה צריכים להיות תפקידי ה-IAM המתאימים.

  • העיקרון של הרשאות מינימליות: מקצים רק את התפקידים הספציפיים שנדרשים לקריאות ל-API.

  • דרישות דינמיות: ההרשאות משתנות בהתאם לפעולה. לדוגמה, כדי לנהל משאבים נדרשים תפקידים שונים מאשר כדי להציג אותם.

בחירה של שיטת אימות

‫Google SecOps תומך בשני נתיבי אימות לשילוב הזה:

אימות באמצעות Workload Identity (מומלץ)

Workload Identity היא השיטה הכי מאובטחת, כי היא מייתרת את הצורך לנהל או להחליף מפתחות JSON לטווח ארוך. הוא משתמש בהתחזות לחשבון שירות כדי לאפשר לפלטפורמה לגשת למשאבים שלכם באופן מאובטח.

זיהוי הזהות של מכונת Google SecOps

כדי למצוא את הזהות הייחודית של המכונה:

  1. ב-Google SecOps, עוברים אל Content Hub > Response Integrations.

  2. בוחרים בשילוב של Google Cloud API.

  3. בשדה Workload Identity Email, מזינים את כתובת האימייל של חשבון השירות המיועד.

  4. לוחצים על שמירה ואז על בדיקה. הבדיקה צפויה להיכשל.

  5. לוחצים על close_small משמאל ל-Test ומחפשים בהודעת השגיאה את כתובת האימייל של הזהות שמתחילה ב-gke-init-python@... או ב-soar-python@....

  6. מעתיקים את כתובת האימייל הייחודית הזו.

מתן הרשאות להתחזות

כדי לתת לזהות של המכונה הרשאת גישה למשאבים:

  1. במסוף Google Cloud , נכנסים לדף IAM & Admin > Service Accounts.

    לדף Service accounts

  2. בוחרים את חשבון השירות הרצוי ועוברים אל Permissions > Grant Access.

  3. מדביקים את כתובת האימייל הייחודית בשדה New principals ומקצים את התפקיד Service Account Token Creator (roles/iam.serviceAccountTokenCreator).

אימות באמצעות מפתח JSON

השתמשו בשיטה הזו רק אם Workload Identity לא זמין בסביבה שלכם.

כדי לאמת את השילוב באמצעות מפתח JSON של חשבון שירות:

  1. יוצרים חשבון שירות במסוף Google Cloud .

  2. עוברים לכרטיסייה Keys ולוחצים על Add key > Create new key.

  3. בוחרים באפשרות JSON בתור סוג המפתח ומורידים את הקובץ.

  4. מעתיקים את כל התוכן של הקובץ הזה ומדביקים אותו ב-Service Account Json File Content במהלך הגדרת השילוב ב-Google SecOps.

שילוב של Google Cloud API עם Google SecOps SOAR

השילוב דורש את הפרמטרים הבאים:

פרמטרים תיאור
Test URL אופציונלי

כתובת URL לבדיקה כדי לאמת את האימות ל-API של Google Cloud . הפרמטר הזה משתמש בבקשת GET.

Service Account Json File Content אופציונלי

התוכן של קובץ ה-JSON של מפתח חשבון השירות.

אתם יכולים להגדיר את הפרמטר הזה, את הפרמטר Workload Identity Email או את כל הפרמטרים הקודמים של השילוב.

כדי להגדיר את הפרמטר הזה, צריך לספק את התוכן המלא של קובץ ה-JSON של מפתח חשבון השירות שהורדתם כשיצרתם את חשבון השירות.

מידע נוסף על שימוש בחשבונות שירות כשיטת אימות זמין במאמרים סקירה כללית על חשבונות שירות והתחזות לחשבון שירות.

בשילוב הזה, לאימות באמצעות קובץ ה-JSON של מַפְתח חשבון השירות יש עדיפות על פני כתובת האימייל של Workload Identity.

Organization ID אופציונלי

מזהה הארגון שבו רוצים להשתמש בשילוב.

כדי לאחזר את הערך מהפרמטר הזה במהלך ביצוע הפעולה, צריך להגדיר את ה-placeholder הבא: {{org_id}}.

Project ID אופציונלי

מזהה הפרויקט שבו משתמשים בשילוב.

כדי לאחזר את הערך מהפרמטר הזה במהלך ביצוע הפעולה, צריך להגדיר את ה-פלייסהולדר הבא: {{project_id}}.

Quota Project ID אופציונלי

מזהה הפרויקט ב- Google Cloud שמשמש לממשקי API ולחיוב ב- Google Cloud . כדי להשתמש בפרמטר הזה, צריך להקצות לחשבון השירות את התפקיד Service Usage Consumer.

השילוב מצרף את ערך הפרמטר הזה לכל בקשות ה-API.

אם לא מגדירים ערך לפרמטר הזה, השילוב מאחזר את מזהה הפרויקט מחשבון השירות של Google Cloud .

Workload Identity Email אופציונלי

כתובת האימייל של הלקוח בחשבון השירות.

אפשר להגדיר את הפרמטר הזה או את הפרמטר Service Account Json File Content.

בשילוב הזה, לאימות באמצעות קובץ ה-JSON של מפתח חשבון השירות יש עדיפות על פני האימייל של Workload Identity.

כדי להתחזות לחשבונות שירות באמצעות Workload Identity, צריך להקצות את התפקיד Service Account Token Creator לזהות של המכונה של Google SecOps בחשבון השירות. למידע נוסף על Workload Identity ואיך לעבוד איתן, קראו את המאמר זהויות של עומסי עבודה.

OAuth Scopes אופציונלי

רשימה מופרדת בפסיקים של היקפי ההרשאות של OAuth שנדרשים כדי להפעיל את בקשות ה-API של Google Cloud .

Verify SSL חובה

אם בוחרים באפשרות הזו, השילוב מאמת שאישור ה-SSL לחיבור לשירות Google Cloud תקין.

האפשרות הזו מסומנת כברירת מחדל.

הוראות להגדרת שילוב ב-Google SecOps מפורטות במאמר הגדרת שילובים.

אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של אינטגרציה, אפשר להשתמש בו בפלייבוקים. מידע נוסף על הגדרה ותמיכה בכמה מופעים זמין במאמר תמיכה בכמה מופעים.

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

ביצוע בקשת HTTP

משתמשים בפעולה Execute HTTP Request כדי ליצור ולהפעיל בקשת API מותאמת אישית של HTTP לכתובת URL מסוימת.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

התנהגות הפעולה

הפעולה הזו תומכת בהתנהגויות מורכבות, כולל סקרים אסינכרוניים, בניית מטען ייעודי (payload) דינמי וניהול קבצים.

סקר אסינכרוני

כשמציינים את Expected Response Values, הפעולה מתבצעת במצב אסינכרוני. במצב הזה, הפעולה דוגמת שוב ושוב את נקודת הקצה (endpoint) כדי לעקוב אחרי הסטטוס של התגובה (לדוגמה, המתנה להשלמת משימה ארוכה).

הפעולה בודקת את גוף התגובה לפי תנאי ה-JSON שצוינו בפרמטר, וממשיכה לפעול עד שהתנאים מתקיימים או עד שנגמר הזמן הקצוב לפעולה.

לוגיקה של משפט תנאי

הפעולה תומכת בלוגיקה הבאה למעקב אחרי מצבי התגובה:

  • התאמה לשדה יחיד: הפעולה ממתינה עד ששדה ספציפי יגיע לערך יחיד.

    {
      "state": "finished"
    }
    
  • כמה ערכים (לוגיקת OR): הפעולה מפסיקה את הביצוע אם שדה תואם לערך כלשהו ברשימה שסופקה. זה שימושי כדי לעצור גם במצבי "הצלחה" וגם במצבי "שגיאה", כדי למנוע דגימה מיותרת.

    {
      "state": ["finished", "error"]
    }
    
  • כמה שדות (לוגיקת AND): הפעולה ממתינה עד שכל השדות שצוינו תואמים לערכים שלהם בו-זמנית.

    {
      "state": "finished",
      "percentage": "100"
    }
    
  • לוגיקה משולבת: אפשר לשלב כמה תנאים באובייקט ה-JSON.

    {
      "state": ["finished", "error"],
      "percentage": "10"
    }
    
התנהגות הניתוח של קובצי JSON

כשבודקים את התנאים, הפעולה מתבצעת לפי הכללים הבאים:

  • חיפוש גלובלי: הפעולה מחפשת את המפתחות שצוינו בכל אובייקט התגובה ב-JSON. ציינו את שם המפתח בדיוק כמו שהוא מופיע ב-JSON, בלי להוסיף לפניו שמות של אובייקטים הורים או קידומות (לדוגמה, השתמשו ב-"state", ולא ב-"data_state" או ב-"data-state").

  • כמה מפתחות זהים: אם התגובה מכילה כמה מפתחות עם אותו שם ברמות שונות של היררכיית ה-JSON, הפלט הצפוי מתקבל רק כשכל שמות המפתחות התואמים עומדים בערך הצפוי הזהה.

    לדוגמה, כדי לחפש את המצב finished בתגובת ה-JSON ולהתעלם ממצבים אחרים, מגדירים את כל המפתחות של state ב-Expected Response Values לערך finished:

    {
    "data": {
      "state": "finished"
      },
      "state": "finished"
    }
    
מבנה המטען הייעודי (payload) של גוף הבקשה

הפעולה יוצרת את גוף הבקשה על סמך הכותרת Content-Type שסופקה ב-Headers.

זהו הקלט של Body Payload שמשמש בדוגמאות הבאות:

{
  "Id": "123123",
  "sorting": "asc"
}
  • ‫application/x-www-form-urlencoded: הפעולה יוצרת את המטען הייעודי (payload) כ-Id=123123&sorting=asc.

  • ‫application/json: הפעולה יוצרת את המטען הייעודי (payload) הבא ב-JSON:

    {
      "Id": "123123",
      "sorting": "asc"
    }
    
  • ‫XML: אם המוצר של הצד השלישי דורש XML, צריך לספק קלט בפורמט XML ישירות ב-Body Payload:

    <?xml version="1.0" encoding="utf-8"?>
    <soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
    <soap:Body>
      <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
        <ubiNum>500</ubiNum>
      </NumberToWords>
    </soap:Body>
    </soap:Envelope>
    
טיפול בקבצים

הפעולה תומכת בתהליכי העבודה הבאים לניהול קבצים:

  • הורדת קבצים:

    • כדי להחזיר נתוני קבצים כחלק מתוצאת ה-JSON בפורמט base64, בוחרים באפשרות Base64 Output.

    • כדי לשמור קובץ ישירות ב-Case Wall כארכיון ZIP, לוחצים על Save To Case Wall.

  • העלאת קבצים: כדי להעלות קובץ, צריך להמיר אותו למחרוזת בקידוד Base64 ולכלול אותו כחלק מהערך של Body Payload.

    בדוגמה הבאה מוצג קובץ תמונה שהומר למחרוזת בקידוד base64:

    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
    
  • אבטחה: לקבצים רגישים (כמו תוכנות זדוניות), בוחרים באפשרות Password Protect Zip. הפעולה הזו מצפינה באופן אוטומטי את ארכיון ה-ZIP השמור שנוצר באמצעות Save To Case Wall עם הסיסמה infected.

הגדרת בלוקים של פלייבוקים

ההגדרה הבאה מדגימה איך להשתמש בפעולה Execute HTTP Request בתוך בלוק של פלייבוק. הדוגמה הזו תעזור לכם להבין איך להשתמש בפלייסהולדרים ובקידומות קלט.

כשמשתמשים בקלט של בלוקים כפלייסהולדרים, צריך לכלול את הקידומת Input. (לדוגמה, [Input.comment]).

  • Method:‏ PUT

  • נתיב כתובת ה-URL:

    https://{API_URL}/[Input.table_name]/[Input.sys_id]
    
  • כותרות:

    {
      "Content-type": "application/json; charset=utf-8",
      "Accept": "application/json",
      "User-Agent": "GoogleSecops"
    }
    
  • מטען ייעודי (payload) של גוף ההודעה:

    {
      "work_notes": "[Input.comment]"
    }
    

קלט של הפעולה

הפעולה Execute HTTP Request דורשת את הפרמטרים הבאים:

פרמטר תיאור
Method אופציונלי

שיטה לשימוש בבקשה.

ערך ברירת המחדל הוא GET.

הערכים האפשריים הם:
  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS
URL Path אופציונלי

כתובת URL להפעלה.

ערך ברירת המחדל הוא https://.

URL Params אופציונלי

הפרמטרים של כתובת ה-URL.

הפעולה משתמשת בכל ערך שסופק לצד הערכים שסיפקתם ישירות בפרמטר נתיב כתובת ה-URL.

הפרמטר הזה דורש פורמט של אובייקט JSON כקלט. ערך ברירת המחדל הוא:

{
    "URL Field Name": "URL_FIELD_VALUE"
    }
Headers אופציונלי

כותרות לשימוש בבקשת ה-HTTP.

הפרמטר הזה דורש פורמט של אובייקט JSON כקלט. ערך ברירת המחדל הוא:

{
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent" : "GoogleSecOps"
    }
Cookie אופציונלי

הפרמטרים שצריך להשתמש בהם בכותרת Cookie.

הפרמטר הזה מחליף את קובצי ה-Cookie שסופקו בפרמטר Headers.

הפרמטר הזה דורש פורמט של אובייקט JSON כקלט. ערך ברירת המחדל הוא:

{
    "Cookie_1": "COOKIE_1_VALUE"
    }
Body Payload
אופציונלי

גוף לבקשת ה-HTTP. הפעולה יוצרת מטען ייעודי (payload) שונה בהתאם לערך הכותרת Content-Type שצוין בפרמטר Headers.

הפרמטר הזה דורש את הפורמט של אובייקט JSON כקלט, אלא אם מוצר של צד שלישי דורש XML או את התוכן של multipart/form-data. אם שולחים או מעלים קובץ באמצעות בקשת ה-API, צריך לספק את הגרסה של הקובץ בקידוד base64 בפרמטר Body Payload ולהגדיר את הכותרת לערך "Content-type": "multipart/form-data".

ערך ברירת המחדל הוא:

{
    "Body Field Name": "BODY_FIELD_VALUE"
    }
Expected Response Values

זה שינוי אופציונלי.

אובייקט ה-JSON שמכיל את צמדי השדה-ערך שמגדירים את המצב הנדרש של גוף התגובה.

Save To Case Wall אופציונלי

אם בוחרים באפשרות הזו, הפעולה שומרת את הקובץ ומצרפת אותו לקיר של בקשת התמיכה. הקובץ מועבר לארכיון עם הסיומת .zip. הקובץ .zip לא מוגן בסיסמה.

האפשרות הזו לא מסומנת כברירת מחדל.

Password Protect Zip אופציונלי

אם בוחרים באפשרות הזו, הפעולה מוסיפה סיסמה לקובץ .zip שנוצר באמצעות הפרמטר Save To Case Wall. הסיסמה היא: infected.

השתמשו בפרמטר הזה כשאתם עובדים עם קבצים חשודים.

האפשרות הזו מסומנת כברירת מחדל.

Follow Redirects אופציונלי

אם האפשרות הזו נבחרת, הפעולה עוקבת אחרי ההפניות האלה.

האפשרות הזו מסומנת כברירת מחדל.

Fail on 4xx/5xx אופציונלי

אם בוחרים באפשרות הזו, הפעולה נכשלת אם קוד הסטטוס של התגובה הוא שגיאה מסוג 4xx או 5xx.

האפשרות הזו מסומנת כברירת מחדל.

Base64 Output אופציונלי

אם בוחרים באפשרות הזו, הפעולה ממירה את התשובה לפורמט base64.

משתמשים בפרמטר הזה כשמורידים קבצים.

הגודל של תוצאת ה-JSON לא יכול להיות יותר מ-15MB.

האפשרות הזו לא מסומנת כברירת מחדל.

Fields To Return חובה

השדות שיוחזרו. הערכים האפשריים הם:

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding
Request Timeout חובה

פרק הזמן שצריך להמתין עד שהשרת ישלח נתונים לפני שהפעולה תיכשל.

ערך ברירת המחדל הוא 120 שניות.

ערכי פלט של פעולות

הפעולה Execute HTTP Request מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

בדוגמה הבאה מתואר פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Execute HTTP Request:

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "item",
                       "description": "Object to which the comment belongs to."
                   },
                   {
                       "name": "author",
                       "description": "User who wrote the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "VALUE",
       "Date": "Fri, 03 Nov 2023 16:14:13 GMT",
       "Server": "Google Frontend",
       "Content-Length": "36084"
   },
   "apparent_encoding": "ascii"
}
הודעות פלט

הפעולה Execute HTTP Request מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully executed API request.

Successfully executed API request, but the status code {4xx/5xx} was returned. Please check the request or try again later.

הפעולה בוצעה בהצלחה.
Failed to execute API request. Error: ERROR_REASON

הפעולה נכשלה.

צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Execute HTTP Request:

שם תוצאת הסקריפט ערך
is_success True או False

פינג

משתמשים בפעולה פינג כדי לבדוק את הקישוריות אל Google Cloud.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

אין.

ערכי פלט של פעולות

הפעולה פינג מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת JSON

בדוגמה הבאה מתואר פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Ping:

{
"endpoint": "TEST_URL"
}
הודעות פלט

הפעולה פינג מספקת את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully tested connectivity. הפעולה בוצעה בהצלחה.
Failed to test connectivity.

הפעולה נכשלה.

צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מתוארים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה פינג:

שם תוצאת הסקריפט ערך
is_success True או False

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.