אישור או חסימה של שליחת webhook

התכונה הזו נתמכת במהדורות הבאות: Business Starter,‏ Business Standard,‏ Business Plus,‏ Enterprise Standard,‏ Enterprise Plus,‏ Education Fundamentals,‏ Education Standard,‏ Teaching and Learning add-on ו-Education Plus. אפשר להשתמש בתכונה הזאת בתוספים הבאים: Google AI Pro for Education.

תכונה זו נמצאת בתצוגה מקדימה מוגבלת.

תגובות לפעולה מאתר אחר (webhooks) מאפשרות לתהליכים לשלוח או לקבל נתונים באמצעות קישור חיצוני או API. השלב של ה-webhook מאפשר לאנשים להתחבר למשאבים פנימיים וחיצוניים שאין להם תמיכה ישירה ב-Google Workspace Studio. עם זאת, המשתמשים צריכים להיזהר כשהם משתפים את הנתונים של הארגון עם גורמים חיצוניים. שליחת נתונים באמצעות HTTP לא מוצפן (http://‎) היא לא מאובטחת. משתמשים ב-HTTPS‏ (https://‎).

כדי להגן על הנתונים של הארגון, Workspace Studio כולל כמה אמצעי אבטחה:

  • מושבתים כברירת מחדל: תגובות לפעולה מאתר אחר מושבתות עד שאדמין מפעיל אותן באופן מפורש ביחידה ארגונית.
  • רשימת היתרים של כתובות URL: במהדורות נתמכות, רשתות ה-webhook שולחות נתונים רק לדומיינים ולנקודות קצה שצוינו ברשימת ההיתרים של כתובות ה-URL של הארגון.
  • אישור משתמש: כברירת מחדל, אדם צריך לבדוק ולאשר כל שלב של ה-webhook לפני שהוא מופעל.
  • נתוני אירועים ביומן: בקשות להפעלת webhook מתועדות כאירועים ביומן של Workspace Studio.

שלב 1: הפעלה או השבתה של התכונה "תגובות לפעולות לפיתוח האתר"

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

  1. במסוף Google Admin, נכנסים לתפריט ואז אפליקציות ואז Google Workspace ואז Workspace Studio.

    כדי לעשות את זה צריך הרשאות אדמין להגדרות השירות.

  2. לוחצים על הגדרות של תגובות לפעולה מאתר אחר (webhook).
  3. (אופציונלי) כדי להחיל את ההגדרה רק על מחלקה או על צוות, בצד, בוחרים יחידה ארגונית.
  4. בוחרים באפשרות מופעל כדי לאפשר למשתמשים ביחידה הארגונית שנבחרה להשתמש בשלבי webhook בתהליכים, או בוחרים באפשרות מושבת כדי לחסום שלבי webhook.
  5. לוחצים על שמירה. לחלופין, אפשר ללחוץ על שינוי מברירת המחדל לגבי יחידה ארגונית מסוימת.

    אם מאוחר יותר רוצים לשחזר את הערך שעבר בירושה, לוחצים על ירושה.

שלב 2: (אופציונלי) הגבלת ה-webhooks לרשימת היתרים של כתובות URL

התכונה הזו נתמכת במהדורות הבאות: Business Plus,‏ Enterprise Standard ו-Enterprise Plus,‏ Education Standard ו-Education Plus. איזו מהדורה יש לך?

אתם יכולים להגביל את השלבים של ה-webhook כך שישלחו או יקבלו נתונים רק מכתובות URL ודומיינים ספציפיים שנכללים ברשימת ההיתרים. לשם כך, צריך להשתמש ברשימת ההיתרים המשותפת של כתובות URL ל-Google Drive, ל-Docs, ל-Sheets ול-Apps Script.

הערה: במהדורות שלא תומכות ברשימות היתרים של כתובות URL, תגובות לפעולה מאתר אחר (webhooks) יכולות להתחבר לכל כתובות ה-URL התקינות כשהתכונה מופעלת.

ניהול רשימת ההיתרים של כתובות ה-URL

  1. במסוף Google Admin, נכנסים לתפריט ואז אפליקציות ואז Google Workspace ואז Drive ו-Docs ואז תכונות ואפליקציות.

    כדי לעשות את זה צריך הרשאות אדמין להגדרות השירות.

  2. לוחצים על ייבוא ואחזור מכתובות URL.
  3. בוחרים באפשרות אפשר לייבא ולאחזר רק מכתובות ה-URL הבאות.
  4. מזינים את כתובות ה-URL או הדומיינים המורשים (לדוגמה, https://api.example.com).
  5. לוחצים על שמירה.

אישור משתמש לשלבי webhook

שלבים של תגובות לפעולה מאתר אחר (webhook) מתקשרים עם נקודות קצה חיצוניות, ולכן הם נחשבים לפעולות רגישות. כשבתהליך יש שלב של webhook, ‏Workspace Studio דורש מהמשתמש שמפעיל או מתחיל את התהליך לבדוק ולאשר את הפעולה לפני שהיא פועלת.

אתם יכולים לנהל את הגדרות האישור של המשתמשים במסוף Admin. פרטים נוספים זמינים במאמר בנושא דרישת אישור לתהליכים שכוללים משתמשים חיצוניים.

מעקב אחרי הפעילות של ה-webhook באמצעות אירועים ביומן

אתם יכולים לבדוק את השימוש ב-webhook באמצעות אירועי היומן של Workspace Studio במסוף Admin.

לפני שמתחילים: נתוני האירועים ביומן של ה-Webhook כוללים תוכן רגיש, כמו כתובות URL. כדי לראות את התוכן הזה, אתם צריכים להיות סופר-אדמינים או לבקש מהאדמין להפעיל את ההגדרה "צפייה בתוכן רגיש".

  1. במסוף Google Admin, נכנסים לתפריט ואז דיווח ואז ביקורת וחקירה ואז אירועים ביומן של Workspace Studio.

    כדי לעשות את זה צריך הרשאת אדמין לכלי הביקורת והחקירה.

  2. לוחצים על סינון ואז הוספת מסנן ואז שם השלב.
  3. מוסיפים מסנן באמצעות אחד מהערכים הבאים:
    • בוחרים באפשרות מכיל ומזינים webhook.
    • בוחרים באפשרות Is (הוא) ומזינים את הערך Send a webhook (שליחת תגובה לפעולה מאתר אחר (webhook)).
  4. בודקים את הפרמטרים של האירוע:
    • כתובת ה-URL של הבקשה ל-webhook: כתובת היעד שאליה נשלחת הקריאה בשלב ה-webhook. כתובת ה-URL נחשבת למידע אישי רגיש.