Microsoft Teams

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

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

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

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

  • הפעלת תגובה אינטראקטיבית: אפשר להשתמש ב-Playbooks כדי לשאול משתמשים או אנליסטים שאלות ישירות ב-Teams, ולהפוך פעולות לאוטומטיות על סמך התשובות שלהם.

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

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

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

הגדרת שילוב של Microsoft Teams כדי לעבוד עם Google Security Operations

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

    מרכז האדמינים של מיקרוסופט – רישיונות שמוחלים על משתמש Microsoft Teams

  2. אחרי שמוודאים שלמשתמש הנדרש יש רישיון, אפשר להתחיל ליצור את האפליקציה ל-Microsoft Teams. קודם צריך לעבור אל Azure Active Directory > App registrations.

    Microsoft Admin Center - App registartion tab

  3. לוחצים על New Registration (הרשמה חדשה) ומזינים:

    • שם לאפליקציית Teams
    • ‫URI של הפניה לכתובת אחרת: https://localhost

    חשוב לשמור את מזהה ה-URI להפניה אוטומטית, כי הוא יידרש בהמשך התהליך.

  4. עוברים לדף סקירה כללית ומעתיקים את:

    • מזהה האפליקציה (אפליקציית הלקוח): תואם לפרמטר Client ID בהגדרת השילוב
    • מזהה הספריה (הדייר): הוא תואם לפרמטר Tenant (דייר) בהגדרת השילוב

    דף הסקירה הכללית של Microsoft Teams במרכז האדמינים של מיקרוסופט

  5. מוסיפים את ההרשאות הנדרשות. כל ההרשאות שהוחלו הן מסוג Delegated (העברה) וצריכות להיראות כך:

    הוספת הרשאות האפליקציה הנדרשות

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

  6. עוברים לכרטיסייה Certificates & secrets ומוסיפים סוד לקוח חדש. כשסוד הלקוח נוצר, צריך להעתיק את הנתונים מהעמודה Value. הערך הזה נדרש לפרמטר Client Secret (סוד הלקוח) בהגדרות השילוב.

  7. עוברים לדף ההגדרות של Google SecOps SOAR ומזינים את הפרמטרים הבאים:

    • מזהה לקוח
    • סוד לקוח
    • ‫URI של הפניה לכתובת אחרת
    • דייר

    מזינים מחרוזת של placeholder לפרמטר Refresh Token (אסימון רענון) ושומרים את ההגדרה.

    הגדרה ראשונית של השילוב עם Microsoft Teams

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

    סימולציה של בקשת תמיכה

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

    חלונית פרטי ההתראה – לחצן פעולה ידנית

  10. עוברים לשילוב Microsoft Teams ומריצים את הפעולה Get Authorization (קבלת הרשאה). הפעולה הזו יוצרת קישור שמשמש לאימות באפליקציה.

    Get Authorization action

  11. כדי לראות את התוצאות, עוברים לכרטיסייה Case Wall ולוחצים על View Results (הצגת התוצאות).

    לחצן הצגת התוצאות

    הפלט אמור להיראות כך:

    הצגת התוצאות פלט

  12. לוחצים על הקישור שמופיע בפעולה. מוודאים שנכנסתם לחשבון משתמש שמשמש לשילוב הזה. אחרי שפותחים את הקישור בדפדפן, רואים שהוא מפנה לדף אחר. הדף אמור להיראות כך: https://localhost/?code=0.ATwAylKP1BpbCEeO0…&session_state=a149d18b-4131-4649-8956-2f0d09a98743# Copy everything till "&session_state", לדוגמה: https://localhost/?code=0.ATwAylKP1BpbCEeO0…

  13. מריצים את הפעולה Generate Token (יצירת טוקן).

    פעולה של יצירת טוקן

  14. כדי לראות את התוצאות, עוברים לכרטיסייה Case Wall. בהודעה שמתקבלת, יופיע טוקן. מעתיקים את האסימון ומדביקים אותו בפרמטר Refresh Token (אסימון לרענון).

    פעולת קבלת הרשאה – ערך של טוקן רענון

  15. אם הכל בוצע בצורה נכונה, יופיע סימן וי ירוק.

    השלמת ההגדרה של השילוב עם Microsoft Teams

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

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

שם הפרמטר סוג ברירת מחדל חובה תיאור
שם המכונה String לא רלוונטי לא שם המופע שרוצים להגדיר עבורו שילוב.
תיאור String לא רלוונטי לא תיאור המופע.
מזהה לקוח String לא רלוונטי כן לא רלוונטי
מזהה סודי סיסמה לא רלוונטי כן לא רלוונטי
דייר String לא רלוונטי כן לא רלוונטי
רענון הטוקן סיסמה לא רלוונטי כן לא רלוונטי
כתובת URL להפניה אוטומטית String http://localhost לא מציינים כתובת URL להפניה מחדש שתשמש לאימות השילוב. ערך ברירת המחדל הוא http://localhost. הפרמטר הזה משפיע על הפעולות Get Authorization (קבלת הרשאה) ו-Generate Token (יצירת אסימון).

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

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

פעולות

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

המתנה לתשובה

הפעולה ממתינה לתשובה הצפויה בהודעה שצוינה.

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

פרמטרים

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

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

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

בדיקת התשובה הראשונה

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

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

מציינים את שיטת ההמתנה לפעולה.

אם האפשרות Check First Reply (בדיקת התשובה הראשונה) נבחרה, הפעולה מחזירה את התשובה הראשונה או משווה אותה לערך צפוי.

אם בוחרים באפשרות Wait Till Timeout (המתנה עד שהזמן הקצוב לתפוגה יגיע), הפעולה ממתינה לערך הצפוי עד שהזמן הקצוב לתפוגה יגיע, או מחזירה את כל ההודעות שנשלחו במהלך התקופה שנקצבה לתפוגה.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

יצירת טוקן

מקבלים אסימון גישה באמצעות כתובת ה-URL לאישור שהתקבלה בשלב הקודם.

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:False

קבלת הרשאה

מריצים את הפעולה ועוברים לכתובת ה-URL שהתקבלה.

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:false

קבלת מזהה הצוות

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

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

קבלת פרטי משתמש

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

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם משתמש String לא רלוונטי כן שם המשתמש ב-Microsoft Teams

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "isResourceAccount": null,
    "mailNickname": "username.co#EXT#",
    "surname": null,
    "deletedDateTime": null,
    "assignedLicenses": [{
        "skuId": "16ddbbfc-09ea-4de2-b1d7-312db6112d70",
        "disabledPlans": []
    }],
    "userPrincipalName": "username.co#EXT#@tenant.onmicrosoft.com",
    "faxNumber": null,
    "consentProvidedForMinor": null,
    "userType": "Member",
    "officeLocation": null,
    "usageLocation": "IL",
    "city": null,
    "employeeId": null,
    "onPremisesImmutableId": null,
    "preferredLanguage": null,
    "streetAddress": null,
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
    "id": "5e457a85-a705-4b65-8a9f-3a3d2ad7715c",
    "state": null,
    "businessPhones": [],
    "postalCode": null,
    "mail": "john_doe@example.com",
    "onPremisesSamAccountName": null,
    "onPremisesLastSyncDateTime": null,
    "accountEnabled": true,
    "mobilePhone": null,
    "refreshTokensValidFromDateTime": "2018-11-12T13:28:53Z",
    "companyName": null,
    "deviceKeys": [],
    "jobTitle": null,
    "preferredDataLocation": null,
    "showInAddressList": false,
    "department": null,
    "proxyAddresses": ["SMTP:mail"],
    "externalUserStateChangeDateTime": "2018-11-12T13:29:41Z",
    "onPremisesProvisioningErrors": [],
    "legalAgeGroupClassification": null,
    "onPremisesSyncEnabled": null,
    "onPremisesExtensionAttributes": {
        "extensionAttribute4": null,
        "extensionAttribute5": null,
        "extensionAttribute6": null,
        "extensionAttribute7": null,
        "extensionAttribute12": null,
        "extensionAttribute1": null,
        "extensionAttribute2": null,
        "extensionAttribute3": null,
        "extensionAttribute10": null,
        "extensionAttribute11": null,
        "extensionAttribute8": null,
        "extensionAttribute9": null,
        "extensionAttribute14": null,
        "extensionAttribute15": null,
        "extensionAttribute13": null
    },
    "assignedPlans": [{
        "capabilityStatus": "Enabled",
        "servicePlanId":
        "617d9209-3b90-4879-96e6-838c42b2701d",
        "service": "MicrosoftCommunicationsOnline",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "902b47e5-dcb2-4fdc-858b-c63a90a2bdb9",
        "service": "SharePoint",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "4fa4026d-ce74-4962-a151-8e96d57ea8e4",
        "service": "TeamspaceAPI",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }],
    "passwordProfile": null,
    "passwordPolicies": null,
    "externalUserState": "Accepted",
    "otherMails": ["mail"],
    "displayName": "name",
    "imAddresses": [],
    "provisionedPlans": [{
        "capabilityStatus": "Enabled",
        "provisioningStatus": "Success",
        "service": "SharePoint"
    }],
    "createdDateTime": "2018-11-12T13:28:53Z",
    "country": null,
    "onPremisesDistinguishedName": null,
    "onPremisesSecurityIdentifier": null,
    "onPremisesDomainName": null,
    "onPremisesUserPrincipalName": null,
    "givenName": null,
    "ageGroup": null
}

הצגת רשימה של ערוצים

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

פרמטרים

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

ריצה

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

תוצאות הפעולה

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

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

אחזור הפרטים של כל הצוותים.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
teams לא רלוונטי לא רלוונטי
תוצאת JSON
[
    {
        "mailNickname": "Test",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-12T15:03:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "Test",
        "securityEnabled": false,
        "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "Test",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-12T15:03:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }, {
        "mailNickname": "user",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-28T13:46:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "user",
        "securityEnabled": false, "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "user",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-28T13:46:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }

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

מקבלים את הפרטים של כל המשתמשים.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
משתמשים לא רלוונטי לא רלוונטי
תוצאת JSON
[{
    "mailNickname": "Test",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-12T15:03:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "Test",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "Test",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-12T15:03:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}, {
    "mailNickname": "user",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-28T13:46:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "user",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "user",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-28T13:46:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}]

פינג

בודקים את הקישוריות.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_connected נכון/לא נכון is_connected:False

שליחת הודעה

שליחת הודעה לערוץ ספציפי.

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
[{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2')/messages/$entity",
    "id":"1601372154742",
    "replyToId":null,
    "etag":"1601372154742",
    "messageType":"message",
    "createdDateTime":"2020-09-29T09:35:54.742Z",
    "lastModifiedDateTime":"2020-09-29T09:35:54.742Z",
    "lastEditedDateTime":null,
    "deletedDateTime":null,
    "subject":null,
    "summary":null,
    "chatId":null,
    "importance":"normal",
    "locale":"en-us",
    "webUrl":"https://teams.microsoft.com/l/message/19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2/1601372154742?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1601372154742&parentMessageId=1601372154742",
    "policyViolation":null,
    "from":{
        "application":null,
        "device":null,
        "conversation":null,
        "user":{
            "id":"b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName":"u05D2'u05D9u05D9u05DEu05E1 u05D1u05D5u05E0u05D3",
            "userIdentityType":"aadUser"
        }},
    "body":{
        "contentType":"text",
        "content":"Hello there"
    },
    "channelIdentity":{
        "teamId":"192c0699-fad2-4d02-88a2-84efd6369894",
        "channelId":"19:e3acbb17a8754cae9df724f493b5342f@thread.tacv2"
    },
    "attachments":[],
    "mentions":[],
    "reactions":[]
}]

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

שולחים למשתמש הודעה בצ'אט ב-Microsoft Teams.

פרמטרים

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

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

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

טקסט

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

  • טקסט
  • HTML

מתוך 'ישויות ומזהי משתמשים'

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

  • מתוך 'ישויות ומזהי משתמשים'
  • מתוך ישויות
  • ממזהי משתמשים

מציינים את סוג הבחירה שצריך להשתמש בה עבור המשתמשים.

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

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

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

ריצה

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

  • שם משתמש
  • כתובת אימייל

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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


אם קוד הסטטוס 201 מדווח (is_success = true): 'ההודעה נשלחה בהצלחה למשתמשים הבאים ב-Microsoft Teams: {entity.identifier}.'

אם לא נמצא צ'אט עם ישות (is_success = true): "לא הייתה אפשרות לשלוח הודעה למשתמשים הבאים ב-Microsoft Teams: {entity.identifier}".

אם לא נמצאו כל הצ'אטים עם ישות (is_success = false): "לא נשלחו הודעות למשתמשים שצוינו ב-Microsoft Teams".

הודעה אסינכרונית:

"התשובה מהמשתמשים הבאים עדיין לא התקבלה: {entity.identifier}".

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

אם מדווחת שגיאה קריטית: "שגיאה בהפעלת הפעולה 'שליחת הודעת משתמש'. הסיבה: {0}''.format(error.Stacktrace)

אם חלף הזמן הקצוב לתפוגה: "Error executing action "Send User Message". הסיבה: ההודעות נשלחו, אבל הפעולה נתקלה בפסק זמן בהמתנה לתשובה מהמשתמשים הבאים: {entity.identifier}." צריך להגדיל את הזמן הקצוב לתפוגה בסביבת הפיתוח המשולבת ולנסות שוב. הערה: אם תנסו שוב לבצע את הפעולה, תישלח הודעה נוספת.

 כללי

יצירת ערוץ

ליצור ערוץ ב-Microsoft Teams.

פרמטרים

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

רגילה

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

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('c084d2c7-a7e6-47a5-921b-0c32c3ab41d1')/channels/$entity",
    "id": "19:92ce922c1790450fae81f6713dbffbe3@thread.tacv2",
    "createdDateTime": "2021-11-18T11:37:39.8186647Z",
    "displayName": "Architecturea Discussion",
    "description": null,
    "isFavoriteByDefault": false,
    "email": "",
    "webUrl": "https://teams.microsoft.com/l/channel/19%3a92ce922c1790450fae81f6713dbffbe3%40thread.tacv2/Architecturea+Discussion?groupId=c084d2c7-a7e6-47a5-921b-0c32c3ab41d1&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a",
    "membershipType": "standard"
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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


אם מדווח קוד סטטוס 201 (is_success = true): "הערוץ {שם הערוץ} נוצר בהצלחה בצוות {שם הצוות} ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בהפעלת הפעולה 'יצירת ערוץ'. הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "שגיאה בהפעלת הפעולה 'יצירת ערוץ'. הסיבה: לא נמצאה קבוצה בשם {team, name} ב-Microsoft Teams.

אם מדווח על קוד הסטטוס 400: "שגיאה בהפעלת הפעולה 'יצירת ערוץ'. הסיבה: {innerError/message}.

 כללי

מחיקת הערוץ

מחיקת ערוץ ב-Microsoft Teams.

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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


אם קוד הסטטוס 204 מדווח (is_success = true): "הערוץ {channel name} נמחק בהצלחה בצוות {team name} ב-Microsoft Teams".

אם הערוץ לא נמצא (is_success = true): "הערוץ {channel name} לא קיים כבר בצוות {team name} ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בהפעלת הפעולה 'מחיקת ערוץ'. הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "שגיאה בהפעלת הפעולה 'מחיקת ערוץ'. הסיבה: לא נמצאה קבוצה בשם {team, name} ב-Microsoft Teams.

כללי

הוספת משתמשים לערוץ

מוסיפים משתמשים לערוץ הפרטי ב-Microsoft Teams.

פרמטרים

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

ריצה

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

  • שם משתמש
  • כתובת אימייל

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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


אם מדווח על קוד סטטוס 201 עבור ישות אחת (is_success = true): "המשתמשים הבאים נוספו בהצלחה לערוץ {Channel Name} מהצוות {team name} ב-Microsoft Teams: {entity.identifier}"

אם המשתמש לא נמצא באחת מהישויות (is_success = true): "לא הייתה אפשרות למצוא את המשתמשים הבאים ב-Microsoft Teams: {entity.identifier}"

אם מדווח על קוד סטטוס 400 עבור ישות אחת (is_success = true): "לא הייתה אפשרות להוסיף את המשתמשים הבאים לערוץ {Channel Name} מהצוות {team name} ב-Microsoft Teams: {entity.identifier}. צריך לוודא שהמשתמשים הם חלק מהצוות {team name}.

אם המשתמש לא נמצא בכל המקרים (is_success = false): "None of the provided users were found in Microsoft Teams".

אם מדווח על קוד סטטוס 400 לכולם (is_success = false): "לא הייתה אפשרות להוסיף את המשתמשים שצוינו לערוץ {Channel Name} מהצוות {team name} ב-Microsoft Teams. צריך לוודא שהמשתמשים הם חלק מהצוות {team name}.

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

אם מדווחת שגיאה קריטית: "Error executing action "Add Users To Channel". הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "Error executing action "Add Users To Channel". הסיבה: לא נמצאה קבוצה בשם {team, name} ב-Microsoft Teams.

אם הערוץ לא נמצא: "שגיאה בהפעלת הפעולה 'הוספת משתמשים לערוץ'. הסיבה: לא נמצא ערוץ בשם {channel name} ב-Microsoft Teams.

אם הערך של 'membershipType' (סוג החברות) בערוץ הוא לא 'private' (פרטי): 'שגיאה בהפעלת הפעולה 'הוספת משתמשים לערוץ'. הסיבה: הערוץ בשם {channel name} לא פרטי.

 כללי

הסרת משתמשים מהערוץ

הסרת משתמשים מהערוץ הפרטי ב-Microsoft Teams.

פרמטרים

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

ריצה

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

  • שם משתמש
  • כתובת אימייל (שם משתמש שתואם לביטוי רגולרי של כתובת אימייל)

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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


אם דווח על קוד הסטטוס 201 עבור ישות אחת (is_success = true): "המשתמשים הבאים הוסרו בהצלחה מהערוץ {Channel Name} מהצוות {team name} ב-Microsoft Teams: {entity.identifier}"

אם המשתמש לא חלק מהערוץ (is_success = true): "המשתמשים הבאים לא היו חלק מהערוץ {Channel Name} מהצוות {team name} ב-Microsoft Teams: {entity.identifier}"

אם אף אחד מהמשתמשים לא חבר בערוץ (is_success = true): "אף אחד מהמשתמשים שצוינו לא חבר בערוץ '{שם הערוץ}' בצוות '{שם הצוות}' ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בהפעלת הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: {0}''.format(error.Stacktrace)

אם הצוות לא נמצא: "שגיאה בהפעלת הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: לא נמצאה קבוצה בשם {team, name} ב-Microsoft Teams.

אם הערוץ לא נמצא: "שגיאה בהפעלת הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: לא נמצא ערוץ בשם {channel name} ב-Microsoft Teams.

אם הערך של 'membershipType' (סוג החברות) בערוץ שונה מ-'private' (פרטי): 'שגיאה בהרצת הפעולה 'הסרת משתמשים מהערוץ'. הסיבה: הערוץ בשם {channel name} לא פרטי.

 כללי

יצירת צ'אט

יוצרים צ'אט עם משתמש ב-Microsoft Teams.

פרמטרים

לפעולה הזו אין פרמטרים של קלט.

ריצה

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

  • שם משתמש
  • כתובת אימייל (שם משתמש שתואם לביטוי רגולרי של כתובת אימייל)

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
    "id": "19:b786d3cf-e97d-4511-b61c-0559e9f4da75_cb786032-1ba9-439a-b714-99286e185921@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-10-13T11:24:15.696Z",
    "lastUpdatedDateTime": "2021-10-13T11:24:15.696Z",
    "chatType": "oneOnOne"
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם מדווח קוד הסטטוס 201 (is_success = true): "נוצר צ'אט עם המשתמשים הבאים ב-Microsoft Teams: {entities}"

If the user is not found (is_success = true): "The following users were not found in Microsoft Teams: {entities}"

אם לא נמצאו כל המשתמשים (is_success = false): "None of the provided users were found in Microsoft Teams: {entities}"

אם דווח על קוד סטטוס 400 עבור ישות אחת (is_success = true): "לא הייתה אפשרות ליצור צ'אט עם המשתמשים הבאים ב-Microsoft Teams: {entities}"

אם קוד הסטטוס 400 מדווח על כל הישויות (is_success = false): "לא הייתה אפשרות ליצור צ'אט עם המשתמשים שצוינו ב-Microsoft Teams".

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

אם מדווחת שגיאה קריטית: "שגיאה בהפעלת הפעולה 'יצירת צ'אט'. הסיבה: {0}''.format(error.Stacktrace)

 כללי

הצגת רשימת הצ'אטים

רשימת הצ'אטים הזמינים ב-Microsoft Teams.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
סוג הצ'אט DDL

הכול

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

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

יש לבחור טווח

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

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

לא צוינה

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

  • לא צוינה
  • שווה
  • מכיל
 לא מציינים את לוגיקת הסינון שרוצים להחיל. לוגיקת הסינון פועלת על סמך הערך שמוגדר בפרמטר Filter Key (מפתח סינון).
ערך המסנן String לא רלוונטי לא מציינים באיזה ערך להשתמש במסנן. אם בוחרים באפשרות 'שווה', הפעולה תנסה למצוא את ההתאמה המדויקת בין התוצאות. אם האפשרות 'מכיל' נבחרה, הפעולה תנסה למצוא תוצאות שמכילות את מחרוזת המשנה הזו. אם לא מציינים ערך בפרמטר הזה, המסנן לא יופעל. לוגיקת הסינון פועלת על סמך הערך שמוגדר בפרמטר Filter Key (מפתח סינון).
מספר הרשומות המקסימלי שיוחזר מספר שלם 50 לא מציינים את מספר הרשומות שיוחזרו. אם לא מספקים כלום, הפעולה תחזיר 50 רשומות.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-04-12T08:36:52.572Z",
    "lastUpdatedDateTime": "2021-09-28T09:31:58.045Z",
    "chatType": "oneOnOne",
    "members@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75%40unq.gbl.spaces')/members",
    "members": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyM1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTI=",
            "roles": [
                "Owner"
            ],
            "displayName": "yuriy",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "5af81bea-9c9f-4f9f-8745-9df1fdba8e12",
            "email": null,
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyNiNzg2ZDNjZi1lOTdkLTQ1MTEtYjYxYy0wNTU5ZTlmNGRhNzU=",
            "roles": [
                "Owner"
            ],
            "displayName": "ג'יימס בונד",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "email": "james.bond@siemplifycyarx.onmicrosoft.com",
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        }
    ]
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם הנתונים זמינים (is_success = true): "Successfully found chats for the provided criteria in Microsoft Teams".

אם הנתונים לא זמינים (is_success=false): "לא נמצאו צ'אטים לפי הקריטריונים שצוינו ב-Microsoft Teams".

אם שדה הפרמטר Filter Value (ערך המסנן) ריק (is_success=true):

"המסנן לא הוחל כי הפרמטר 'ערך המסנן' ריק".

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

אם הפרמטר Filter Key (מפתח מסנן) מוגדר לערך Select One (בחירת אפשרות אחת) והפרמטר Filter Logic (לוגיקת סינון) מוגדר לערך Equal (שווה) או Contains (מכיל):

‫"Error executing action "{action name}". הסיבה: צריך לבחור שדה מהפרמטר Filter Key (מפתח מסנן).

אם מספקים ערך לא תקין לפרמטר 'מספר הרשומות המקסימלי להחזרה':

‫"Error executing action "{action name}". סיבה: צוין ערך לא חוקי עבור 'מספר הרשומות המקסימלי להחזרה': . צריך לציין מספר חיובי"."

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

‫"Error executing action "{action name}". הסיבה: {0}''.format(error.Stacktrace)

 כללי
Case Wall Table

שם הטבלה: Available Chats (צ'אטים זמינים)

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

  • מזהה – id
  • סוג – chatType
  • מנויים – קובץ CSV של מנויים/תצוגה
  • נושא שקשור לשמות – נושא
 כללי

שליחת הודעה בצ'אט

שליחת הודעה בצ'אט ב-Microsoft Teams.

פרמטרים

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

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט*

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

אם מדווח על קוד הסטטוס 201 (is_success = true): "ההודעה נשלחה בהצלחה בצ'אט עם מזהה {מזהה הצ'אט} ב-Microsoft Teams".

אם התשובה זמינה (is_success = true): "ההודעה נשלחה בהצלחה והתקבלה תשובה בצ'אט עם מזהה {מזהה הצ'אט} ב-Microsoft Teams".

הודעה אסינכרונית: ממתין לתשובה...

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

אם מדווחת שגיאה קריטית: "Error executing action "Send Chat Message". Reason: {0}''.format(error.Stacktrace)

אם קוד הסטטוס 404 מדווח: "שגיאה בהפעלת הפעולה 'שליחת הודעה בצ'אט'. הסיבה: הצ'אט עם המזהה לא נמצא ב-Microsoft Teams.

אם חלף הזמן הקצוב לתפוגה: "Error executing action "Send Chat Message"." (שגיאה בהפעלת הפעולה 'שליחת הודעה ב-Chat'). הסיבה: ההודעה נשלחה, אבל הפעולה נתקלה בפסק זמן בזמן ההמתנה לתשובה. צריך להגדיל את הזמן הקצוב לתפוגה בסביבת הפיתוח המשולבת ולנסות שוב. הערה: אם תנסו שוב, הפעולה תשלח הודעה נוספת.

 כללי

שליחת תשובה להודעה

שולחים תשובה להודעה בערוץ ב-Microsoft Teams.

פרמטרים

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

מציינים את סוג התוכן של ההודעה.

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

  • טקסט
  • HTML
טקסט String לא רלוונטי כן מציינים את תוכן ההודעה.

ריצה

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

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2')/messages('1686652339690')/replies/$entity",
"id": "1686653341151",
"replyToId": "1686652339690",
"etag": "1686653341151",
"messageType": "message",
"createdDateTime": "2023-06-13T10:49:01.151Z",
"lastModifiedDateTime": "2023-06-13T10:49:01.151Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2/1686653341151?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1686653341151&parentMessageId=1686652339690",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "Reply"
},
"channelIdentity": {
"teamId": "192c0699-fad2-4d02-88a2-84efd6369894",
"channelId": "19:4649fcf41fa5417f9aa78a5840bea442@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
}
Case Wall
סוג התוצאות ערך/תיאור סוג
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של פלייבוק:

אם הערך הוא 201 (is_success = true):
print "Successfully sent a reply to the message in Microsoft Teams."

הפעולה אמורה להיכשל ולהפסיק את ההרצה של פלייבוק:
אם יש שגיאה קריטית:
print "Error executing action \"Send Message Reply\". Reason: {0}''''.format(error.Stacktrace)
אם הצוות לא נמצא:
print "Error executing action \"Send Message Reply\". Reason: team with name {team name} was not found in Microsoft Teams. Please check the spelling.
אם שם הערוץ לא נמצא:
print "Error executing action \"Send Message Reply\". Reason: channel with name {channel name} was not found in Microsoft Teams. Please check the spelling.
אם יש 'שגיאה' בתגובה:
print "Error executing action \"Send Message Reply\". Reason: {error.message}.		 כללי

תעסוקה

כדי להגדיר משימות ב-Google Security Operations, עוברים אל תגובה > מתזמן משימות.

משימת חידוש של טוקן רענון

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

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

נתוני משרות

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

פרמטרים
Login API Root חובה

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

ערך ברירת המחדל הוא https://login.microsoftonline.com.
ספריית הבסיס של ה-API חובה

שורש ה-API של מופע Microsoft Graph.

ערך ברירת המחדל הוא https://graph.microsoft.com.
סביבות שילוב אופציונלי

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

הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת באמצעות פסיקים. תוחמים כל ערך במירכאות (" ").

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