שילוב של Google Workspace עם Google SecOps

במאמר הזה מוסבר איך לשלב את Google Workspace עם Google Security Operations.

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

שילוב של Google Workspace עם Google SecOps יכול לעזור לכם לפתור את תרחיש השימוש הבא:

  • הסרת משתמשים ואבטחת חשבונות: אפשר להשתמש ביכולות של Google SecOps כדי להפעיל תהליך עבודה לביטול הגישה ל-Google Workspace, להשעיית חשבונות ולהעברת אימיילים של משתמשים שהוסרו לעובד אחר.

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

לפני שמגדירים את השילוב של Google Workspace ב-Google SecOps, צריך לבצע את השלבים המקדימים הבאים:

  1. יוצרים חשבון שירות.
  2. הקצאת הרשאה ברמת הדומיין לחשבון השירות.
  3. מפעילים את Admin SDK API בפרויקט.
  4. מקצים את Google Cloud תפקיד ה-IAM הנדרש לחשבון השירות.
  5. בוחרים ומגדירים אחת משיטות האימות הבאות:
    • אפשרות 1: מפתח JSON: השיטה הזו מסתמכת על קובץ מפתח סודי סטטי לטווח ארוך. משתמשים בשיטה הזו רק אם Workload Identity לא זמינה בסביבה שלכם.
    • אפשרות 2: Workload Identity (מומלץ): בשיטה הזו נעשה שימוש באסימוני גישה זמניים לטווח קצר באמצעות התחזות לחשבון שירות, כך שלא צריך לאחסן סודות.

יצירה של חשבון שירות

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

  1. במסוף Google Cloud , נכנסים אל IAM & Admin > Service Accounts ובוחרים את הפרויקט.

    לדף Service accounts

  2. לוחצים על יצירת חשבון שירות.

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

הענקת הרשאה ברמת הדומיין לחשבון השירות

  1. במסוף Google Admin של הדומיין, עוברים אל התפריט הראשי > אבטחה > שליטה בגישה ובנתונים > אמצעי בקרה לממשקי API.
  2. בחלונית Domain wide delegation (הענקת גישה ברמת הדומיין), בוחרים באפשרות Manage Domain Wide Delegation (ניהול הענקת גישה ברמת הדומיין).
  3. לוחצים על הוספת חדש.
  4. בשדה Client ID (מזהה הלקוח), מזינים את מזהה הלקוח שהתקבל משלבי היצירה של חשבון השירות שצוינו למעלה.

  5. בשדה OAuth Scopes (היקפי הרשאות של OAuth), מזינים את רשימת היקפי ההרשאות שנדרשים לאפליקציה, כשהם מופרדים בפסיקים:

    https://mail.google.com/,
https://www.googleapis.com/auth/cloud-platform,
https://www.googleapis.com/auth/admin.directory.user,
https://www.googleapis.com/auth/admin.directory.group.member,
https://www.googleapis.com/auth/admin.directory.customer.readonly,
https://www.googleapis.com/auth/admin.directory.domain.readonly,
https://www.googleapis.com/auth/admin.directory.group,
https://www.googleapis.com/auth/admin.directory.orgunit,
https://www.googleapis.com/auth/admin.directory.user.alias,
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly,
https://www.googleapis.com/auth/apps.groups.settings,
https://www.googleapis.com/auth/admin.directory.user.security,
https://www.googleapis.com/auth/admin.reports.audit.readonly,
https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly,
https://www.googleapis.com/auth/chrome.management.appdetails.readonly,
https://www.googleapis.com/auth/chrome.management.policy

  6. לוחצים על Authorize.

הפעלת Admin SDK API בפרויקט

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

    כניסה אל APIs & Services

  2. לוחצים על Enable APIs and Services.

  3. מפעילים את Admin SDK API בפרויקט.

הגדרת מפתח JSON

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

כדי ליצור את קובץ מפתח ה-JSON שנדרש לאימות השילוב, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , נכנסים אל IAM & Admin > Service Accounts ובוחרים את חשבון השירות שיצרתם.

    לדף Service accounts

  2. עוברים לכרטיסייה Keys.

  3. לוחצים על הוספת מפתח.

  4. בוחרים באפשרות יצירת מפתח חדש.

  5. בקטע Key type (סוג מפתח), בוחרים באפשרות JSON ולוחצים על Create (יצירה). קובץ ה-JSON יירד למחשב.

  6. מעתיקים את כל התוכן של הקובץ הזה ומדביקים אותו ב-User's Service Account JSON במהלך הגדרת השילוב.

הגדרת הרשאות ב-Google Workspace

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

  1. במסוף Google Admin, נכנסים אל חשבון > תפקידי אדמין.
  2. לוחצים על תפקיד חדש.
  3. נותנים שם לתפקיד החדש בהתאמה אישית ולוחצים על המשך.
  4. בדף Select Privileges (בחירת הרשאות), עוברים לקטע Admin API privileges (הרשאות Admin API).

  5. בקטע Admin API privileges (הרשאות Admin API), בוחרים את ההרשאות הבאות:

    • Organization Units
    • Users
    • Groups

  6. לוחצים על Continue.

  7. כדי ליצור תפקיד חדש בהתאמה אישית, לוחצים על יצירת תפקיד.

הקצאת התפקיד המותאם אישית למשתמש

כדי להקצות את התפקיד לחשבון משתמש ולאשר לשילוב לבצע פעולות בשמכם, צריך לפעול לפי השלבים הבאים:

  1. כדי ליצור משתמש חדש, עוברים לדף ספרייה > משתמשים.
  2. מוסיפים משתמש חדש שמשויך לחשבון השירות.
  3. פותחים את ההגדרות של המשתמש החדש שנוצר. נפתחת הכרטיסייה של חשבון המשתמש.
  4. לוחצים על תפקידים והרשאות של אדמין.
  5. לוחצים על עריכה עריכה.
  6. בוחרים את התפקיד בהתאמה אישית שיצרתם.
  7. בתפקיד שנבחר, מעבירים את המתג למצב Assigned (הוקצה).

הגדרת פרטי כניסה של Workload Identity

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

זיהוי הזהות הייחודית של המופע

כדי להשתמש ב-Workload Identity, צריך להעניק למופע של Google SecOps הרשאה להתחזות לחשבון השירות. זה השלב האחרון שמאפשר למופע לגשת למשאבים של Google Cloud בצורה מאובטחת.

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

  2. בוחרים את השילוב שרוצים להגדיר ומזינים את כתובת האימייל של חשבון השירות בשדה Workload Identity Email.

  3. בשדה Delegated Email מזינים את כתובת האימייל שרוצים שהשילוב יתחזה אליה.

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

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

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

איך מאשרים את זהות המכונה ב- Google Cloud

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

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

    לדף Service accounts

  2. בוחרים את חשבון השירות של היעד ועוברים אל Permissions > Grant Access (הרשאות > הענקת גישה).

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

פרמטרים של שילוב

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

פרמטר תיאור
Verify SSL

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

אם האפשרות הזו נבחרה, השילוב מאמת את אישור ה-SSL כשהוא מתחבר ל-Google Workspace.

האפשרות הזו מסומנת כברירת מחדל.
User's Service Account JSON

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

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

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

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

חובה.

כתובת האימייל שבה השילוב ישתמש.
Workload Identity Email

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

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

מגדירים את הפרמטר הזה רק אם מבצעים אימות באמצעות זהות של עומס עבודה.

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

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

פעולות

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

הוספת חברים לקבוצה

כדי להוסיף משתמשים לקבוצה, משתמשים בפעולה הוספת חברים לקבוצה.

הפעולה הזו מופעלת על הישות User.

הפעולה הוספת חברים לקבוצה פותרת את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

הפעולה Add Members To Group (הוספת חברים לקבוצה) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Group Email Address

חובה.

כתובת האימייל של הקבוצה שאליה רוצים להוסיף חברים חדשים.

User Email Addresses

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

רשימה מופרדת בפסיקים של משתמשים להוספה לקבוצה.

הפעולה מבצעת ערכים שאתם מגדירים לפרמטר הזה לצד הישות User.

פלטים של פעולות

הפעולה הוספת חברים לקבוצה מספקת את הפלטים הבאים:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

חסימת תוסף

משתמשים בפעולה חסימת תוסף כדי לחסום תוסף ל-Chrome ספציפי ביחידה ארגונית.

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

הוספת נתונים לפעולה

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

פרמטר תיאור
Organization Unit Name

חובה.

השם של היחידה הארגונית שבה רוצים לחסום את התוסף.
Extension ID

חובה.

מזהה התוסף שרוצים לחסום.

פלטים של פעולות

הפעולה Block Extension מספקת את הפלט הבא:

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

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

[
        {
            "targetKey": {
                "targetResource": "orgunits/example-org-unit-id",
                "additionalTargetKeys": {
                    "app_id": "chrome:exampleextensionid"
                }
            },
            "value": {
                "policySchema": "chrome.users.apps.InstallType",
                "value": {
                    "appInstallType": "BLOCKED"
                }
            },
            "sourceKey": {
                "targetResource": "orgunits/example-org-unit-id"
            },
            "addedSourceKey": {
                "targetResource": "orgunits/example-org-unit-id"
            }
        }
]
הודעות פלט

הפעולה חסימת התוסף יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully blocked extension EXTENSION_ID in Organization Unit ORGANIZATION_NAME using Google Workspace.

 הפעולה הסתיימה בהצלחה.
Error executing action "Block Extension". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Block Extension:

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

קבוצה חדשה

כאדמינים של קבוצות ב-Google Workspace, אתם יכולים להשתמש בפעולה יצירת קבוצה כדי ליצור קבוצות לארגון שלכם במסוף Google Admin, ב-Groups API או ב-Google Cloud Directory Sync.

אם אתם משתמשים ב-Groups for Business, אתם יכולים גם ליצור קבוצות לארגון שלכם ב-קבוצות Google.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

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

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

הוספת נתונים לפעולה

הפעולה Create Group (יצירת קבוצה) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Email Address

חובה.

כתובת האימייל של הקבוצה החדשה.
Name

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

שם הקבוצה החדשה.
Description

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

תיאור של הקבוצה החדשה.

פלטים של פעולות

הפעולה יצירת קבוצה מספקת את התוצאות הבאות:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
   {
      "kind":"admin#directory#group",
      "id":"ID",
      "etag":"TAG/var>",
      "email":"user@example.com",
      "name":"example",
      "description":"",
      "adminCreated":"True"
   }
]
תוצאת הסקריפט

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

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

יצירת יחידה ארגונית

משתמשים בפעולה Create OU (יצירת יחידה ארגונית) כדי ליצור יחידה ארגונית חדשה.

הפעולה הזו מופעלת בכל הישויות ב-Google SecOps.

אפשר להשתמש בפעולה Create OU כדי לפתור את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

הפעולה Create OU (יצירת יחידה ארגונית) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Customer ID

חובה.

מזהה ייחודי של חשבון Google Workspace של הלקוח.

כדי להגדיר את החשבון customerId, אפשר גם להשתמש בערך ה-placeholder הבא: my_customer.
Name

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

שם היחידה הארגונית החדשה.
Description

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

תיאור של היחידה הארגונית החדשה.
Parent OU Path

חובה.

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

פלטים של פעולות

הפעולה Create OU מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
   {
      "kind":"admin#directory#orgUnit",
      "etag":"TAG",
      "name":"example",
      "orgUnitPath":"/example_folder",
      "orgUnitId":"id:ID",
      "parentOrgUnitPath":"/",
      "parentOrgUnitId":"id:ID"
   }
]
תוצאת הסקריפט

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

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

יצירת משתמש

משתמשים בפעולה Create User (יצירת משתמש) כדי ליצור משתמש חדש.

כשמוסיפים משתמש לחשבון Google Workspace, המשתמש מקבל כתובת אימייל בדומיין העסקי שלכם וחשבון שבאמצעותו הוא יכול לגשת לשירותי Google Workspace.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

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

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

הוספת נתונים לפעולה

הפעולה Create User (יצירת משתמש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Given Name

חובה.

השם הפרטי של המשתמש.
Family Name

חובה.

שם המשפחה של המשתמש.
Password

חובה.

הסיסמה של המשתמש החדש.
Email Address

חובה.

כתובת האימייל הראשית של המשתמש.
Phone

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

מספר הטלפון של המשתמש.
Gender

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

המגדר של המשתמש.

הערכים התקפים הם: female, ‏ male, ‏ other,‏ unknown.
Department

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

השם של המחלקה של המשתמש.
Organization

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

שם הארגון של המשתמש.
Change Password At Next Login

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

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

לא מסומן כברירת מחדל.

פלטים של פעולות

הפעולה Create User מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
   {
      "kind":"admin#directory#user",
      "id":"ID",
      "etag":"TAG",
      "primaryEmail":"example@example.com",
      "name":{
         "givenName":"FIRST_NAME",
         "familyName":"LAST_NAME"
      },
      "isAdmin":"False",
      "isDelegatedAdmin":"False",
      "creationTime":"2020-12-22T13:44:29.000Z",
      "organizations":[
         {
            "name":"ExampleOrganization"
         }
      ],
      "phones":[
         {
            "value":"(800) 555‑0175"
         }
      ],
      "gender":{
         "type":"male"
      },
      "customerId":"ID",
      "orgUnitPath":"/",
      "isMailboxSetup":"False"
   }
]
תוצאת הסקריפט

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

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

מחיקת התוסף

משתמשים בפעולה Delete Extension כדי למחוק תוסף ל-Chrome ספציפי מיחידה ארגונית.

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

הוספת נתונים לפעולה

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

פרמטר תיאור
Organization Unit Name

חובה.

השם של היחידה הארגונית שממנה רוצים למחוק את התוסף.
Extension ID

חובה.

המזהה של התוסף שרוצים למחוק.

פלטים של פעולות

הפעולה מחיקת תוסף מספקת את הפלטים הבאים:

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

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

[
  {
    "deleted_extensions": ["chrome:exampleextensionid"]
  }
]
הודעות פלט

הפעולה מחיקת תוסף יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully deleted extension EXTENSION_ID from Organization Unit ORGANIZATION_NAME using Google Workspace.

 הפעולה הסתיימה בהצלחה.
Error executing action "Delete Extension". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה מחיקת תוסף:

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

מחק קבוצה

משתמשים בפעולה מחיקת קבוצה כדי למחוק קבוצה בספרייה של Google Workspace.

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

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

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

הוספת נתונים לפעולה

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

פרמטר תיאור
Group Email Address

חובה.

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

פלטים של פעולות

הפעולה מחיקת קבוצה מספקת את הפלטים הבאים:

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

הפעולה מחיקת קבוצה מספקת את הודעות הפלט הבאות:

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

Google Workspace group GROUP_EMAIL deleted.

Action was not able to find Google Workspace group for deletion.

הפעולה הסתיימה בהצלחה.
Failed to connect to the Google Workspace! Error is ERROR_DESCRIPTION

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

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

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

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

מחיקת יחידה ארגונית

כדי למחוק יחידה ארגונית, משתמשים בפעולה Delete OU.

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

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

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

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

הוספת נתונים לפעולה

הפעולה מחיקת יחידה ארגונית דורשת את הפרמטרים הבאים:

פרמטר תיאור
Customer ID

חובה.

מזהה ייחודי של חשבון Google Workspace של הלקוח.

כדי להגדיר את החשבון customerId, אפשר גם להשתמש בערך ה-placeholder הבא: my_customer.
OU Path

חובה.

נתיב מלא ליחידה הארגונית.

אם היחידה הארגונית נמצאת מתחת לנתיב בסיסי (/), מציינים את שם היחידה הארגונית ללא נתיב.

פלטים של פעולות

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

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

מחיקת משתמש

כדי למחוק חשבונות משתמשים, משתמשים בפעולה מחיקת משתמש.

אחרי שמוחקים משתמש, הוא לא יכול לגשת לשירותי Google Workspace של הארגון או להשתמש בהם.

אפשר להשתמש בפעולה מחיקת משתמש כדי לפתור את תרחישי השימוש הבאים:

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

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

הוספת נתונים לפעולה

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

פרמטר תיאור
Email Address

חובה.

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

פלטים של פעולות

הפעולה מחיקת משתמש מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

העשרת ישויות

אפשר להשתמש בפעולה Enrich Entities כדי להעשיר ישויות של Google SecOps במידע מ-Google Workspace.

הפעולה הזו מופעלת על הישות User.

אפשר להשתמש בפעולה Enrich Entities כדי לפתור את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

אין.

פלטים של פעולות

הפעולה Enrich Entities מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה של ישויות יש גישה
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
העשרה של ישויות

הפעולה Enrich Entities (העשרת ישויות) תומכת בהעשרת הישויות הבאה:

שם שדה ההעשרה לוגיקת העשרה
Phones הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
isDelegatedAdmin הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
suspended הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
id הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
nonEditableAliases הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
archived הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
isEnrolledIn2Sv הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
includeInGlobalAddressList הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
Relations הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
isAdmin הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
etag הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
lastLoginTime הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
orgUnitPath הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
agreedToTerms הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
externalIds הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
ipWhitelisted הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
kind הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
isEnforcedIn2Sv הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
isMailboxSetup הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
emails הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
organizations הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
primaryEmail הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
name הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
gender הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
creationTime הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
changePasswordAtNextLogin הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
customerId הפונקציה מחזירה אם הוא קיים בתוצאת JSON.
תוצאה בפורמט JSON

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

[{
    "Phones":
       [{
          "customType": "",
          "type": "custom",
          "value": "(800) 555‑0175"
       }],
   "isDelegatedAdmin": false,
   "suspended": false,
   "id": "ID",
   "nonEditableAliases": ["user@example.com"],
   "archived": false,
   "isEnrolledIn2Sv": true,
   "includeInGlobalAddressList": true,
   "Relations":
        [{
          "type": "manager",
          "value": "user@example.com"
        }],
   "isAdmin": false,
   "etag": "E_TAG_VALUE",
   "lastLoginTime": "2019-02-11T12:24:41.000Z",
   "orgUnitPath": "/OU-1",
   "agreedToTerms": true,
   "externalIds": [{"type": "organization",
                    "value": ""}],
   "ipWhitelisted": false,
   "kind": "admin#directory#user",
   "isEnforcedIn2Sv": true,
   "isMailboxSetup": true,
   "emails":
       [{
          "primary": true,
          "address": "user@example.com"
        },
        {
          "address": "user@example.com"
        }],
    "organizations":
        [{
           "department": "R&D",
           "customType": "", "name": "Company"
         }],
     "primaryEmail": "user@example.com",
     "name":
         {
            "fullName": "NAME SURNAME",
            "givenName": "NAME",
            "familyName": "SURNAME"
         },
     "gender": {"type": "male"},
     "creationTime": "2017-10-26T06:57:13.000Z",
     "changePasswordAtNextLogin": false,
     "customerId": "CUSTOMER_ID"
}]
תוצאת הסקריפט

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

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

קבלת פרטי התוסף

אפשר להשתמש בפעולה קבלת פרטי תוסף כדי לאחזר מידע על תוסף ל-Chrome ספציפי.

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

הוספת נתונים לפעולה

הפעולה Get Extension Details (קבלת פרטי התוסף) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Extension ID

חובה.

רשימה מופרדת בפסיקים של מזהי תוספים להוספה.
Max Requesting Users To Return

חובה.

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

הערך המקסימלי הוא 1000.
Max Requesting Devices To Return

חובה.

המספר המקסימלי של מכשירים שיוחזרו, שבהם נשלחה בקשה להתקנת התוסף.

הערך המקסימלי הוא 1000.

פלטים של פעולות

הפעולה Get Extension Details (קבלת פרטי התוסף) מספקת את הפלט הבא:

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

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Get Extension Details:

[
  {
    "Entity": "Example Extension Name",
    "EntityResult": {
      "name": "customers/example-customer-id/apps/chrome/exampleextensionid",
      "displayName": "Example Extension Name",
      "description": "A description for an example extension.",
      "appId": "exampleextensionid",
      "revisionId": "11.3.0.0",
      "type": "CHROME",
      "iconUri": "https://lh3.googleusercontent.com/KxYKwMcAzhn_DBMVIb0mtvIOsAME2d8-csv5d_vnKYX6PL3D6BGbVy3hH68ky8nM9yTDGAPl6B77pA7tpu4_jeUkXw",
      "detailUri": "https://chromewebstore.google.com/detail/exampleextensionid",
      "firstPublishTime": "2011-12-14T06:57:01.918Z",
      "latestPublishTime": "2025-07-01T02:05:04.252Z",
      "publisher": "example-publisher",
      "reviewNumber": "5423",
      "reviewRating": 4,
      "chromeAppInfo": {
        "supportEnabled": true,
        "minUserCount": 3000000,
        "permissions": [
          {
            "type": "offscreen"
          },
          {
            "type": "scripting",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/scripting/",
            "accessUserData": false
          },
          {
            "type": "storage",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/storage/",
            "accessUserData": false
          },
          {
            "type": "tabs",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/tabs#type-Tab",
            "accessUserData": true
          }
        ],
        "siteAccess": [
          {
            "hostMatch": "https://*/*"
          },
          {
            "hostMatch": "http://*/*"
          }
        ],
        "isTheme": false,
        "googleOwned": true,
        "isCwsHosted": true,
        "kioskEnabled": false,
        "isKioskOnly": false,
        "type": "EXTENSION",
        "isExtensionPolicySupported": false,
        "manifestVersion": "3",
        "requestingUserDetails": [
          {
            "email": "user@example.com",
            "justification": "Example justification for the request."
          }
        ],
        "requestingDeviceDetails": [
          {
            "device": "example-device-id",
            "justification": "Example justification for the request."
          }
        ]
      }
    }
  }
]
הודעות פלט

הפעולה Get Extension Details יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully returned information about the following extensions in Google Workspace: EXTENSION_IDS.

Action wasn't able to return information about the following extension in Google Workspace: EXTENSION_IDS.

No information about the provided extensions were found.

 הפעולה הסתיימה בהצלחה.
Error executing action "Get Extension Details". Reason: ERROR_REASON

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

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

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

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

קבלת פרטי קבוצה

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

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

הוספת נתונים לפעולה

הפעולה Get Group Details דורשת את הפרמטרים הבאים:

פרמטר תיאור
Group Email Addresses

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל של קבוצות לבדיקה.

פלטים של פעולות

הפעולה Get Group Details מספקת את הפלט הבא:

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

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

{
        "Entity": "group@example.com",
        "EntityResult": {
            "kind": "groupsSettings#groups",
            "email": "group@example.com",
            "name": "GROUP_NAME",
            "description": "DESCRIPTION",
            "whoCanJoin": "CAN_REQUEST_TO_JOIN",
            "whoCanViewMembership": "ALL_MEMBERS_CAN_VIEW",
            "whoCanViewGroup": "ALL_MEMBERS_CAN_VIEW",
            "whoCanInvite": "ALL_MANAGERS_CAN_INVITE",
            "whoCanAdd": "ALL_MANAGERS_CAN_ADD",
            "allowExternalMembers": "false",
            "whoCanPostMessage": "ANYONE_CAN_POST",
            "allowWebPosting": "true",
            "primaryLanguage": "en_US",
            "maxMessageBytes": 26214400,
            "isArchived": "false",
            "archiveOnly": "false",
            "messageModerationLevel": "MODERATE_NONE",
            "spamModerationLevel": "MODERATE",
            "replyTo": "REPLY_TO_IGNORE",
            "includeCustomFooter": "false",
            "customFooterText": "",
            "sendMessageDenyNotification": "false",
            "defaultMessageDenyNotificationText": "",
            "showInGroupDirectory": "true",
            "allowGoogleCommunication": "false",
            "membersCanPostAsTheGroup": "false",
            "messageDisplayFont": "DEFAULT_FONT",
            "includeInGlobalAddressList": "true",
            "whoCanLeaveGroup": "ALL_MEMBERS_CAN_LEAVE",
            "whoCanContactOwner": "ANYONE_CAN_CONTACT",
            "whoCanAddReferences": "NONE",
            "whoCanAssignTopics": "NONE",
            "whoCanUnassignTopic": "NONE",
            "whoCanTakeTopics": "NONE",
            "whoCanMarkDuplicate": "NONE",
            "whoCanMarkNoResponseNeeded": "NONE",
            "whoCanMarkFavoriteReplyOnAnyTopic": "NONE",
            "whoCanMarkFavoriteReplyOnOwnTopic": "NONE",
            "whoCanUnmarkFavoriteReplyOnAnyTopic": "NONE",
            "whoCanEnterFreeFormTags": "NONE",
            "whoCanModifyTagsAndCategories": "NONE",
            "favoriteRepliesOnTop": "true",
            "whoCanApproveMembers": "ALL_MANAGERS_CAN_APPROVE",
            "whoCanBanUsers": "OWNERS_AND_MANAGERS",
            "whoCanModifyMembers": "OWNERS_AND_MANAGERS",
            "whoCanApproveMessages": "OWNERS_AND_MANAGERS",
            "whoCanDeleteAnyPost": "OWNERS_AND_MANAGERS",
            "whoCanDeleteTopics": "OWNERS_AND_MANAGERS",
            "whoCanLockTopics": "OWNERS_AND_MANAGERS",
            "whoCanMoveTopicsIn": "OWNERS_AND_MANAGERS",
            "whoCanMoveTopicsOut": "OWNERS_AND_MANAGERS",
            "whoCanPostAnnouncements": "OWNERS_AND_MANAGERS",
            "whoCanHideAbuse": "NONE",
            "whoCanMakeTopicsSticky": "NONE",
            "whoCanModerateMembers": "OWNERS_AND_MANAGERS",
            "whoCanModerateContent": "OWNERS_AND_MANAGERS",
            "whoCanAssistContent": "NONE",
            "customRolesEnabledForSettingsToBeMerged": "false",
            "enableCollaborativeInbox": "false",
            "whoCanDiscoverGroup": "ALL_IN_DOMAIN_CAN_DISCOVER",
            "defaultSender": "DEFAULT_SELF"
        }
    }
הודעות פלט

הפעולה קבלת פרטי קבוצה מספקת את הודעות הפלט הבאות:

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

Successfully enriched the following groups using information from Google Workspace: GROUPS

Action wasn't able to enrich the following group using information from Google Workspace: GROUPS

None of the groups were enriched.

 הפעולה הסתיימה בהצלחה.
Error executing action "Get Group Details". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורטים הערכים של פלט התוצאות של הסקריפט כשמשתמשים בפעולה Get Group Details:

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

קבלת פרטים על הדפדפן של המארח

משתמשים בפעולה Get Host Browser Details (קבלת פרטים על דפדפן המארח) כדי לאחזר מידע על דפדפנים שמשויכים לישות ספציפית של Google SecOps Hostname.

הפעולה הזו מופעלת בישות Hostname של Google SecOps.

הוספת נתונים לפעולה

אין.

פלטים של פעולות

הפעולה Get Host Browser Details מספקת את הפלט הבא:

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

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל באמצעות הפעולה Get Host Browser Details (קבלת פרטים על דפדפן המארח):

{
   "Entity": "example.host.com",
   "EntityResult": [
      {
         "deviceId": "example-device-id",
         "kind": "admin#directory#browserdevice",
         "lastPolicyFetchTime": "2025-07-25T12:11:17.546Z",
         "osPlatform": "Linux",
         "osArchitecture": "x86_64",
         "osVersion": "6.12.27-1rodete1-amd64",
         "machineName": "example.host.com",
         "lastRegistrationTime": "2025-07-07T07:45:20.504Z",
         "extensionCount": "15",
         "policyCount": "23",
         "lastDeviceUser": "example-user",
         "lastActivityTime": "2025-07-26T12:13:55.385Z",
         "osPlatformVersion": "Linux 6.12.27-1rodete1-amd64",
         "browserVersions": [
            "140.0.7259.2 (Dev)"
         ],
         "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
         "lastDeviceUsers": [
            {
               "userName": "example-user",
               "lastStatusReportTime": "2025-07-26T07:46:00.919Z"
            }
         ],
         "machinePolicies": [
            {
               "source": "MACHINE_LEVEL_USER_CLOUD",
               "name": "CloudReportingEnabled",
               "value": "true"
            }
         ],
         "browsers": [
            {
               "browserVersion": "140.0.7259.2",
               "channel": "DEV",
               "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
               "executablePath": "/opt/google/chrome-unstable",
               "profiles": [
                  {
                     "name": "Example User Profile",
                     "id": "/home/example_user/.config/google-chrome/Default",
                     "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
                     "lastPolicyFetchTime": "2025-07-25T12:11:17.546Z",
                     "chromeSignedInUserEmail": "user@example.com",
                     "extensions": [
                        {
                           "extensionId": "exampleextensionid",
                           "version": "2.0.6",
                           "permissions": [
                              "alarms",
                              "contextMenus",
                              "management",
                              "storage",
                              "https://accounts.google.com/*",
                              "https://appengine.google.com/*",
                              "https://example.com/*",
                              "https://example.org/*",
                              "https://example-api.com/*",
                              "https://docs.example.com/*",
                              "https://internal.example.net/*",
                              "https://partners.example.com/*",
                              "https://www.google.com/*"
                           ],
                           ],
                           "name": "Example Extension",
                           "description": "This is a description for an example extension.",
                           "appType": "EXTENSION",
                           "homepageUrl": "https://chromewebstore.google.com/detail/exampleextensionid",
                           "installType": "ADMIN",
                           "manifestVersion": 3
                        }
                     ],
                     "userPolicies": [
                        {
                           "source": "USER_CLOUD",
                           "name": "CloudProfileReportingEnabled",
                           "value": "true"
                        }
                     ]
                  }
               ],
               "pendingInstallVersion": "140.0.7312.0"
            }
         ],
         "virtualDeviceId": "example-virtual-device-id",
         "orgUnitPath": "/",
         "deviceIdentifiersHistory": {
            "records": [
               {
                  "identifiers": {
                     "machineName": "example.host.com"
                  },
                  "firstRecordTime": "2025-06-03T08:06:33.895Z",
                  "lastActivityTime": "2025-07-26T07:46:01.325Z"
               }
            ]
         }
      }
   ]
}
הודעות פלט

הפעולה Get Host Browser Details יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully returned browsers related to the following hostnames in Google Workspace: HOSTNAME.

No browsers were associated with the following hostnames in Google Workspace: HOSTNAME.

No browsers were associated with provided hostnames.

 הפעולה הסתיימה בהצלחה.
Error executing action "Get Host Browser Details". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Get Host Browser Details:

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

הצגת חברי הקבוצה

משתמשים בפעולה List Group Members כדי להציג את רשימת החברים בקבוצת Google Workspace.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

אפשר להשתמש בפעולה List Group Members כדי לפתור את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

הפעולה List Group Members (רשימת חברי הקבוצה) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Group Email Address

חובה.

כתובת האימייל של הקבוצה.
Include Derived Membership

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

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

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

פלטים של פעולות

הפעולה List Group Members מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

{
   "status": "ACTIVE",
   "kind": "admin#directory#member",
   "email": "user1@example.com",
   "etag": "E_TAG_VALUE",
   "role": "MEMBER",
   "type": "USER",
   "id": "ID"
  },{
   "status": "ACTIVE",
   "kind": "admin#directory#member",
   "email": "user2@example.com",
   "etag": "E_TAG_VALUE",
   "role": "MEMBER",
   "type": "USER", "id": "ID"
}
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List Group Members:

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

הצגת ההרשאות בקבוצה

משתמשים בפעולה List Group Privileges כדי להציג את התפקידים וההרשאות שקשורים לקבוצה ב-Google Workspace.

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

הוספת נתונים לפעולה

הפעולה List Group Privileges (הצגת הרשאות של קבוצה) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Group Email Addresses

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

רשימה מופרדת בפסיקים של קבוצות לבדיקה.
Check Roles

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

רשימה מופרדת בפסיקים של תפקידים שקשורים לקבוצה.
Check Privileges

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

רשימה מופרדת בפסיקים של הרשאות שקשורות לקבוצה.

כדי להשתמש בפרמטר הזה, צריך לבחור בפרמטר הרחבת הרשאות. אם הגדרתם את הפרמטר Check Roles, הפעולה בודקת את ההרשאות רק לתפקידים שציינתם.
Expand Privileges

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

אם נבחרה, הפעולה מחזירה מידע על כל ההרשאות הייחודיות שקשורות לקבוצה.
Max Roles To Return

חובה.

המספר המקסימלי של תפקידים שקשורים לקבוצה שיוחזרו.

ערך ברירת המחדל הוא 100.
Max Privileges To Return

חובה.

המספר המקסימלי של הרשאות שקשורות לקבוצה שיוחזרו.

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

פלטים של פעולות

הפעולה List Group Privileges מספקת את התוצאות הבאות:

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

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

{
    "Entity": "user@example.com",
    "EntityResult": {
        "roles": [
            "Role1",
            "_GROUPS_EDITOR_ROLE",
            "example-role"
        ],
        "unique_privileges": [
            "VIEW_SITE_DETAILS",
            "ACCESS_EMAIL_LOG_SEARCH",
            "ACCESS_ADMIN_QUARANTINE",
            "ACCESS_RESTRICTED_QUARANTINE",
            "ADMIN_QUALITY_DASHBOARD_ACCESS",
            "MANAGE_DLP_RULE",
            "DASHBOARD_ACCESS",
            "MANAGE_GSC_RULE",
            "VIEW_GSC_RULE",
            "SECURITY_HEALTH_DASHBOARD_ACCESS",
            "SIT_CALENDAR_VIEW_METADATA",
            "SIT_CHAT_VIEW_METADATA",
            "SIT_CHROME_VIEW_METADATA",
            "SIT_DEVICE_UPDATE_DELETE",
            "SIT_DEVICE_VIEW_METADATA",
            "SIT_DRIVE_UPDATE_DELETE"
        ]
    }
}
הודעות פלט

הפעולה List Group Privileges מספקת את הודעות הפלט הבאות:

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

Successfully fetched information for the following groups using information from Google Workspace: GROUPS

Action wasn't able to fetch information for the following groups using information from Google Workspace: GROUPS

None of the specific roles/privileges were found for the following groups in Google Workspace: GROUPS

None of the specific roles/privileges were found for the provided groups in Google Workspace.

No information was found for the provided groups in Google Workspace.

 הפעולה הסתיימה בהצלחה.
Error executing action "List Group Privileges". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List Group Privileges:

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

רשימת היחידות הארגוניות של החשבון

משתמשים בפעולה List OU of Account כדי להציג רשימה של יחידות ארגוניות בחשבון.

הפעולה הזו מופעלת בכל הישויות ב-Google SecOps.

אפשר להשתמש בפעולה List OU of Account כדי לפתור את תרחישי השימוש הבאים:

  • אוטומציה של הסרת משתמשים.
  • לבצע ביקורת אבטחה ממוקדת.
  • אוטומציה של ניהול החברות בקבוצה.
  • לייעל את הקצאת ההרשאות למשתמשים.
  • אוטומציה של דיווחים וביקורות בנושא תאימות.

נתוני קלט של שילוב

הפעולה List OU of Account (הצגת יחידה ארגונית בחשבון) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Customer ID

חובה.

מזהה ייחודי של חשבון Google Workspace של הלקוח.

כדי לייצג את הערך customerId של החשבון, משתמשים בפלייס הולדר my_customer.
Organization Unit Path

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

הנתיב של היחידה הארגונית שרוצים להחזיר.

ערך ברירת המחדל הוא /.
Max Organization Units

חובה.

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

הערך המקסימלי הוא 100.

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

פלטים של פעולות

הפעולה List OU of Account (רשימת יחידות ארגוניות של חשבון) מספקת את התוצאות הבאות:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[{
   "kind": "admin#directory#orgUnit",
   "parentOrgUnitPath": "/",
   "name": "OU-1",
   "etag": "E_TAG_VALUE",
   "orgUnitPath": "/OU-1",
   "parentOrgUnitId": "id:1455",
   "blockInheritance": false,
   "orgUnitId": "id:123",
   "description": ""
}]
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט התוצאה של הסקריפט כשמשתמשים בפעולה List OU of Account:

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

רשימת הרשאות המשתמש

משתמשים בפעולה List User Privileges כדי להציג רשימה של תפקידים והרשאות שקשורים למשתמש ב-Google Workspace.

הפעולה הזו מופעלת בישות User של Google SecOps.

הוספת נתונים לפעולה

הפעולה List User Privileges דורשת את הפרמטרים הבאים:

פרמטר תיאור
User Email Addresses

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

רשימה מופרדת בפסיקים של משתמשים לבדיקה.

הפעולה מבצעת ערכים שאתם מגדירים לפרמטר הזה לצד הישות User.
Check Roles

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

רשימה מופרדת בפסיקים של תפקידים שקשורים למשתמש.
Check Privileges

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

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

כדי להשתמש בפרמטר הזה, צריך לבחור בפרמטר הרחבת הרשאות. אם הגדרתם את הפרמטר Check Roles, הפעולה בודקת את ההרשאות רק לתפקידים שציינתם.
Include Inherited Roles

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

אם בוחרים באפשרות הזו, הפעולה מחזירה גם את תפקידי המשתמש שעברו בירושה מקבוצות.
Expand Privileges

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

אם בוחרים באפשרות הזו, הפעולה מחזירה מידע על כל ההרשאות הייחודיות שקשורות למשתמש.
Max Roles To Return

חובה.

מספר התפקידים המקסימלי שקשורים למשתמש שיוחזרו.

ערך ברירת המחדל הוא 100.
Max Privileges To Return

חובה.

מספר ההרשאות המקסימלי שקשורות למשתמש שיוחזרו.

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

פלטים של פעולות

הפעולה List User Privileges מספקת את הפלט הבא:

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

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

{
    "Entity": "user@example.com",
    "EntityResult": {
        "roles": [
            "Role1",
            "_GROUPS_EDITOR_ROLE",
            "example-role"
        ],
        "unique_privileges": [
            "VIEW_SITE_DETAILS",
            "ACCESS_EMAIL_LOG_SEARCH",
            "ACCESS_ADMIN_QUARANTINE",
            "ACCESS_RESTRICTED_QUARANTINE",
            "ADMIN_QUALITY_DASHBOARD_ACCESS",
            "MANAGE_DLP_RULE",
            "DASHBOARD_ACCESS",
            "MANAGE_GSC_RULE",
            "VIEW_GSC_RULE",
            "SECURITY_HEALTH_DASHBOARD_ACCESS",
            "SIT_CALENDAR_VIEW_METADATA",
            "SIT_CHAT_VIEW_METADATA",
            "SIT_CHROME_VIEW_METADATA",
            "SIT_DEVICE_UPDATE_DELETE",
            "SIT_DEVICE_VIEW_METADATA",
            "SIT_DRIVE_UPDATE_DELETE"
        ]
    }
}
הודעות פלט

הפעולה List User Privileges (רשימת הרשאות המשתמש) מספקת את הודעות הפלט הבאות:

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

Successfully enriched the following users using information from Google Workspace: USERS

Action wasn't able to enrich the following users using information from Google Workspace: USERS

None of the specific roles/privileges were found for the following users in Google Workspace: USERS

None of the specific roles/privileges were found for the provided users in Google Workspace.

None of the provided users were enriched in Google Workspace.

הפעולה הסתיימה בהצלחה.
Error executing action "List User Privileges". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורטים הערכים של פלט התוצאה של הסקריפט כשמשתמשים בפעולה List User Privileges:

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

רשימת משתמשים

משתמשים בפעולה List Users כדי להציג רשימה של משתמשים בחשבון.

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

אפשר להשתמש בפעולה List Users כדי לפתור את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

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

פרמטר תיאור
Customer ID

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

מזהה ייחודי של חשבון Google Workspace של הלקוח.

אם לא מציינים את ערך הפרמטר הזה, הפעולה משתמשת באופן אוטומטי ב-placeholder‏ my_customer כדי לייצג מזהה לקוח של החשבון.
Domain

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

דומיין לחיפוש משתמשים.
Manager Email

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

כתובת האימייל של המנהל של המשתמש.
Return Only Admin Accounts?

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

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

האפשרות הזו לא מסומנת כברירת מחדל.
Return Only Delegated Admin Accounts?

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

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

האפשרות הזו לא מסומנת כברירת מחדל.
Return Only Suspended Users?

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

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

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

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

נתיב מלא של יחידה ארגונית שממנה יאוחזרו המשתמשים. הנתיב תואם לכל שרשראות היחידות הארגוניות שמופיעות מתחת ליחידת היעד.
Department

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

מחלקה בארגון שממנה רוצים לאחזר את המשתמשים.
Record Limit

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

המספר המקסימלי של רשומות נתונים שהפעולה תחזיר.

ערך ברירת המחדל הוא 20.
Custom Query Parameter

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

פרמטר מותאם אישית של שאילתה שמוסיפים לרשימת המשתמשים בשיחת החיפוש, כמו orgName='Human Resources'.

אפשר להגדיר את הפרמטר הזה בשדה email, או להשאיר את השדה email ריק ולהגדיר את הפרמטר Email Addresses. אם מגדירים גם את השדה email וגם את הפרמטר Email Addresses, השאילתה שנוצרת נכשלת.
Return only users without 2fa?

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

אם בוחרים באפשרות הזו, הפעולה מחזירה רק משתמשים שלא הפעילו אימות דו-שלבי (2FA).

לא מסומן כברירת מחדל.
Email Addresses

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

רשימה של כתובות אימייל שמופרדות בפסיקים.

אם מגדירים את הפרמטר הזה, לא מגדירים את השדה email בפרמטר Custom Query Parameter.

אם מגדירים את הפרמטר הזה, הפעולה מתעלמת מהפרמטר Record Limit.

פלטים של פעולות

הפעולה List Users מספקת את התוצאות הבאות:

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

הפעולה List Users מספקת את הטבלה הבאה ב-Case Wall:

שם הטבלה: משתמשי Google G Suite

עמודות בטבלה:

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

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

{
    "kind": "admin#directory#users",
    "etag": "E_TAG_VALUE",
    "users": [
        {
            "kind": "admin#directory#user",
            "id": "ID",
            "etag": "E_TAG_VALUE",
            "primaryEmail": "user@example.com",
            "name": {
                "givenName": "NAME",
                "familyName": "SURNAME",
                "fullName": "NAME SURNAME"
            },
            "isAdmin": true,
            "isDelegatedAdmin": false,
            "lastLoginTime": "2020-12-22T06:40:34.000Z",
            "creationTime": "2020-07-22T09:23:28.000Z",
            "agreedToTerms": true,
            "suspended": false,
            "archived": false,
            "changePasswordAtNextLogin": false,
            "ipWhitelisted": false,
            "emails": [
                {
                    "address": "user@example.com",
                    "primary": true
                },
                {
                    "address": "user@example.com"
                }
            ],
            "nonEditableAliases": [
                "user@example.com"
            ],
            "customerId": "CUSTOMER_ID",
            "orgUnitPath": "/Management",
            "isMailboxSetup": true,
            "isEnrolledIn2Sv": false,
            "isEnforcedIn2Sv": false,
            "includeInGlobalAddressList": true,
            "recoveryEmail": "email@example.com"
        }
    ]
}
הודעות פלט

הפעולה List Users מספקת את הודעות הפלט הבאות:

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

Action successfully returned the Google Workspace Directory user list.

No users were returned.

 הפעולה הסתיימה בהצלחה.
Failed to connect to the Google Workspace! Error is ERROR_REASON

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

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

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

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

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Google Workspace.

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

הוספת נתונים לפעולה

אין.

פלטים של פעולות

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

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

הסרת התוסף

משתמשים בפעולה הסרת תוסף כדי להסיר התקנה של תוסף ל-Chrome ספציפי מכל הדפדפנים הרשומים ביחידה ארגונית ייעודית.

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

הוספת נתונים לפעולה

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

פרמטר תיאור
Organization Unit Name

חובה.

השם של היחידה הארגונית שממנה רוצים להסיר את התוסף.
Extension ID

חובה.

המזהה של התוסף שרוצים להסיר.

פלטים של פעולות

הפעולה הסרת תוסף מספקת את הפלטים הבאים:

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

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

[
  {
    "removed_extensions": ["chrome:exampleextensionid"]
  }
]
הודעות פלט

הפעולה Remove Extension יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully removed extension EXTENSION_ID from Organization Unit ORGANIZATION_NAME using Google Workspace.

 הפעולה הסתיימה בהצלחה.
Error executing action "Remove Extension". Reason: ERROR_REASON

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

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

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Remove Extension:

שם התוצאה של הסקריפט ערך
is_success true או false

הסרת חברים מהקבוצה

משתמשים בפעולה Remove Members From Group כדי להסיר חברים מקבוצה ב-Google Workspace.

הפעולה הזו מופעלת בישות User של Google SecOps.

אפשר להשתמש בפעולה List Users כדי לפתור את תרחישי השימוש הבאים:

  • אוטומציה של הסרת משתמשים.
  • ביצוע ניהול של קבוצות דינמיות.
  • תיקון בעיות בבקרת הגישה.

הוספת נתונים לפעולה

הפעולה הסרת חברים מהקבוצה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Group Email Address

חובה.

כתובת האימייל של הקבוצה שממנה רוצים להסיר את החברים.
User Email Addresses

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

רשימה מופרדת בפסיקים של משתמשים להסרה מהקבוצה.

הפעולה מבצעת ערכים שאתם מגדירים לפרמטר הזה לצד הישות User.

פלטים של פעולות

הפעולה Remove Members From Group מספקת את הפלטים הבאים:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

ביטול סשנים של משתמשים

משתמשים בפעולה ביטול סשנים של משתמשים כדי לבטל את הסשנים של המשתמש באינטרנט ובמכשיר ולאפס את קובצי ה-Cookie של פרטי הכניסה לחשבון ב-Google Workspace.

הפעולה הזו מופעלת בישות User של Google SecOps.

הוספת נתונים לפעולה

הפעולה Revoke User Sessions (ביטול סשנים של משתמשים) דורשת את הפרמטרים הבאים:

פרמטר תיאור
User Email Addresses

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

רשימה מופרדת בפסיקים של משתמשים שצריך להוציא מהחשבון. הפעולה מפעילה את הערכים מהפרמטר הזה עם ישויות של Google SecOps User.

פלטים של פעולות

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

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

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

[
   {
       "Entity": "ENTITY_ID",
       "EntityResult": {
           "Status": "done"
       }
   }
]
הודעות פלט

הפעולה ביטול סשנים של משתמשים יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully signed out the following users using Google Workspace: USERS

Action wasn't able to sign out the following users using Google Workspace: USERS

None of the provided users were found in Google Workspace.

הפעולה הסתיימה בהצלחה.
Error executing action "Revoke User Sessions". Reason: ERROR_REASON

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

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

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

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

חיפוש אירועים של פעילות משתמשים

משתמשים בפעולה חיפוש אירועי פעילות של משתמשים כדי לאחזר אירועי פעילות מאפליקציה עבור ישות User ספציפית ב-Google SecOps.

הפעולה הזו מופעלת בישות User של Google SecOps.

הוספת נתונים לפעולה

הפעולה Search User Activity Events (חיפוש אירועים של פעילות משתמש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
User Email Addresses

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

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

הפעולה מעבדת את כל המשתמשים ברשימה הזו בנוסף לישות User (אם היא מסופקת).
Application Names

חובה.

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

רשימה מלאה של האפליקציות הנתמכות זמינה במאמר בנושא ApplicationName.
Event Type Filter

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

רשימה מופרדת בפסיקים של סוגי אירועים לאחזור.
Time Frame

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

מסגרת הזמן של חיפוש הפעילות.

הערכים האפשריים הם:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom

אם נבחר הערך Custom, חובה לציין את הפרמטר Start Time.

ערך ברירת המחדל הוא Last Hour.
Start Time

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

תחילת טווח הזמן של חיפוש הפעילות.

חובה לכלול את הפרמטר הזה אם בוחרים באפשרות Custom לפרמטר Time Frame.

מגדירים את הערך בפורמט ISO 8601.
End Time

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

סוף טווח הזמן לחיפוש הפעילות.

הפרמטר הזה הוא אופציונלי אם בוחרים באפשרות Custom עבור הפרמטר Time Frame. אם לא מציינים ערך, ברירת המחדל היא השעה הנוכחית.

מגדירים את הערך בפורמט ISO 8601.
Max Events To Return

חובה.

מספר האירועים המקסימלי שיוחזרו לכל משתמש.

הפעולה מעבדת עד 1000 אירועים לכל משתמש, לכל אפליקציה.

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

הערך המקסימלי הוא 1000.

פלטים של פעולות

הפעולה חיפוש אירועים של פעילות משתמש מספקת את התוצאות הבאות:

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

בדוגמה הבאה מוצג פלט תוצאות ה-JSON שמתקבל כשמשתמשים בפעולה Search User Activity Events:

{
   "Entity": "user@example.com",
   "EntityResult": [
      {
         "applicationName": "login",
         "type": "login",
         "name": "login_success",
         "parameters": [
            {
               "name": "login_type",
               "value": "google_password"
            },
            {
               "name": "login_challenge_method",
               "multiValue": [
                  "password"
               ]
            },
            {
               "name": "is_suspicious",
               "boolValue": false
            }
         ]
      },
      {
         "applicationName": "token",
         "type": "auth",
         "name": "authorize",
         "parameters": [
            {
               "name": "client_id",
               "value": "example-client-id.apps.googleusercontent.com"
            },
            {
               "name": "app_name",
               "value": "Google Chrome"
            },
            {
               "name": "client_type",
               "value": "NATIVE_DESKTOP"
            },
            {
               "name": "scope_data",
               "multiMessageValue": [
                  {
                     "parameter": [
                        {
                           "name": "scope_name",
                           "value": "https://www.google.com/accounts/OAuthLogin"
                        },
                        {
                           "name": "product_bucket",
                           "multiValue": [
                              "IDENTITY"
                           ]
                        }
                     ]
                  }
               ]
            },
            {
               "name": "scope",
               "multiValue": [
                  "https://www.google.com/accounts/OAuthLogin"
               ]
            }
         ]
      }
   ]
}
הודעות פלט

הפעולה חיפוש אירועים של פעילות משתמשים יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully found events for the following users in Google Workspace: USERS.

No events were found for the following users in Google Workspace: USERS.

No events were found for the provided users in Google Workspace.

 הפעולה הסתיימה בהצלחה.
Error executing action "Search User Activity Events". Reason: ERROR_REASON

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

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

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

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

עדכון היחידה הארגונית

משתמשים בפעולה Update OU כדי לעדכן יחידה ארגונית (OU).

הפעולה הזו מופעלת בכל הישויות של Google SecOps.

אפשר להשתמש בפעולה Update OU כדי לפתור את תרחישי השימוש הבאים:

  • ניהול קבוצות אבטחה.
  • אוטומציה של תהליך ההצטרפות והעזיבה של משתמשים.
  • הטמעה של מדיניות להפרדת נתונים.

הוספת נתונים לפעולה

הפעולה Update OU (עדכון יחידה ארגונית) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Customer ID

חובה.

מזהה ייחודי של חשבון Google Workspace של הלקוח.

כדי לייצג את הערך customerId של החשבון, משתמשים בפלייס הולדר my_customer.
Name

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

שם היחידה הארגונית.
Description

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

תיאור של היחידה הארגונית.
OU Path

חובה.

נתיב מלא ליחידה הארגונית.

אם היחידה הארגונית נמצאת מתחת לנתיב הבסיס, /, צריך לציין רק את שם היחידה הארגונית ללא נתיב.

פלטים של פעולות

הפעולה Update OU מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
Case wall attachment לא זמין
קישור לקיר של תיק לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

עדכון משתמש

משתמשים בפעולה Update User (עדכון משתמש) כדי לעדכן משתמש בספרייה של Google Workspace.

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

אפשר להשתמש בפעולה Update User כדי לפתור את תרחישי השימוש הבאים:

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

הוספת נתונים לפעולה

הפעולה Update User (עדכון משתמש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Email Address

חובה.

רשימה מופרדת בפסיקים של כתובות אימייל ראשיות שמשמשות לזיהוי המשתמשים שצריך לעדכן.
Given Name

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

השם הפרטי של המשתמש.
Family Name

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

שם המשפחה של המשתמש.
Password

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

הסיסמה של המשתמש החדש.
Phone

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

מספר הטלפון של המשתמש.

הפעולה מעדכנת את סוג מספר הטלפון custom.
Gender

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

המגדר של המשתמש.

הערכים התקפים הם: female, ‏ male, ‏ other,‏ unknown.
Department

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

השם של המחלקה של המשתמש.
Organization

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

שם הארגון של המשתמש.
Change Password At Next Login

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

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

לא מסומן כברירת מחדל.
User Status

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

סטטוס המשתמש שרוצים לעדכן.

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

הערכים האפשריים הם:
  • Not Changed
  • Blocked
  • Unblocked

פלטים של פעולות

הפעולה Update User מספקת את התוצאות הבאות:

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

הפעולה עדכון משתמש מספקת את הודעות הפלט הבאות:

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

Successfully updated the following users in Google Workspace: EMAIL_ADDRESSES.

Action wasn't able to update the following users in Google Workspace: EMAIL_ADDRESSES

None of the provided users were updated.

 הפעולה הסתיימה בהצלחה.
Error executing action "Update User". Reason: ERROR_REASON

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

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

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

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

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