שילוב של Active Directory עם Google SecOps

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

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

השילוב עם Active Directory משתמש ביכולות של Google SecOps כדי לתמוך בתרחישי השימוש הבאים:

  • הפעלה והשבתה של משתמשים: השבתה של חשבון משתמש שעלול להיות פרוץ ומניעת גישה לא מורשית נוספת.

  • איפוס סיסמאות: איפוס אוטומטי של סיסמת המשתמש ב-Active Directory ושליחת הודעה למשתמש על השינוי.

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

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

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

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

לפני שמגדירים את השילוב של Active Directory ב-Google SecOps, צריך לוודא שסביבת הרשת, Active Directory Domain Services ‏ (AD DS) ופרטי הכניסה של חשבון השירות עומדים בכל הדרישות המוקדמות להפעלה.

כדי להכין את הסביבה לשילוב, צריך לוודא שמתקיימים התנאים הבאים:

  1. מאמתים את קישוריות הרשת ואת פענוח ה-DNS בין מופע Google SecOps (או סוכן מרוחק) לבין בקרי הדומיין של Active Directory.

  2. אם מתחברים באמצעות LDAPS (יציאה 636) (נדרש לאיפוס סיסמאות), צריך לוודא שמוגדרים אישורים של ספרייה. אם משתמשים ברשות אישורים (CA) פנימית, צריך להכין את אישור הבסיס או הביניים של ה-CA לקידוד base64.

  3. יוצרים חשבון שירות ייעודי ב-Active Directory בהתאם לעיקרון של הרשאות מינימליות (PoLP).

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

  5. הקצאת הרשאות ביחידות ארגוניות (OU) באמצעות Active Directory Users and Computers‏ (ADUC) או PowerShell‏ (dsacls). חשוב לוודא שלחשבון השירות יש גישת קריאה וכתיבה מפורשת למאפיין userAccountControl.

דרישות רשת ו-DNS

‫Google SecOps מתקשר ישירות עם בקרי דומיין של Active Directory באמצעות Lightweight Directory Access Protocol ‏ (LDAP או LDAPS) דרך TCP.

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

  • קישוריות ליציאות: מוודאים שחומות האש והניתוב ברשת מאפשרים תקשורת יוצאת מ-Google SecOps (או מהסוכן המרוחק) אל בקרי הדומיין של Active Directory ביציאות הבאות:

    • ‫LDAP (רגיל): פתיחת יציאה 389/TCP לתקשורת LDAP לא מוצפנת.
    • ‫LDAPS (מומלץ – חובה לסיסמאות): פתיחת יציאה 636/TCP (או יציאת SSL/TLS מותאמת אישית). נדרש LDAPS לתעבורת נתונים מוצפנת בספרייה, והוא חובה לפעולות של שינוי סיסמה, כמו הגדרת סיסמת משתמש.

  • DNS ופתרון של שמות מארחים: כדי להתאים אישורים של SSL/TLS וקישורי שירות מדריך, Active Directory דורש פתרון מדויק של שמות מארחים. אם הדומיין שלכם מפוענח על ידי שם DNS שמוגדר במלואו דרך הגדרת ה-DNS הפנימית שלכם, לא נדרשת הגדרה נוספת של המארח. אם אין אפשרות לפתור את ה-DNS בתמונת מאגר הסוכן המרוחק, צריך להגדיר את הקובץ /etc/hosts.

הגדרת הקובץ /etc/hosts

ב-Active Directory נדרש זיהוי מדויק של שם המארח כדי להתאים לאישורי SSL/TLS ולקישורי שירותי מדריך. אם הסוכן המרוחק לא יכול להחזיר את כתובת ה-IP של בקר הדומיין של Active Directory באמצעות DNS, צריך למפות את המארח באופן ידני.

כדי להגדיר את הקובץ /etc/hosts, מבצעים את השלבים הבאים:

  1. פותחים את הקובץ /etc/hosts בכלי לעריכת טקסט עם הרשאות אדמין:

    sudo vi /etc/hosts

  2. מוסיפים רשומה שממפה את כתובת ה-IP של בקר הדומיין לשם הדומיין שמוגדר במלואו (FQDN):

    192.0.2.195 dc01.example.local

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

אם אתם לא צריכים אישור CA לשילוב, אתם יכולים להמשיך להגדרה של דרישות האימות וחשבון השירות. אחרת, צריך להגדיר את אישור ה-CA.

(אופציונלי) הגדרת אישור CA

כשמתחברים דרך LDAPS (יציאה 636) באמצעות אישורים שהונפקו על ידי רשות אישורים פרטית או פנימית, צריך לספק את מחרוזת האישור בקידוד base64 במהלך ההגדרה כדי ליצור חיבור TLS מהימן.

כדי להגדיר ולהעלות את אישור ה-CA, מבצעים את השלבים הבאים:

  1. מצפינים את קובץ האישור בפורמט PEM:

    • ‫Linux: bash base64 -w 0 mycert.crt

    • ‫macOS: bash base64 -i mycert.crt

  2. מעתיקים את מחרוזת הפלט המלאה (כולל כותרות מקודדות) ומדביקים אותה בשדה CA Certificate File - parsed into Base64 String בהגדרת השילוב של Google SecOps.

  3. מגדירים את הפרמטר Server לשם הדומיין שמוגדר במלואו (FQDN) של בקר הדומיין (ולא לכתובת ה-IP שלו) כדי ששם המארח יתאים לשם הנפוץ (CN) או לשם הנושא החלופי (SAN) באישור.

  4. לוחצים על בדיקה כדי לאמת את לחיצת היד של TLS.

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

השילוב של Active Directory מאמת באמצעות פרטי כניסה רגילים של AD DS.

חשוב לוודא שהגדרת האימות עומדת בשיטות המומלצות הבאות לאבטחה:

  • חשבון שירות ייעודי: יוצרים חשבון שירות ייעודי (למשל svc_secops_ad) במיוחד בשביל פלייבוקים אוטומטיים של Google SecOps. אל תשתמשו בחשבונות משתמשים אינטראקטיביים או בחשבונות אדמין מובנים בדומיין.

  • פורמט שם המשתמש: אפשר לספק את שם המשתמש כשם משתמש ראשי (UPN) (למשל svc_secops@example.local) או כשם כניסה ברמה נמוכה יותר (EXAMPLE\svc_secops).

  • PoLP: אל תוסיפו את חשבון השירות לקבוצות מובנות עם הרשאות מיוחדות, כמו Domain Admins, ‏ Enterprise Admins או Account Operators. במקום זאת, כדאי להעניק הרשאות גרנולריות ליחידות ארגוניות ספציפיות שבהן נמצאים אובייקטים של משתמשים, מחשבים או קבוצות.

הגדרת הרשאות לפעולות (הרשאות מינימליות)

מעניקים לחשבון השירות שמשמש לאימות את ההרשאות הספציפיות של Active Directory ואת הגישה למאפייני LDAP שנדרשים לפעולות שמבוצעות ב-Playbook.

בטבלה הבאה מפורטות ההרשאות המינימליות לפעולות ב-Active Directory:

שם הפעולה הרשאה נדרשת ב-AD DS / זכות מורחבת הסיווג של אובייקט היעד תיאור / היקף המאפיין
Ping Read Property משתמש, דומיין בסיס מבצע שאילתה על אובייקט חשבון השירות שהוגדר (sAMAccountName,‏ userPrincipalName, ‏ mail) כדי לאמת את הקישוריות ואת פרטי הכניסה של הספרייה.
העשרת ישויות
  • List Contents
  • Read Property (מאפייני היעד: userAccountControl, sAMAccountName, mail, memberOf, lockoutTime, pwdLastSet)
 משתמש, מחשב, קבוצה שאילתות לגבי מאפייני משתמשים ומחשבים, ופתרון של חברויות מקוננות בקבוצות. נדרש Read Property ב-userAccountControl כדי למנוע שגיאות של אינדקסים ריקים.
השבתת החשבון
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 משתמש קריאה והגדרה של הדגל ACCOUNTDISABLE (0x0002) באובייקט של משתמש היעד.
הפעלת החשבון
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 משתמש קריאה ומחיקה של הדגל ACCOUNTDISABLE (0x0002) באובייקט של משתמש היעד.
השבתת המחשב
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 מחשב קורא ומגדיר את הדגל ACCOUNTDISABLE באובייקט של מחשב היעד.
הפעלת המחשב
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 מחשב קורא ומנקה את הדגל ACCOUNTDISABLE באובייקט של מחשב היעד.
ביטול נעילה של חשבון Write Property: lockoutTime משתמש הגדרת המאפיין lockoutTime לערך 0 כדי לבטל את הנעילה של חשבון משתמש נעול.
אילוץ עדכון הסיסמה Write Property: pwdLastSet משתמש מגדיר את המאפיין pwdLastSet לערך 0 כדי לחייב את המשתמש לשנות את הסיסמה בכניסה הבאה.
הגדרת סיסמת משתמש
  • ימין מורחב: Reset Password (User-Force-Change-Password)
  • (אופציונלי) Write Property: unicodePwd
 משתמש מאפס את הסיסמה של משתמש היעד. נדרש LDAPS (יציאה 636) או StartTLS.
הוספת משתמש לקבוצה
  • Read Property: member
  • Write Property: member
 קבוצה מוסיף את השם הייחודי (DN) של משתמש היעד (distinguishedName) למאפיין member של הקבוצה.
הסרת משתמש מקבוצה
  • Read Property: member
  • Write Property: member
 קבוצה מסיר את השם הייחודי (DN) של משתמש היעד (distinguishedName) מהמאפיין member של הקבוצה.
שינוי היחידה הארגונית של משתמש
  • ‫Delete Child Object (משתמש) ביחידה הארגונית של המקור
  • ‫Create Child Object (משתמש) ביחידה הארגונית שמוגדרת כיעד
  • Write Property: name, distinguishedName
 יחידה ארגונית (OU), משתמש מעבירים אובייקטים של משתמשים בין יחידות ארגוניות באמצעות LDAP modify_dn.
שינוי היחידה הארגונית של המארח
  • ‫Delete Child Object (מחשב) ביחידה הארגונית של המקור
  • Create Child Object (מחשב) ביחידה הארגונית שמוגדרת כיעד
  • Write Property: name, distinguishedName
 יחידה ארגונית (OU), מחשב העברת אובייקטים של מחשבים בין יחידות ארגוניות באמצעות LDAP modify_dn.
עדכון מאפיינים של משתמש ב-AD ‫Write Property במאפייני היעד (כמו mail,‏ title,‏ department,‏ telephoneNumber,‏ description או manager) משתמש משנה ערכי מאפיינים שצוינו באובייקט המשתמש של היעד.
עדכון מאפיינים של מארח AD ‫Write Property על מאפייני יעד (כמו description או location) מחשב משנה ערכים של מאפיינים שצוינו באובייקט המחשב היעד.
קבלת חברי הקבוצה
  • List Contents
  • Read Property: member, sAMAccountName, distinguishedName
 קבוצה, משתמש, מחשב שאילתות לגבי חברות בקבוצה ומאפיינים של חשבונות חברים.
קבלת פרטים ליצירת קשר עם מנהל/ת
  • Read Property: manager
  • Read Property: mail, displayName, telephoneNumber, title
 משתמש קוראת את המאפיין manager מאובייקט המשתמש של היעד ומאחזרת את הפרטים ליצירת קשר של המנהל.
האם המשתמש נמצא בקבוצה
  • Read Property: memberOf, sAMAccountName
 משתמש, קבוצה הפונקציה בודקת אם חשבון משתמש שייך לקבוצת האבטחה או לקבוצת התפוצה שצוינה.
רשימת קבוצות משתמשים
  • Read Property: memberOf, sAMAccountName
 משתמש, קבוצה מחזירה את רשימת כל הקבוצות שהוקצו לחשבון המשתמש שצוין.
חיפוש ב-Active Directory
  • List Contents
  • Read Property במאפיינים שנכללים בשאילתה
 משתמש, מחשב, קבוצה, יחידה ארגונית מריץ שאילתות של מסנני LDAP מותאמים אישית על עץ המשנה של הספריה.

הקצאת הרשאות ב-Active Directory

כדי לאכוף את העיקרון של מתן הרשאה לפי הצורך בלי להעניק הרשאות אדמין רחבות, אפשר להשתמש ב-ADUC או ב-PowerShell וב-dsacls כדי להקצות הרשאות ליחידות ארגוניות (OU) באמצעות כלי ניהול רגילים של Active Directory.

העברת שליטה באמצעות ADUC

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

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

הוראות מפורטות להפעלת האשף זמינות במסמכי התיעוד של Microsoft בנושא העברת שליטה ב-AD DS ב-Windows Server.

העברת שליטה באמצעות PowerShell ו-dsacls

אם אתם מעדיפים גישה של שורת פקודה או שאתם צריכים להפוך את הקצאת ההרשאות לאוטומטית ולכתוב לה סקריפט, אתם יכולים להשתמש ב-PowerShell לצד כלי שורת הפקודה המובנה dsacls.exe.

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

  • הענקת הרשאות קריאה וכתיבה ב-userAccountControl (השבתה או הפעלה של חשבונות משתמשים ומניעת שגיאות העשרה): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
  • Grant Read and Write on userAccountControl for computer objects (Disable/Enable computers): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
  • מתן הרשאות לביטול נעילת החשבון (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;lockoutTime;user"
  • הענקת הרשאות לשינוי סיסמה בכפייה (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;pwdLastSet;user"
  • הענקת הרשאות לאיפוס סיסמה (Reset Password הרשאה מורחבת): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
  • איך מעניקים זכויות לשינוי החברות בקבוצת אבטחה: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

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

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

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

פרמטר תיאור
Server

חובה.

שם המארח, שם ה-DNS או כתובת ה-IP של שרת Active Directory. השילוב מתקשר באמצעות פרוטוקול LDAP.

כדי להשתמש ביציאה מותאמת אישית, מוסיפים אותה לכתובת (למשל, mydomain.com:636).

כברירת מחדל, השילוב משתמש ביציאה 636 כשהפרוטוקולים SSL/TLS מופעלים, וביציאה 389 כשהם מושבתים.
Username

חובה.

כתובת האימייל של המשתמש שאליו רוצים להתחבר ב-Active Directory, למשל user@example.com.

הפרמטר הזה מקבל גם את המאפיין userPrincipalName.
Domain

חובה.

נתיב ה-DNS המלא לדומיין במרחב השמות של הרשת.

כדי להגדיר את הפרמטר הזה, מזינים את שם הדומיין שמוגדר במלואו (FQDN) של הדומיין בפורמט הבא: SUBDOMAIN.ROOT_DOMAIN.

לדוגמה, אם הדומיין הפנימי של Active Directory הוא example.local, ה-FQDN שצריך להזין הוא example.local. אם הדומיין הפנימי של Active Directory הוא corp.example.com, ה-FQDN שצריך להזין הוא corp.example.com.
Password

חובה.

הסיסמה לחשבון המשתמש.
Custom Query Fields

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

שדות בהתאמה אישית של השילוב עם Active Directory, כמו customField1, customField2.
CA Certificate File - parsed into Base64 String

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

מחרוזת קובץ אישור ה-CA בקידוד בפורמט base64 שהתקבלה כשהגדרתם את אישור ה-CA. כדי להגדיר את הפרמטר הזה, מזינים את הערך המלא של BASE64_ENCODED_CERTIFICATE_STRING.
Use SSL

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

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

השילוב משתמש ב-LDAPS מאובטח (יציאה 636) כשבוחרים בו. אם לא בוחרים באפשרות הזו, המערכת משתמשת ב-LDAP רגיל (יציאה 389).

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

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

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

פעולות

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

הוספת משתמש לקבוצה

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

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

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

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

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

חובה.

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

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

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

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

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

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

Successfully added the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were already a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were added to the group "GROUP_NAME" in Active Directory.

No users were added to the provided groups in Active Directory.

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

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

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

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

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

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

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

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

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

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

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

חובה.

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

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

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

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

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

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

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

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

חובה.

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

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

השבתת החשבון

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

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

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

אין.

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

הפעולה השבתת החשבון מספקת את התוצאות הבאות:

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

השבתת המחשב

משתמשים בפעולה השבתת מחשב כדי להשבית חשבון מחשב.

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

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

אין.

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

הפעלת החשבון

משתמשים בפעולה Enable Account כדי להפעיל חשבון משתמש.

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

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

אין.

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

הפעולה Enable Account מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

הפעלת המחשב

כדי להפעיל חשבון מחשב, משתמשים בפעולה Enable Computer.

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

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

אין.

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

העשרת ישויות

משתמשים בפעולה Enrich Entities כדי להוסיף מאפיינים של Active Directory לישויות Hostname או Username.

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

הפעולה Enrich Entities מופעלת בישויות הבאות של Google SecOps:

  • User
  • Hostname

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

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

פרמטר תיאור
Mark entities as internal

חובה.

אם בוחרים באפשרות הזו, הפעולה מסמנת באופן אוטומטי את הישויות שהועשרו בהצלחה כישויות פנימיות.
Specific Attribute Names To Enrich With

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

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

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

הפרמטר הזה הוא תלוי אותיות רישיות.
Should Case Wall table be filtered by the specified attributes?

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

אם בוחרים באפשרות הזו, הפעולה מאכלסת את הטבלה של קיר בקשות התמיכה רק במאפיינים שצוינו בערך הפרמטר Specific Attribute Names To Enrich With.

האפשרות הזו לא מסומנת כברירת מחדל.
Should JSON result be filtered by the specified attributes?

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

אם בוחרים באפשרות הזו, התוצאה של ה-JSON מחזירה רק את המאפיינים שציינתם בערך הפרמטר Specific Attribute Names To Enrich With.

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

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

הזמן הקצוב לתפוגה של החיבור לרשת בשניות.

ערך ברירת המחדל הוא 10.
Receive Timeout

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

מגבלת הזמן הקצוב לתפוגה של קבלת נתונים ברשת בשניות.

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

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה של ישויות יש גישה
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
העשרה של ישויות

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

שם שדה ההעשרה לוגיקה
AD_primaryGroupID הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_logonCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_cn הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_countryCode הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectClass הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_userPrincipalName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_adminCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogonTimestamp הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_manager הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_instanceType הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_distinguishedName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_dSCorePropagationData הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_msDS-SupportedEncryptionTypes הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectSid הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_whenCreated הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_uSNCreated הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lockoutTime הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_badPasswordTime הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_pwdLastSet הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sAMAccountName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectCategory הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogon הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectGUID הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_whenChanged הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_badPwdCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_accountExpires הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_displayName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_name הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_memberOf הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_codePage הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_userAccountControl הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sAMAccountType הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_uSNChanged הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sn הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_givenName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogoff הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
תוצאה בפורמט JSON

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

[
    {
        "EntityResult": {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["GUID"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example user"],
            "name": ["user"],
            "memberOf": ["CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"
                          ]},
        "Entity": "user@example.com"
    }
]
תוצאת הסקריפט

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

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

אילוץ עדכון סיסמה

משתמשים בפעולה Force Password Update כדי לחייב משתמש לשנות את הסיסמה שלו בכניסה הבאה.

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

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

אין.

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

הפעולה Force Password Update (כפיית עדכון סיסמה) מספקת את הפלטים הבאים:

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

אחזור של חברי הקבוצה

משתמשים בפעולה Get Group Members (קבלת חברי קבוצה) כדי לאחזר את חברי קבוצה ספציפית ב-Active Directory.

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

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

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

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

חובה.

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

חובה.

סוג החברות בקבוצה.

ערך ברירת המחדל הוא User.
Perform Nested Search

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

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

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

חובה.

המספר המקסימלי של כרטיסי מוצר לאחזור מ-Active Directory.

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

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל באמצעות הפעולה Get Group Members:

[
  {
    "cn":"Example User1",
    "displayName":"Example User1",
    "distinguishedName":"CN=Example User1,OU=User Accounts,DC=example,DC=local"
  },
  {
    "cn":"Example User2",
    "displayName":"Example User2",
    "distinguishedName":"CN=Example User2,CN=Users,DC=example,DC=local"
  },
  {
    "cn":"Example User3",
    "displayName":"Example User3",
    "distinguishedName":"CN=Example User3,CN=Users,DC=example,DC=local"
  }
]
תוצאת הסקריפט

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

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

קבלת פרטים ליצירת קשר עם מנהל

משתמשים בפעולה Get Manager Contact Details כדי לקבל את פרטי יצירת הקשר של המנהל מ-Active Directory.

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

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

אין.

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

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

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

הפעולה Get Manager Contact Details תומכת בהעשרה של הישויות הבאות:

שם שדה ההעשרה לוגיקה
AD_Manager_Name הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_Manager_phone הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_primaryGroupID הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_logonCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_cn הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_countryCode הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectClass הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_userPrincipalName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_adminCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogonTimestamp הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_manager הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_instanceType הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_distinguishedName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_dSCorePropagationData הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_msDS-SupportedEncryptionTypes הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectSid הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_whenCreated הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_uSNCreated הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lockoutTime הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_badPasswordTime הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_pwdLastSet הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sAMAccountName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectCategory הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogon הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_objectGUID הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_whenChanged הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_badPwdCount הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_accountExpires הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_displayName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_name הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_memberOf הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_codePage הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_userAccountControl הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sAMAccountType הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_uSNChanged הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_sn הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_givenName הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
AD_lastLogoff הפעולה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל באמצעות הפעולה Get Manager Contact Details:

[
   {
        "EntityResult":
        {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["{id}"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example"],
            "name": ["user"],
            "memberOf": ["CN= u05e7 u05d1 u05d5 u05e6 u05d4  u05d1 u05e2 u05d1 u05e8 u05d9 u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"]
        },
        "Entity": "user@example.com"
    }
]
הודעות פלט

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

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

All entities were processed successfully.

Some entities were processed successfully and some weren't. Please check the action log for further information.

No entities were processed.

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

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

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

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

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

האם המשתמש נמצא בקבוצה

משתמשים בפעולה Is User in Group כדי לבדוק אם המשתמש הוא חבר בקבוצה ספציפית.

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

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

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

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

חובה.

שם הקבוצה שרוצים לבדוק, למשל administrators.

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

הפעולה Is User in Group מספקת את הפלט הבא:

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
    {
        "EntityResult": true,
        "Entity": "USER1@EXAMPLE.COM"
    }, {
        "EntityResult": false,
        "Entity": "USER2@EXAMPLE.COM"
    }, {
        "EntityResult": true,
        "Entity": "USER3@EXAMPLE.COM"
    }
]
תוצאת הסקריפט

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

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

הצגת רשימה של קבוצות משתמשים

משתמשים בפעולה List User Groups כדי לקבל רשימה של כל קבוצות המשתמשים שזמינות ב-Active Directory.

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

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

אין.

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "user@example.com"
    }
]
תוצאת הסקריפט

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

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

פינג

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

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

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

אין.

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

ביטול הנעילה של החשבון

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

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

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

אין.

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

הפעולה Release Locked Account מספקת את התוצאות הבאות:

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

הסרת משתמש מקבוצה

כדי להסיר משתמשים מקבוצות, משתמשים בפעולה Remove User From Group (הסרת משתמש מקבוצה).

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

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

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

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

חובה.

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

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

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

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

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

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

Successfully removed the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were not a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were removed from the group "GROUP_NAME" in Active Directory.

No users were removed from the provided groups in Active Directory.

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

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

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

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

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

חיפוש ב-Active Directory

משתמשים בפעולה חיפוש ב-Active Directory כדי לחפש ב-Active Directory באמצעות שאילתה שצוינה.

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

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

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

פרמטר תיאור
Query String

חובה.

מחרוזת השאילתה לביצוע ב-Active Directory.
Limit

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

המספר המקסימלי של כרטיסי מוצר לאחזור מ-Active Directory.

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

הפעולה חיפוש ב-Active Directory מספקת את התוצאות הבאות:

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

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

[
      {
        "primaryGroupID": [
          513
        ],
        "logonCount": [
          6505
        ],
        "cn": [
          "user name"
        ],
        "countryCode": [
          0
        ],
        "objectClass": [
          "top",
          "person",
          "organizationalPerson"
        ],
        "userPrincipalName": [
          "user@example.com"
        ],
        "adminCount": [
          1
        ],
        "lastLogonTimestamp": [
          "2019-01-09 08:42:03.540783+00:00"
        ],
        "manager": [
          "CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"
        ],
        "instanceType": [
          4
        ],
        "distinguishedName": [
          "CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "dSCorePropagationData": [
          "2019-01-14 14:39:16+00:00"
        ],
        "msDS-SupportedEncryptionTypes": [
          0
        ],
        "objectSid": [
          "ID"
        ],
        "whenCreated": [
          "2011-11-07 08:00:44+00:00"
        ],
        "uSNCreated": [
          7288202
        ],
        "lockoutTime": [
          "1601-01-01 00:00:00+00:00"
        ],
        "badPasswordTime": [
          "date"
        ],
        "pwdLastSet": [
          "date"
        ],
        "sAMAccountName": [
          "example"
        ],
        "objectCategory": [
          "CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"
        ],
        "lastLogon": [
          "2019-01-14 17:13:54.463070+00:00"
        ],
        "objectGUID": [
          "GUID"
        ],
        "whenChanged": [
          "2019-01-14 16:49:01+00:00"
        ],
        "badPwdCount": [
          1
        ],
        "accountExpires": [
          "9999-12-31 23:59:59.999999"
        ],
        "displayName": [
          "example"
        ],
        "name": [
          "user"
        ],
        "memberOf": [
          "CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL",
          "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL",
          "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "codePage": [
          0
        ],
        "userAccountControl": [
          111
        ],
        "sAMAccountType": [
          805306368
        ],
        "uSNChanged": [
          15301168
        ],
        "sn": [
          "example"
        ],
        "givenName": [
          "user"
        ],
        "lastLogoff": [
          "1601-01-01 00:00:00+00:00"
        ]
      }
    ]
הודעות פלט

הפעולה חיפוש ב-Active Directory יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully performed the query "QUERY_STRING" in Active Directory.

No results to show following the query: "QUERY_STRING".

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

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

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

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

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

הגדרת סיסמת משתמש

משתמשים בפעולה Set User Password (הגדרת סיסמת משתמש) כדי להגדיר את סיסמת המשתמש.

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

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

הפעולה Set User Password (הגדרת סיסמת משתמש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
New Password

חובה.

ערך סיסמה חדש.

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

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

סוג פלט הפעולה זמינות
קובץ מצורף לבקשת התמיכה לא זמין
קישור לקיר של כרטיס לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

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

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

עדכון מאפיינים של מארח AD

כדי לעדכן את המאפיינים של המארחים הנוכחיים ב-Active Directory, משתמשים בפעולה Update attributes of an AD Host.

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

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

הפעולה Update attributes of an AD Host (עדכון מאפיינים של מארח AD) דורשת את הפרמטרים הבאים:

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

חובה.

השם של המאפיין שרוצים לעדכן, למשל Description.
Attribute Value

חובה.

ערך חדש למאפיין.

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

הפעולה Update attributes of an AD Host מספקת את הפלט הבא:

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

הפעולה Update attributes of an AD Host יכולה להחזיר את הודעות הפלט הבאות:

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

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 הפעולה הסתיימה בהצלחה.
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

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

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Update attributes of an AD Host:

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

עדכון מאפיינים של משתמש ב-AD

משתמשים בפעולה Update attributes of an AD User כדי לעדכן את המאפיינים של המשתמשים הנוכחיים ב-Active Directory.

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

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

הפעולה Update attributes of an AD User (עדכון מאפיינים של משתמש ב-AD) דורשת את הפרמטרים הבאים:

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

חובה.

השם של המאפיין שרוצים לעדכן, למשל Description.
Attribute Value

חובה.

ערך חדש למאפיין.

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

הפעולה עדכון מאפיינים של משתמש ב-AD מספקת את הפלטים הבאים:

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

הפעולה Update attributes of an AD User יכולה להחזיר את הודעות הפלט הבאות:

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

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 הפעולה הסתיימה בהצלחה.
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

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

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

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

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

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