‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שילוב של Microsoft Entra ID עם Google SecOps

במסמך הזה מוסבר איך לשלב את Microsoft Entra ID עם Google Security Operations ‏ (Google SecOps).

השילוב הזה משתמש ברכיב אחד או יותר של קוד פתוח. אתם יכולים להוריד עותק מכווץ של קוד המקור המלא של השילוב הזה מהקטגוריה של Cloud Storage.

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

שילוב של Microsoft Entra ID עם Google SecOps יכול לעזור לכם לפתור את הבעיות הבאות:

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

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

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

רישום אפליקציה ב-Azure: צריך לרשום אפליקציה במרכז הניהול של Microsoft Entra כדי לקבל מזהה לקוח ומזהה דייר (Tenant).

הוראות מפורטות זמינות במאמר רישום אפליקציה ב-Microsoft Entra ID.
הרשאות API: מעניקים לאפליקציה את הרשאות האפליקציה הבאות של Microsoft Graph > ומספקים הסכמת אדמין:
- Directory.Read.All
- Directory.ReadWrite.All
- Group.ReadWrite.All
- User.ReadWrite.All
- AuditLog.Read.All (חובה כדי להשתמש בפרמטר Include MFA Details)
הקצאות תפקידים: כדי להריץ פעולות שקשורות לסיסמאות, כמו עדכון סיסמה מאולץ או איפוס סיסמת משתמש, צריך להקצות את התפקיד Password Administrator לאפליקציה ב-Microsoft Entra ID.
סוד לקוח: יוצרים סוד לקוח בקטע Certificates & secrets באפליקציית Azure. שומרים מיד את הערך של הסוד (לא את מזהה הסוד), כי הוא מוצג רק פעם אחת ונדרש להגדרה.

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

כדי לשלב את Microsoft Entra ID, צריך להגדיר את הפרמטרים הבאים:

פרמטר	תיאור
`Login API Root`	אופציונלי שורש ה-API שמשמש לאימות באמצעות פלטפורמת הזהויות של מיקרוסופט. ערך ברירת המחדל הוא `https://login.microsoftonline.com`.
`API Root`	אופציונלי שורש ה-API של המכונה של Azure Active Directory. ערך ברירת המחדל הוא `https://graph.microsoft.com`.
`Client ID`	חובה ערך מזהה האפליקציה (הלקוח) של חשבון Microsoft Entra ID.
`Client Secret`	חובה ערך סוד הלקוח של החשבון ב-Microsoft Entra ID.
`Directory ID`	חובה ערך המזהה של הספרייה (הדייר) בחשבון Microsoft Entra ID.
`Verify SSL`	אופציונלי אם בוחרים באפשרות הזו, השילוב מאמת שאישור ה-SSL שמשמש לחיבור לשרת Microsoft Entra ID תקף. האפשרות הזו מסומנת כברירת מחדל.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

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

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

משתמשים בפעולה Add User to a Group כדי להוסיף משתמש לקבוצה הספציפית ב-Microsoft Entra ID. בפעולה הזו צריך להגדיר את הישות User בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר	תיאור
`Group ID`	חובה המזהה של הקבוצה ב-Microsoft Entra ID שאליה רוצים להוסיף את המשתמש, למשל `00e40000-1971-439d-80fc-d0e000001dbd`.

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

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

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

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`Member USER_ID was added to the group GROUP_ID successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Member could not be added successfully.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Member USER_ID was added to the group GROUP_ID successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Member could not be added successfully.

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

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

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

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

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

השבתת החשבון

משתמשים בפעולה Disable Account כדי להשבית חשבון ב-Microsoft Entra ID. בפעולה הזו צריך להגדיר את הישות User בפורמט username@domain.

כדי להריץ את הפעולה Disable Account, צריך לתת הרשאות אדמין לחשבון Microsoft Entra ID שבו משתמשים בשילוב.

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

הגדרת הרשאות נוספות

כדי להשתמש בפעולה Disable Account, צריך להגדיר גם את הרשאת ה-API הבאה לאפליקציה:

User.EnableDisableAccount.All

בקטע הגדרת הרשאות API מוסבר איך להגדיר הרשאות API ב-Microsoft Entra ID.

קלט של הפעולה

אין.

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

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

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

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`User account disabled successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Disable user account was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

User account disabled successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Disable user account was not successful.

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

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

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

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

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

הפעלת החשבון

משתמשים בפעולה הפעלת החשבון כדי להפעיל חשבון ב-Microsoft Entra ID. בפעולה הזו צריך להגדיר את הישות User בפורמט username@domain.

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

הגדרת הרשאות נוספות

כדי להשתמש בפעולה Enable Account, צריך להגדיר גם את הרשאת ה-API הבאה לאפליקציה:

User.EnableDisableAccount.All

בקטע הגדרת הרשאות API מוסבר איך להגדיר הרשאות API ב-Microsoft Entra ID.

קלט של הפעולה

אין.

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

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

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

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`User account was enabled successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Enable user account was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

User account was enabled successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Enable user account was not successful.

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

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

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

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

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

העשרת המארח

משתמשים בפעולה Enrich Host כדי להעשיר את הישות Host ב-Google SecOps במידע מ-Microsoft Entra ID. הפעולה הזו מוצאת התאמה לישות Host שסופקה באמצעות השדה displayName במכשיר ב-Microsoft Entra ID.

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

קלט של הפעולה

אין.

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

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

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

טבלת העשרת ישויות

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

שדה העשרה	לוגיקה
`AAD_Name`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Enabled`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Property Device ID`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_OS`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Version`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Profile Type`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Compliant`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Last Sign In`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.

תוצאת JSON

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

[
    {
        "EntityResult": {
            "deletedDateTime": "1234569",
            "complianceExpirationDateTime": "1234567",
            "profileType": "RegisteredDevice",
            "key": "007",
            "if":"889922-aaaa-123123"
        },
        "Entity": "us-lt-v13001"
    }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`Host details were fetched successfully: HOSTNAME.` `Some errors occurred. Please check log.`	הפעולה בוצעה בהצלחה.
`Host details were not found.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Host details were fetched successfully: HOSTNAME.

Some errors occurred. Please check log.

הפעולה בוצעה בהצלחה.

Host details were not found.

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

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

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

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

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

העשרת המשתמשים

משתמשים בפעולה Enrich User כדי להעשיר את הישות User ב-Google SecOps במידע מ-Microsoft Entra ID. בפעולה הזו, צריך להגדיר את הישות User בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר תיאור

פרמטר	תיאור
`Include MFA Details`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מחזירה פרטי MFA לגבי המשתמש. הערה: הפרמטר הזה דורש את הרשאת האפליקציה `AuditLog.Read.All` Microsoft Graph ברישום האפליקציה ב-Azure.
`Include Last Sign In Details`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מאחזרת את פעילות הכניסה של המשתמש (כולל חותמות זמן של כניסות אינטראקטיביות ולא אינטראקטיביות).

Include MFA Details

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

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

הערה: הפרמטר הזה דורש את הרשאת האפליקציה AuditLog.Read.All Microsoft Graph ברישום האפליקציה ב-Azure.

Include Last Sign In Details

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

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

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

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

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

טבלת העשרת ישויות

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

שדה העשרה	לוגיקה
`AAD_Name`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Mobile Phone`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Preferred Language`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Job Title`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Username`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.

תוצאת JSON

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

[
  {
    "Entity": "user@domain.com",
    "EntityResult": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
      "accountEnabled": true,
      "ageGroup": null,
      "businessPhones": [],
      "city": "New York",
      "companyName": "ExampleCorp",
      "consentProvidedForMinor": null,
      "country": "US",
      "createdDateTime": "2025-01-01T00:00:00Z",
      "creationType": null,
      "department": "Security",
      "displayName": "User Name",
      "mail": "user@domain.com",
      "employeeId": "12345",
      "employeeHireDate": null,
      "employeeType": null,
      "externalUserStateChangeDateTime": null,
      "faxNumber": null,
      "givenName": "User",
      "imAddresses": [],
      "externalUserState": null,
      "jobTitle": "Security Analyst",
      "surname": "Surname",
      "lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
      "legalAgeGroupClassification": null,
      "mailNickname": "usernickname",
      "mobilePhone": "+11234567890",
      "id": "user-id-12345",
      "officeLocation": null,
      "onPremisesSamAccountName": null,
      "onPremisesDistinguishedName": null,
      "onPremisesDomainName": null,
      "onPremisesImmutableId": null,
      "onPremisesLastSyncDateTime": null,
      "onPremisesProvisioningErrors": [],
      "onPremisesSecurityIdentifier": null,
      "onPremisesSyncEnabled": null,
      "onPremisesUserPrincipalName": null,
      "otherMails": [],
      "passwordPolicies": "None",
      "preferredDataLocation": null,
      "preferredLanguage": "en-US",
      "proxyAddresses": [],
      "signInSessionsValidFromDateTime": "2025-01-01T00:00:00Z",
      "state": "NY",
      "streetAddress": "123 Main St",
      "usageLocation": "US",
      "userPrincipalName": "user@domain.com",
      "userType": "Member",
      "postalCode": "10001",
      "deletedDateTime": null,
      "showInAddressList": null,
      "isResourceAccount": null,
      "refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
      "employeeOrgData": null,
      "passwordProfile": null,
      "authorizationInfo": {
        "certificateUserIds": []
      },
      "mfa_details": {
        "id": "user-id-12345",
        "userPrincipalName": "user@domain.com",
        "userDisplayName": "User Name",
        "userType": "member",
        "isAdmin": false,
        "isSsprRegistered": true,
        "isSsprEnabled": true,
        "isSsprCapable": true
        "isMfaRegistered": true,
        "isMfaCapable": true,
        "isPasswordlessCapable": false,
        "methodsRegistered": [
          "email",
          "mobilePhone"
        ],
        "defaultMfaMethod": "mobilePhone",
        "isSystemPreferredAuthenticationMethodEnabled": false,
        "systemPreferredAuthenticationMethods": [],
        "userPreferredMethodForSecondaryAuthentication": "oath",
        "lastUpdatedDateTime": "2026-01-01T00:00:00Z"
      }
    }
  }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`User details were fetched successfully: USERNAME.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Users list fetch was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

User details were fetched successfully: USERNAME.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Users list fetch was not successful.

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

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

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

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

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

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

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

הפעולה עדכון סיסמה כפוי מצפה שתגדירו את הישות User בפורמט username@domain.

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

הגדרת הרשאות נוספות

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

User-PasswordProfile.ReadWrite.All

בקטע הגדרת הרשאות API מוסבר איך להגדיר הרשאות API ב-Microsoft Entra ID.

הקצאת תפקיד לאפליקציה

כדי לבצע את הפעולה עדכון סיסמה כפוי, צריך להקצות לאפליקציה את התפקיד Password Administrator.

כדי להקצות לאפליקציה את התפקיד Password Administrator:

נכנסים לפורטל Azure באמצעות חשבון Microsoft.
ב-Microsoft Entra ID, מחפשים את Roles and administrators (תפקידים ואדמינים).
בוחרים את התפקיד Password Administrator מהרשימה או מחפשים אותו.
לוחצים על הוספת מטלה.
בוחרים חשבון (חבר) שבו משתמשים בשילוב ולוחצים על הבא.
מזינים הצדקה להקצאת תפקיד.
לוחצים על הקצאה.

קלט של הפעולה

אין.

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

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

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

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`Force password update on the user was successful.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Attempt to Force user password update was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Force password update on the user was successful.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Attempt to Force user password update was not successful.

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

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

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

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

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

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

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

בפעולה Get Manager Contact Details צריך להגדיר את הישות User בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר תיאור

פרמטר	תיאור
`Fields To Return`	זה שינוי אופציונלי. רשימה מופרדת בפסיקים של מאפיינים ספציפיים של פרופיל המנהל שרוצים לאחזר. אם לא מציינים ערך, הפעולה מחזירה את קבוצת ברירת המחדל של המאפיינים שמוגדרים על ידי ה-API. ערך ברירת המחדל הוא accountEnabled,ageGroup,assignedLicenses, businessPhones,city,companyName,consentProvidedForMinor,country, createdDateTime,creationType,department,displayName,mail,employeeId, employeeHireDate,employeeOrgData,employeeType,onPremisesExtensionAttributes, externalUserStateChangeDateTime,faxNumber,givenName,imAddresses,identities, externalUserState,jobTitle,surname,lastPasswordChangeDateTime, legalAgeGroupClassification,mailNickname,mobilePhone,id,officeLocation, onPremisesSamAccountName,onPremisesDistinguishedName,onPremisesDomainName, onPremisesImmutableId,onPremisesLastSyncDateTime, onPremisesProvisioningErrors,onPremisesSecurityIdentifier, onPremisesSyncEnabled,onPremisesUserPrincipalName,otherMails, passwordPolicies,passwordProfile,preferredDataLocation,preferredLanguage, proxyAddresses,signInSessionsValidFromDateTime,sponsors,state,streetAddress, usageLocation,userPrincipalName,userType,postalCode,authorizationInfo, deletedDateTime,showInAddressList,isResourceAccount, refreshTokensValidFromDateTime.
`Include MFA Details`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מחזירה פרטי MFA לגבי המשתמש. הערה: הפרמטר הזה דורש את הרשאת האפליקציה `AuditLog.Read.All` Microsoft Graph ברישום האפליקציה ב-Azure.
`Include Last Sign In Details`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מאחזרת את פעילות הכניסה של המשתמש (כולל חותמות זמן של כניסות אינטראקטיביות ולא אינטראקטיביות).

Fields To Return

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

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

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

ערך ברירת המחדל הוא accountEnabled,ageGroup,assignedLicenses, businessPhones,city,companyName,consentProvidedForMinor,country, createdDateTime,creationType,department,displayName,mail,employeeId, employeeHireDate,employeeOrgData,employeeType,onPremisesExtensionAttributes, externalUserStateChangeDateTime,faxNumber,givenName,imAddresses,identities, externalUserState,jobTitle,surname,lastPasswordChangeDateTime, legalAgeGroupClassification,mailNickname,mobilePhone,id,officeLocation, onPremisesSamAccountName,onPremisesDistinguishedName,onPremisesDomainName, onPremisesImmutableId,onPremisesLastSyncDateTime, onPremisesProvisioningErrors,onPremisesSecurityIdentifier, onPremisesSyncEnabled,onPremisesUserPrincipalName,otherMails, passwordPolicies,passwordProfile,preferredDataLocation,preferredLanguage, proxyAddresses,signInSessionsValidFromDateTime,sponsors,state,streetAddress, usageLocation,userPrincipalName,userType,postalCode,authorizationInfo, deletedDateTime,showInAddressList,isResourceAccount, refreshTokensValidFromDateTime.

Include MFA Details

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

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

הערה: הפרמטר הזה דורש את הרשאת האפליקציה AuditLog.Read.All Microsoft Graph ברישום האפליקציה ב-Azure.

Include Last Sign In Details

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

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

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

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

שולחן קונסולה צמוד לקיר

הפעולה Get Manager Contact Details יכולה להחזיר את הטבלה הבאה ב-Google SecOps:

שם הטבלה: איש קשר של מנהל

עמודות:

שם
מספר טלפון

טבלת העשרת ישויות

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

שדה העשרה	לוגיקה
`Display Name`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Mobile Phone`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`@odata.context`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Job Title`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`AAD_Username`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.

תוצאת JSON

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

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
      "accountEnabled": true,
      "ageGroup": null,
      "businessPhones": [],
      "city": "Anytown",
      "companyName": "Example Corporation",
      "consentProvidedForMinor": null,
      "country": "US",
      "createdDateTime": "2025-01-01T00:00:00Z",
      "creationType": null,
      "department": "Security Operations",
      "displayName": "Internal User",
      "mail": "user@example.com",
      "employeeId": "ID-00001",
      "employeeHireDate": null,
      "employeeType": "Full-time",
      "externalUserStateChangeDateTime": null,
      "faxNumber": null,
      "givenName": "Alex",
      "imAddresses": [],
      "externalUserState": null,
      "jobTitle": "Security Lead",
      "surname": "Doe",
      "lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
      "legalAgeGroupClassification": null,
      "mailNickname": "alexdoe",
      "mobilePhone": "+1 555-0100",
      "id": "00000000-0000-0000-0000-000000000000",
      "officeLocation": null,
      "usageLocation": "US",
      "userPrincipalName": "user@example.com",
      "userType": "Member",
      "postalCode": "00000",
      "deletedDateTime": null,
      "showInAddressList": null,
      "isResourceAccount": null,
      "refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
      "employeeOrgData": null,
      "authorizationInfo": {
        "certificateUserIds": []
      },
      "sponsors": [],
      "mfa_details": {
        "id": "00000000-0000-0000-0000-000000000000",
        "userPrincipalName": "user@example.com",
        "userDisplayName": "Internal User",
        "userType": "member",
        "isAdmin": true,
        "isSsprRegistered": false,
        "isSsprEnabled": true,
        "isSsprCapable": false,
        "isMfaRegistered": true,
        "isMfaCapable": true,
        "isPasswordlessCapable": false,
        "methodsRegistered": [
          "mobilePhone",
          "softwareOneTimePasscode"
        ],
        "defaultMfaMethod": "softwareOneTimePasscode",
        "isSystemPreferredAuthenticationMethodEnabled": true,
        "systemPreferredAuthenticationMethods": [
          "SoftwareOTP"
        ],
        "userPreferredMethodForSecondaryAuthentication": "oath",
        "lastUpdatedDateTime": "2026-01-01T00:00:00Z"
      }
    }
  }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`User manager details were fetched successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Could not fetch user manager's details successfully.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

User manager details were fetched successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Could not fetch user manager's details successfully.

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

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

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

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

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

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

משתמשים בפעולה Is User in Group כדי לבדוק אם המשתמש חבר בקבוצה ספציפית ב-Microsoft Entra ID. בפעולה הזו צריך להגדיר את הישות User בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר	תיאור
`Group ID`	חובה המזהה של הקבוצה ב-Microsoft Entra ID שאליה רוצים להוסיף את המשתמש, למשל `00e40000-1971-439d-80fc-d0e000001dbd`.

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

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

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

תוצאת JSON

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

[
    {
        "EntityResult": "true",
        "Entity": "user@example.com"
    }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`The following user was found in the group: USER_ID.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`User was not found in the group.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

The following user was found in the group: USER_ID.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

User was not found in the group.

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

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

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

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

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

קבוצות של כרטיסי מוצר

משתמשים בפעולה List Groups כדי להציג רשימה של קבוצות ב-Microsoft Entra ID לפי קריטריונים ספציפיים לחיפוש.

בפעולה List Groups, הסינון פועל עם השדה Name.

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

קלט של הפעולה

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

פרמטר	תיאור
`Order By`	אופציונלי הסדר שבו הקבוצות שמוחזרות ימוינו לפי השם שלהן. ערך ברירת המחדל הוא `ASC`. הערכים האפשריים הם: `DESC` `ASC`
`Results Limit`	אופציונלי המספר המקסימלי של קבוצות שיוחזרו.
`Filter Logic`	אופציונלי הלוגיקה לסינון קבוצות לפי השם שלהן. ערך ברירת המחדל הוא `Equal`. הערכים האפשריים הם: `Equal` `Contains`
`Filter Value`	אופציונלי הערך שלפיו הקבוצות יסוננו באמצעות לוגיקת הסינון שנבחרה. הערך הזה חל על שם הקבוצה. אם בוחרים באפשרות `Equal`, הפעולה מנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות `Contain`, הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה שצוינה. אם לא תגדירו ערך, המסנן לא יופעל.

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

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

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

שולחן קונסולה צמוד לקיר

הפעולה List Groups יכולה להחזיר את הטבלה הבאה ב-Google SecOps:

שם הטבלה: קבוצות

עמודות:

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

טבלת העשרת ישויות

הפעולה List Groups תומכת בהעשרת הישויות הבאות:

שדה העשרה	לוגיקה
`Group Type`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`ID`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Name`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Description`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Created Time`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.

תוצאת JSON

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

[
  {
    "Group_Type": "managed",
    "Id": "1212-12312-123",
    "Name": "Group Name",
    "Description": "This group is ...",
    "Created_Time": "2019-10-24T19:10:18Z",
    "onPremisesSamAccountName": "alext"
  }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`Groups list was fetched successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`Groups list fetch was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Groups list was fetched successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

Groups list fetch was not successful.

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

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

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

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

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

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

משתמשים בפעולה List Members in the Group כדי להציג את רשימת החברים בקבוצה שצוינה ב-Microsoft Entra ID.

לוגיקת הסינון פועלת על סמך ערך הפרמטר Filter Key.

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

קלט של הפעולה

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

פרמטר	תיאור
`Max Records To Return`	אופציונלי המספר המקסימלי של רשומות שיוחזרו. ערך ברירת המחדל הוא 50.
`Group Name`	אופציונלי השם של קבוצת Microsoft Entra ID שרוצים להציג את החברים בה.
`Group ID`	אופציונלי המזהה של קבוצת Microsoft Entra ID שרוצים להציג את החברים בה. אם מגדירים גם את הפרמטר `Group Name` וגם את הפרמטר `Group ID`, הפעולה משתמשת בערך הפרמטר `Group ID`.
`Filter Key`	אופציונלי השדה שלפיו מסננים את חברי הקבוצה, למשל `User Display Name`. הערכים האפשריים הם: `Select One` `User Display Name` `User Principal Name` `User Mail Name`
`Filter Logic`	אופציונלי הלוגיקה שצריך להחיל על המסנן. הערכים האפשריים הם: `Not Specified` `Equal` `Contains`
`Filter Value`	אופציונלי הערך שמשמש לסינון חברי הקבוצה על סמך ערכי הפרמטרים שנבחרו ב-`Filter Key` וב-`Filter Logic`. אם בוחרים באפשרות `Equal`, הפעולה מנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות `Contain`, הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה שצוינה. אם לא תגדירו ערך, המסנן לא יופעל.

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

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

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

שולחן קונסולה צמוד לקיר

הפעולה List Members in the Group יכולה להחזיר את הטבלה הבאה ב-Google SecOps:

שם הטבלה: חברי הקבוצה הזמינים

עמודות:

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

תוצאת JSON

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

[
  {
    "@odata.type": "#microsoft.graph.user",
    "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
    "businessPhones": [],
    "displayName": "Alex T",
    "givenName": "Alex",
    "jobTitle": "Software Engineer",
    "mail": "alex.t@example.com",
    "mobilePhone": null,
    "officeLocation": "Building A",
    "preferredLanguage": "en-US",
    "surname": "T",
    "userPrincipalName": "alex.t@example.com"
  }
]

הודעות פלט

הפעולה List Members in the Group יכולה להחזיר את הודעות הפלט הבאות:

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

הודעת פלט	תיאור ההודעה
`Successfully found members for the provided criteria in Azure AD group.` `No members were found for the provided criteria in Azure AD group.` `The filter was not applied, because parameter "Filter Value" has an empty value.`	הפעולה בוצעה בהצלחה.
`Error executing action "List Members in the Group". Reason: ERROR_REASON`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Successfully found members for the provided criteria in Azure AD group.

No members were found for the provided criteria in Azure AD group.

The filter was not applied, because parameter "Filter Value" has an empty value.

הפעולה בוצעה בהצלחה.

Error executing action "List Members in the Group". Reason:
      ERROR_REASON

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

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

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

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

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

הצגת רשימת הקבוצות שהמשתמש חבר בהן

משתמשים בפעולה List User's Groups Membership כדי להציג את הקבוצות ב-Microsoft Entra ID שהמשתמש חבר בהן.

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

כדי להגדיר את שם המשתמש, צריך להשתמש בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר	תיאור
`User Name`	אופציונלי רשימה מופרדת בפסיקים של שמות משתמשים כדי לאחזר את החברויות שלהם בקבוצות, למשל `username@domain`. אם לא מגדירים ערך, הפעולה משתמשת במזהי המשתמשים מהישות `Username`.
`Return Only Security Enabled Groups`	אופציונלי אם בוחרים באפשרות הזו, הפעולה מחזירה רק קבוצות עם הרשאות אבטחה שהמשתמש שייך אליהן. האפשרות הזו לא מסומנת כברירת מחדל.
`Return Detailed Groups Information`	אופציונלי אם בוחרים באפשרות הזו, הפעולה מחזירה מידע מפורט על הקבוצות ב-Microsoft Entra ID. האפשרות הזו לא מסומנת כברירת מחדל.
`Filter Key`	אופציונלי המפתח שמשמש לסינון קבוצות. ערך ברירת המחדל הוא `Select One`. הערכים האפשריים הם: `Select One` `Group Display Name` `Group Description`
`Filter Logic`	אופציונלי הלוגיקה שצריך להחיל כשמסננים את הקבוצות. ערך ברירת המחדל הוא `Not Specified`. הערכים האפשריים הם: `Not Specified` `Equal` `Contains`
`Filter Value`	אופציונלי הערך שמשמש לסינון קבוצות. אם בוחרים באפשרות `Equal`, הפעולה מנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות `Contain`, הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה שצוינה. אם לא תגדירו ערך, המסנן לא יופעל.
`Max Records To Return`	אופציונלי המספר המקסימלי של רשומות שיוחזרו. אם לא מגדירים ערך, הפעולה מחזירה 50 רשומות כברירת מחדל.

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

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

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

שולחן קונסולה צמוד לקיר

הפעולה List User's Groups Membership יכולה להחזיר את הטבלה הבאה ב-Google SecOps:

שם הטבלה: חברויות בקבוצות

עמודות:

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

תוצאת JSON

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
    "value": [
        "ID",
        "ID",
        "ID",
    ]
}

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`Successfully found groups for the provided criteria for the following entities: ENTITY_ID` `The following entities were not found in the Azure AD: ENTITY_ID` `No groups were found in Azure Active Directory for the following entities: ENTITY_ID` `The filter was not applied, because parameter "Filter Value" has an empty value.`	הפעולה בוצעה בהצלחה.
`Error executing action "List User's Groups Membership". Reason: ERROR_REASON`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

Successfully found groups for the provided criteria for the following entities: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No groups were found in Azure Active Directory for the following entities: ENTITY_ID

The filter was not applied, because parameter "Filter Value" has an empty value.

הפעולה בוצעה בהצלחה.

Error executing action "List User's Groups Membership". Reason:
      ERROR_REASON

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

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

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

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

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

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

משתמשים בפעולה List Users כדי להציג רשימה של משתמשי Microsoft Entra ID לפי קריטריוני החיפוש שצוינו.

בפעולה List Users, הסינון פועל עם השדה Username (userPrincipalName).

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

קלט של הפעולה

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

פרמטר	תיאור
`Filter`	אופציונלי השדות שייכללו בתוצאות. ערך ברירת המחדל הוא `All Fields`. הערכים האפשריים הם: `All Fields` `displayName` `userPrincipalName` `id` `jobTitle` `mail` `mobilePhone` `preferredLanguage` `surname` `givenName`
`Order By Field`	אופציונלי השדה שלפיו התוצאות יסודרו. ערך ברירת המחדל הוא `displayName`. הערכים האפשריים הם: `displayName` `userPrincipalName`
`Order By`	אופציונלי סדר התוצאות (עולה או יורד). ערך ברירת המחדל הוא `ASC`. הערכים האפשריים הם: `DESC` `ASC`
`Results Limit`	אופציונלי מספר המשתמשים המקסימלי שיוחזרו.
`Advanced Filter Logic`	אופציונלי הלוגיקה שמשמשת לסינון מתקדם שחל על השדה `Username` (`userPrincipalName`). ערך ברירת המחדל הוא `Equal`. הערכים האפשריים הם: `Equal` `Contains`
`Advanced Filter Value`	אופציונלי הערך שבו צריך להשתמש במסנן המתקדם בשדה `Username` (`userPrincipalName`). אם בוחרים באפשרות `Equal`, הפעולה מנסה למצוא את ההתאמה המדויקת בין התוצאות. אם בוחרים באפשרות `Contain`, הפעולה מנסה למצוא תוצאות שמכילות את מחרוזת המשנה שצוינה. אם לא תגדירו ערך, המסנן לא יופעל.

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

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

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

שולחן קונסולה צמוד לקיר

הפעולה List Users יכולה להחזיר את הטבלה הבאה ב-Google SecOps:

שם הטבלה: משתמשים

עמודות:

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

טבלת העשרת ישויות

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

שדה העשרה	לוגיקה
`Username`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Surname`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Name`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Job Title`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.
`Mail`	הפונקציה מחזירה את הערך אם הוא קיים בתוצאת ה-JSON.

תוצאת JSON

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

[
    {
        "Group Type": "managed",
        "Id": "ID",
        "Name": "Example",
        "Description": "Example",
        "Created Time":"2019-10-24T19:10:18Z"
    }
]

הודעות פלט

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

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

הודעת פלט	תיאור ההודעה
`List of users was fetched successfully.` `Some errors occurred. Please check the logs.`	הפעולה בוצעה בהצלחה.
`User list fetch was not successful.`	הפעולה נכשלה. צריך לבדוק את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

List of users was fetched successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

User list fetch was not successful.

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

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

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

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

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

פינג

משתמשים בפעולה פינג כדי לבדוק את הקישוריות ל-Microsoft Entra ID.

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

קלט של הפעולה

אין.

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

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

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

הודעות פלט

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

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

Connection established successfully.

הפעולה בוצעה בהצלחה.

Connection could not be established successfully.

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

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

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

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

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

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

משתמשים בפעולה Remove User from the Group כדי להסיר משתמש מהקבוצה שצוינה ב-Microsoft Entra ID.

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

כדי להגדיר את שם המשתמש, צריך להשתמש בפורמט username@domain.

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

קלט של הפעולה

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

פרמטר תיאור

User Name

אופציונלי

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

אם לא מגדירים ערך, הפעולה פועלת על שמות המשתמשים של ישויות המשתמשים מאירוע של פעולה.

Group Name

אופציונלי

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

Group ID

אופציונלי

המזהה של הקבוצה שממנה רוצים להסיר את המשתמש.

אם מגדירים גם את הפרמטר Group Name וגם את הפרמטר Group ID, הפעולה נותנת עדיפות לערך של Group ID.

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

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

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

הודעות פלט

הפעולה Remove User from the Group יכולה להחזיר את הודעות הפלט הבאות:

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

Successfully removed the following entities from the Azure AD group: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No usernames were removed from the Azure AD group.

הפעולה בוצעה בהצלחה.

Error executing action "Remove User from the Group". Reason:
      ERROR_REASON

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

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

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

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

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

איפוס סיסמת משתמש

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

בפעולה איפוס סיסמת משתמש צריך להגדיר את הישות User בפורמט username@domain.

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

הקצאת תפקיד לאפליקציה

כדי לבצע את הפעולה איפוס סיסמת משתמש, צריך להקצות לאפליקציה את התפקיד Password Administrator.

כדי להקצות לאפליקציה את התפקיד Password Administrator:

נכנסים לפורטל Azure באמצעות חשבון Microsoft.
ב-Microsoft Entra ID, מחפשים את Roles and administrators (תפקידים ואדמינים).
בוחרים את התפקיד Password Administrator מהרשימה או מחפשים אותו.
לוחצים על הוספת מטלה.
בוחרים חשבון (חבר) שבו משתמשים בשילוב ולוחצים על הבא.
מזינים הצדקה להקצאת תפקיד.
לוחצים על הקצאה.

קלט של הפעולה

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

פרמטר	תיאור
`Password`	חובה הסיסמה החדשה שרוצים להגדיר למשתמש.

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

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

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

הודעות פלט

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

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

User password was reset successfully.

Some errors occurred. Please check the logs.

הפעולה בוצעה בהצלחה.

User password reset was not successful.

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

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

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

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

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

ביטול הסשן של המשתמש

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

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

Username
Email Address

קלט של הפעולה

אין.

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

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

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

תוצאת JSON

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

אם המשתמש קיים:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean",
    "value": true
}

אם המשתמש לא נמצא:
```
{
    "error": "User not found."
}
```

הודעות פלט

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

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

Successfully revoked sessions for the following users in Azure AD: ENTITY_ID

Action wasn't able to find the following users in Azure AD: ENTITY_ID

None of the provided users were found in Azure AD.

הפעולה בוצעה בהצלחה.

Error executing action "Revoke User Session". Reason:
      ERROR_REASON

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

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

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

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

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

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