שילוב של Azure API עם Google SecOps

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

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

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

  • חקירה אוניברסלית של Microsoft 365: אפשר להשתמש ביכולת של בקשת HTTP בהתאמה אישית כדי לשלוח שאילתות לכל נקודת קצה (endpoint) של Microsoft Graph, וכך לאפשר לאנליסטים לאסוף נתונים מ-Teams, מ-SharePoint ומ-Exchange בממשק אחד.

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

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

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

  • ניהול אימות מתמשך: משתמשים ב-Refresh Token Renewal Job כדי להחליף באופן אוטומטי טוקנים של OAuth 2.0, וכך לוודא שפלייבוקים אוטומטיים ומשימות איתור שומרים על גישה מאובטחת ורציפה לשירותי Microsoft 365.

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

לפני שאתם מגדירים את השילוב ב-Google SecOps, ודאו שיש לכם את הפרטים הבאים:

  • אפליקציית Microsoft Entra ID: אפליקציה שרשומה בפורטל Microsoft Entra ID כדי לאפשר תקשורת עם ה-API.

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

  • ‫Tenant ID: המזהה הייחודי של המכונה שלכם ב-Azure Active Directory.

  • כתובת URL להפניה אוטומטית: מזהה URI מוגדר להפניה אוטומטית שתואם לזה שצוין בפרמטרים של השילוב.

  • הרשאות API (היקפים): ההרשאות הספציפיות שמוקצות לאפליקציה שלכם על סמך שירותי Azure שאתם מתכוונים לשלוח אליהם שאילתות.

  • טוקן רענון: טוקן שתקף ל-90 ימים ונדרש לגישה קבועה שהוענקה.

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

הגדרת אימות של Azure API

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

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

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

הגדרת אימות שהועבר

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

  1. מציינים את הערכים של Client ID,‏ Client Secret,‏ Scope,‏ Redirect URL ו-Tenant ID בהגדרות השילוב.

  2. מפעילים את הפעולה Get Authorization.

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

  4. מזינים את הקישור שהופניתם אליו כקלט לפעולה Generate Token.

  5. מעתיקים את הטוקן שהוחזר על ידי הפעולה ומזינים אותו ב-Refresh Token במהלך הגדרת השילוב.

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

טוקן הרענון הראשוני תקף ל-90 יום. כדי להבטיח שירות ללא הפרעות, מגדירים את Refresh Token Renewal Job כך שיעדכן באופן אוטומטי את טוקן הרענון של מופע השילוב.

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

כדי לשלב את Azure API, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Microsoft Login API Root

חובה.

שורש ה-API של שירות ההתחברות של Microsoft Identity Platform, שמשמש לאימות של Azure API.

ערך ברירת המחדל הוא https://login.microsoftonline.com.
Microsoft Graph API Root

חובה.

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

ערך ברירת המחדל הוא https://graph.microsoft.com.
Client ID

חובה.

מזהה הלקוח של חשבון Azure API.
Client Secret

חובה.

סוד הלקוח של חשבון Azure API.
Tenant ID

חובה.

מזהה הדייר של חשבון Azure API.
Refresh Token

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

טוקן הרענון שמשמש לגישה באמצעות הענקת הרשאות לחשבון Azure API.

האסימון הזה תקף ל-90 יום, ומקבלים אותו בהגדרה הראשונית.
Verify SSL

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

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

מופעלת כברירת מחדל.
Redirect URL

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

ה-URI להפניה אוטומטית שמשויך לאפליקציית Microsoft Entra ID.

ערך ברירת המחדל הוא http://localhost.
Test URL

חובה.

כתובת ה-URL שמשמשת לאימות של Azure API באמצעות בקשת GET.
Scopes

חובה.

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

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

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

פעולות

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

ביצוע בקשת HTTP

משתמשים בפעולה Execute HTTP Request כדי ליצור ולהפעיל בקשת API מותאמת אישית של HTTP לכתובת URL מסוימת.

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

התנהגות הפעולה

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

סקר אסינכרוני

כשמציינים את Expected Response Values, הפעולה מתבצעת במצב אסינכרוני. במצב הזה, הפעולה דוגמת שוב ושוב את נקודת הקצה (endpoint) כדי לעקוב אחרי הסטטוס של התגובה (לדוגמה, המתנה להשלמת משימה ארוכה).

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

לוגיקה של משפט תנאי

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

  • התאמה לשדה יחיד: הפעולה ממתינה עד ששדה ספציפי יגיע לערך יחיד.

    {
  "state": "finished"
}

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

    {
  "state": ["finished", "error"]
}

  • כמה שדות (לוגיקת AND): הפעולה ממתינה עד שכל השדות שצוינו תואמים לערכים שלהם בו-זמנית.

    {
  "state": "finished",
  "percentage": "100"
}

  • לוגיקה משולבת: אפשר לשלב כמה תנאים באובייקט ה-JSON.

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
התנהגות הניתוח של קובצי JSON

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

  • חיפוש גלובלי: הפעולה מחפשת את המפתחות שצוינו בכל אובייקט התגובה ב-JSON. ציינו את שם המפתח בדיוק כמו שהוא מופיע ב-JSON, בלי להוסיף לפניו שמות של אובייקטים הורים או קידומות (לדוגמה, השתמשו ב-"state", ולא ב-"data_state" או ב-"data-state").

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

    לדוגמה, כדי לחפש את המצב finished בתגובת ה-JSON ולהתעלם ממצבים אחרים, מגדירים את כל המפתחות של state ב-Expected Response Values לערך finished:

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
מבנה המטען הייעודי (payload) של גוף הבקשה

הפעולה יוצרת את גוף הבקשה על סמך הכותרת Content-Type שסופקה ב-Headers.

זהו הקלט של Body Payload שמשמש בדוגמאות הבאות:

{
  "Id": "123123",
  "sorting": "asc"
}

  • ‫application/x-www-form-urlencoded: הפעולה יוצרת את המטען הייעודי (payload) כ-Id=123123&sorting=asc.

  • ‫application/json: הפעולה יוצרת את המטען הייעודי (payload) הבא ב-JSON:

    {
  "Id": "123123",
  "sorting": "asc"
}

  • ‫XML: אם המוצר של הצד השלישי דורש XML, צריך לספק קלט בפורמט XML ישירות ב-Body Payload:

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
טיפול בקבצים

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

  • הורדת קבצים:

    • כדי להחזיר נתוני קבצים כחלק מתוצאת ה-JSON בפורמט base64, בוחרים באפשרות Base64 Output.

    • כדי לשמור קובץ ישירות ב-Case Wall כארכיון ZIP, לוחצים על Save To Case Wall.

  • העלאת קבצים: כדי להעלות קובץ, צריך להמיר אותו למחרוזת בקידוד Base64 ולכלול אותו כחלק מהערך של Body Payload.

    בדוגמה הבאה מוצג קובץ תמונה שהומר למחרוזת בקידוד base64:

    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

  • אבטחה: לקבצים רגישים (כמו תוכנות זדוניות), בוחרים באפשרות Password Protect Zip. הפעולה הזו מצפינה באופן אוטומטי את ארכיון ה-ZIP השמור שנוצר באמצעות Save To Case Wall עם הסיסמה infected.

הגדרת בלוקים של פלייבוקים

ההגדרה הבאה מדגימה איך להשתמש בפעולה Execute HTTP Request בתוך בלוק של פלייבוק. הדוגמה הזו תעזור לכם להבין איך להשתמש בפלייסהולדרים ובקידומות קלט.

כשמשתמשים בקלט של בלוקים כפלייסהולדרים, צריך לכלול את הקידומת Input. (לדוגמה, [Input.comment]).

  • Method:‏ PUT

  • נתיב כתובת ה-URL:

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • כותרות:

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • מטען ייעודי (payload) של גוף ההודעה:

    {
  "work_notes": "[Input.comment]"
}

קלט של הפעולה

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

פרמטר תיאור
Method

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

שיטת ה-HTTP (הפועל) שמשמשת לבקשה.

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

  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS

ערך ברירת המחדל הוא GET.
URL Path

חובה.

נקודת הקצה ל-API שבה הבקשה מבוצעת. הנתיב הזה יכול לכלול פרמטרים של שאילתה.
URL Params

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

הפרמטרים של השאילתה לכתובת ה-URL, שסופקו כאובייקט JSON.

זו שיטת הקלט המומלצת לפרמטר הזה, כי הפרמטרים האלה מצורפים לכל פרמטר של שאילתה שכבר מוגדר ב-URL Path.
Headers

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

הכותרות של בקשת ה-HTTP, שסופקו כאובייקט JSON.

הכותרות שולטות בהיבטים כמו אימות ומגדירות את הפורמט של Body Payload (באמצעות Content-Type).
Cookie

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

קובצי ה-Cookie שנוצרו בכותרת ה-HTTP Cookie, שסופקו כאובייקט JSON.

הפרמטר הזה מבטל את כל ערכי קובצי ה-Cookie שצוינו ב-Headers.
Body Payload

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

המטען הייעודי (payload) של התוכן לבקשת ה-HTTP, שסופק כאובייקט JSON.

הפורמט של הבקשה (JSON או form-urlencoded) נקבע לפי הערך של Content-Type שמוגדר ב-Headers.
Expected Response Values

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

אובייקט ה-JSON שמכיל את צמדי השדה-ערך שמגדירים את המצב הנדרש של גוף התגובה.
Save To Case Wall

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

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

הקובץ נשמר בארכיון עם סיומת .zip. קובץ ה-ZIP הזה לא מוגן בסיסמה, אלא אם מפעילים את Password Protect Zip.
Password Protect Zip

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

אם בוחרים באפשרות הזו, הפעולה מצפינה את ארכיון ה-ZIP שהורד (שנוצר באמצעות Save To Case Wall) באמצעות סיסמה (כמו infected).

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

מופעלת כברירת מחדל.
Follow Redirects

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

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

מופעלת כברירת מחדל.
Fail on 4xx/5xx

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

אם בוחרים באפשרות הזו, הפעולה נכשלת באופן מפורש בשלב שבו תגובת ה-HTTP מחזירה קוד סטטוס של שגיאת לקוח (4xx) או שגיאה בחיבור לשרת (5xx).

מופעלת כברירת מחדל.
Base64 Output

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

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

המחרוזת המקודדת לא יכולה להיות גדולה מ-15MB.
Fields To Return

חובה.

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

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

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding

ערך ברירת המחדל הוא response_data,redirects,response_code,response_cookies,response_headers,apparent_encoding.
Request Timeout

חובה.

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

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

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

הפעולה Execute HTTP Request מספקת את הפלטים הבאים:

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

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

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "example_resource_name",
                       "description": "Description of the object to which the comment belongs."
                   },
                   {
                       "name": "example_user_role",
                       "description": "Description of the user role associated with the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "REDACTED_TRACE_ID",
       "Date": "REDACTED_DATE_TIME",
       "Server": "REDACTED_SERVER_NAME",
       "Content-Length": "REDACTED_VALUE"
   },
   "apparent_encoding": "ascii"
}
הודעות פלט

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

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

Successfully executed API request.

Successfully executed API request, but the status code 4xx_OR_5xx was returned. Please check the request or try again later.

 הפעולה בוצעה בהצלחה.
Failed to execute API request. Error: ERROR_REASON

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

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

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

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

קבלת הרשאה

משתמשים בפעולה Get Authorization כדי להתחיל את תהליך ה-OAuth ולקבל קישור שמכיל את קוד הגישה הנדרש לאימות מיופה כוח.

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

קלט של הפעולה

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

פרמטר תיאור
Oauth Scopes

חובה.

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

ערך ברירת המחדל הוא user.read, offline_access.

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

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

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

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

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

Authorization URL generated successfully. To obtain a URL with access code,Please navigate to the link below as the user that you want to run the integration with., to get a URL with access code. Provide the URL with the access code should be provided next in the Generate Token action.

 הפעולה בוצעה בהצלחה.
Failed to generate the authorization URL! Error is ERROR_REASON

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

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

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

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

יצירת טוקן

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

האסימון הזה נוצר באמצעות כתובת ה-URL להרשאה שהתקבלה מהפעולה Get Authorization.

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

קלט של הפעולה

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

פרמטר תיאור
Authorization URL

חובה.

כתובת ה-URL המלאה להפניה אוטומטית שמכילה את קוד ההרשאה שהתקבל מהפעולה Get Authorization. כתובת ה-URL הזו משמשת לבקשה וליצירה של טוקן הרענון.

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

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

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

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

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

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to enable the integration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. Note: We strongly recommend you configure the "Refresh Token Renewal Job" after you generate the initial refresh token so the job automatically renews and keeps the token valid.

 הפעולה בוצעה בהצלחה.
Failed to get the refresh token! Error is ERROR_REASON

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

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

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

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

פינג

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

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

קלט של הפעולה

אין.

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

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

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

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

{
    "endpoint": "https://api.example-cloud-provider.com/v1.0/health"
}
הודעות פלט

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

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

Successfully tested connectivity.

 הפעולה בוצעה בהצלחה.
Failed to test connectivity. ERROR_REASON

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

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

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

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

תעסוקה

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

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

משתמשים ב-Refresh Token Renewal Job כדי לעדכן מדי פעם את טוקן הרענון שהוגדר לשילוב.

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

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

ב-Refresh Token Renewal Job צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Integration Environments

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

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

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

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