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

GitSync

‫GitSync הוא שילוב שמיועד ל-Google SecOps ומסנכרן נכסים ורכיבים של אוטומציה של אבטחה עם מאגר Git חיצוני (כמו GitHub, ‏GitLab או Bitbucket). הוא מאפשר סנכרון דו-כיווני של תוכן, ומספק ניהול גרסאות אוטומטי, גיבוי של הגדרות וקידום בין סביבות שונות לאורך מחזור החיים של פעולות האבטחה. שימו לב ש-GitSync נועד לגבות ולהעביר נכסים בין סביבות קשורות (כמו פיתוח, Staging וייצור), ולא להפיץ נכסים בין מערכות לא קשורות שבהן מזהים פנימיים של מסדי נתונים עלולים לגרום להתנגשות.

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

השילוב של GitSync תומך בתרחישי השימוש העיקריים הבאים:

ניהול גרסאות ויכולת ביקורת (אבטחה כקוד): מעקב אחרי שינויים, בדיקת הבדלים ושמירה של היסטוריית גרסאות מלאה של שינויים בפלייבוקים, במחברים, בשילובים ובהגדרות המערכת.
קידום בסביבות מרובות (צינור עיבוד נתונים של CI/CD): קידום פלייבוקים, מיפויים של אונטולוגיה והגדרות שילוב באופן שיטתי מסביבות פיתוח ו-staging לסביבת הייצור, באמצעות בקשות משיכה ומיזוגים של הסתעפויות.
גיבוי והתאוששות מאסון: שחזור של פלייבוקים והגדרות פלטפורמה שנמחקו בטעות, נפגמו או הוגדרו באופן שגוי, ישירות ממאגר Git.
סטנדרטיזציה בסביבות שונות: הפצה של פלייבוקים סטנדרטיים, משפחות ויזואליות בהתאמה אישית והגדרות של מחברים בסביבות קשורות של Google SecOps ממאגר מרכזי.
בידוד של הסתעפויות וסביבות Staging: אתם יכולים לבדוק פלייבוקים ניסיוניים והסתעפויות של תכונות בסביבות ייעודיות, בלי להשפיע על תהליכי העבודה או על לוחות הזמנים בסביבת הייצור.
בדיקה ושיתוף פעולה אופליין: ייצוא הגדרות הפלטפורמה כ-JSON ו-Markdown כדי לאפשר בדיקה על ידי עמיתים, אימות אוטומטי ובדיקה בכלי למפתחים סטנדרטיים.
בלוקים של תהליכי עבודה לשימוש חוזר: סנכרון של בלוקים מודולריים של תהליכי עבודה לצד פלייבוקים מלאים או בנפרד מהם, כדי שהצוותים יוכלו לשתף שלבי אוטומציה נפוצים.

תהליכי עבודה להטמעה לפי מטרה עסקית

כדי לעבור ישירות להנחיות שמתאימות ליעד הנוכחי שלכם, בחרו את תהליך העבודה:

פריסה חדשה של GitSync או הסתעפות חדשה: אם אתם מגדירים את השילוב של GitSync בפעם הראשונה או יוצרים הסתעפות חדשה של מאגר, בצעו את רצף ההגדרה הבא מקצה לקצה:
1. משלימים את הגדרת הדרישות המוקדמות ופרטי הכניסה.
2. מגדירים את המופע המשותף של השילוב.
3. בודקים את הקישוריות לרשת ואת האימות באמצעות פעולת הפינג.
4. מריצים משימת Push Content ראשונית כדי לאכלס את הסניף לפני שמריצים משימות Pull.
5. להגדיר ולתזמן משימות סנכרון אוטומטיות.
הפניה למשימה ולמאגר:
- כדי לראות את הפרמטרים של ההגדרות ולהריץ משימות דחיפה או משיכה עצמאיות לנכסים ספציפיים (פלייבוקים, מחברים, שילובים וכו'), קראו את המאמר משימות.
- כדי לראות את הפריסה הרגילה של המאגר, עיינו במאמר מבנה הספרייה של המאגר.
פתרון בעיות בסנכרון: אם פעולה או משימה נכשלת ומופיעה שגיאה, עיינו בקטע פתרון בעיות.

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

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

שימוש במאגר Git פרטי עם הרשאת כתיבה: ודאו שיש לכם הרשאות כתיבה במאגר Git פרטי מרוחק שמתארח אצל ספק Git נתמך (כמו GitHub,‏ GitLab או Bitbucket). פרמטרים מסוג Password לא נכללים כברירת מחדל, אלא אם מפעילים את Commit Passwords. כל שאר הפרמטרים (כמו מזהי אפליקציות, מזהי לקוחות, שמות משתמשים ונקודות קצה) מיוצאים כטקסט פשוט. אל תשתמשו במאגר ציבורי עם GitSync.
מאתחלים את המאגר המרוחק: מוודאים שיש במאגר המרוחק לפחות קובץ אחד (כמו README.md או .gitignore). ‫GitSync לא יכול לסנכרן למאגר ריק.
הכנת פרטי כניסה לאימות ב-Git: יוצרים פרטי כניסה לאימות עם הרשאות כתיבה במאגר. ‫GitSync תומך במפתחות פרטיים של SSH בקידוד base64 (מומלץ), בטוקנים לגישה אישית (PAT) ובפרטי כניסה בסיסיים של שם משתמש וסיסמה.

כדי ליצור ולקודד מפתח SSH, קראו את המאמר יצירת מפתחות SSH ל-GitSync.
בדיקת הקישוריות לרשת ו-VPC Service Controls: ודאו שלמכונה של Google SecOps או ל-runner המרוחק יש גישה לחומת האש היוצאת ביציאת TCP‏ 443 (ל-HTTPS) או ביציאת TCP‏ 22 (ל-SSH) לספק ה-Git.

אם בסביבתGoogle Cloud נעשה שימוש בגבולות גזרה לשירות של VPC Service Controls, צריך לבקש מהאדמין של Google Cloud להגדיר כללי תעבורת נתונים נכנסת ויוצאת כדי שהשילובים של התגובות יוכלו לתקשר עם ממשקי ה-API ונקודות הקצה החיצוניות הנדרשים של Google Cloud .
קבלת טביעת האצבע של מארח Git (מומלץ): כדי להגן מפני התקפות מסוג אדם בתווך (PITM), צריך לאחזר את טביעת האצבע של המפתח הציבורי של שרת Git לצורך הצמדת טביעת האצבע של המארח.

במאמר הפעלה של הצמדת טביעת אצבע של מארח מוסבר איך להגדיר את זה.
מתן הרשאות עריכה לפלייבוקים: אם אתם מתכוונים לסנכרן פלייבוקים עם גישת ברירת מחדל מוגבלת (למשל, הרשאות ברירת מחדל שמוגדרות ליכולת צפייה), תנו לתפקיד ה-SOC ב-Administrator הרשאות יכולת עריכה במערכת המקור לפני הפעלת משימות הסנכרון.

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

יצירת מפתחות SSH ל-GitSync

כדי להגדיר אימות מאובטח ללא סיסמה באמצעות מפתחות SSH:

יוצרים זוג מפתחות RSA או Ed25519 בטרמינל. כשמופיעה בקשה להזין ביטוי סיסמה, מקישים על Enter כדי להשאיר אותו ריק:
```
ssh-keygen -b 2048 -t rsa -f ./id_rsa
```
הפקודה הזו יוצרת שני קבצים: id_rsa (מפתח פרטי) ו-id_rsa.pub (מפתח ציבורי).
מוסיפים את המפתח הציבורי (id_rsa.pub) לשירות האירוח המרוחק של Git כמפתח פריסה או כמפתח גישה עם הרשאות כתיבה.
ממירים את המפתח הפרטי למחרוזת בקידוד Base64 בשורה אחת:
- Linux / macOS:
```
base64 -w 0 ./id_rsa
```
- Windows (PowerShell):
```
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes(".\id_rsa"))
```
מעתיקים את מחרוזת ה-base64 שנוצרה ומדביקים אותה בפרמטר Git Password/Token/מפתח SSH כשמגדירים את המכונה של שילוב GitSync.

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

הצמדת טביעת האצבע של המארח מאמתת את הזהות של שרת Git בזמן החיבור, כדי להגן מפני התקפות מסוג "אדם בתווך" (PITM). הפרמטר Git Server Fingerprint הוא אופציונלי, אבל אם מגדירים אותו, GitSync מתחבר רק למארח Git המאומת.

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

אחזור טביעת האצבע של המארח: מריצים את הפקודה ssh-keyscan בטרמינל מול שם המארח של שרת Git:
```
ssh-keyscan -t rsa <hostname>
```
לדוגמה, ב-GitHub, מריצים את הפקודה ssh-keyscan -t rsa github.com. פלט הפקודה מפיק שורה של מפתח מארח ציבורי, שדומה לזו:
```
github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...
```
שמירת טביעת האצבע להגדרה: מעתיקים את שורת המפתח הציבורי של המארח. מזינים את הערך הזה בפרמטר Git Server Fingerprint כשמגדירים את המכונה של שילוב GitSync (כדי להחיל אותו על כל המשימות) או במשימות סנכרון ספציפיות (כדי לשנות את ההגדרה למארחים ספציפיים).

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

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

ב-Google SecOps, עוברים אל Playbooks ובוחרים את הפלייבוק הרצוי.
פותחים את הגדרות ההרשאות של הפלייבוק.
מוסיפים את תפקיד ה-SOC של Administrator לרשימת הישויות ומגדירים את ההרשאה שלו ל-Can Edit.

חזרה לגרסה 53.0

בגרסה 53.0 של GitSync בוצעו שינויים ב-Chronicle API ובסכימות הייצוא של JSON, שגרמו לכשלים בסנכרון. כדי לפתור את הבעיות האלה, גרסה 54.0 של GitSync מבטלת את השינויים של גרסה 53.0 ומשחזרת את בסיס הקוד של גרסה יציבה 52.0.

כדי לעבור לגרסה 52.0 או לגרסה 54.0 ולשחזר ענף מאגר תואם, צריך לבצע את השלבים הבאים:

השהיית משימות סנכרון מתוזמנות: משביתים את כל משימות GitSync המתוזמנות הפעילות (כמו Push Content ו-Pull Content) כדי שהמשימות לא יפעלו בזמן שאתם מחליפים גרסאות והסתעפויות.
עוברים לגרסה 54.0 או חוזרים לגרסה 52.0: ב-Content Hub, מאתרים את השילוב של GitSync:
- אם גרסה 54.0 זמינה, משדרגים את השילוב לגרסה 54.0.
- אם גרסה 54.0 עדיין לא הופיעה (מטמוני Content Hub מסתנכרנים בערך כל 8 שעות) או אם אתם מעדיפים לשדרג לאחור ישירות, החזירו את גרסת השילוב לגרסה 52.0.
מפנים את GitSync להסתעפות הקודמת של המאגר: הסתעפויות של מאגרים שמאוכלסות באמצעות גרסה 53.0 משתמשות בסכימת JSON שונה שלא תואמת לגרסה 52.0 או 54.0:
- אם יצרתם ענף נפרד לגרסה 53.0 (לדוגמה, gitsync-chronicle-api): עוברים אל הגדרות > שילובים > GitSync, משנים את הפרמטר Branch בחזרה לענף המקורי (לדוגמה, main), ומריצים את הפעולה Ping כדי לאמת את הקישוריות.
- אם החלפתם את ההסתעפות הקיימת בגרסה 53.0: שחזרו את ההסתעפות מ backup-legacy-pre-migrationתג ה-Git (או מה-commit האחרון לפני גרסה 53), או הסירו את הספריות שיוצאו בגרסה 53.0 (Playbooks/,‏ Connectors/,‏ Integrations/,‏ Jobs/,‏ Ontology/,‏ SimulatedCases/ ו-Settings/) והריצו משימה מלאה של Push Content מ גרסה 52.0 או 54.0 כדי לאכלס מחדש את ההסתעפות.
המשך המשימות המתוזמנות: אחרי שמוודאים שההסתעפות מכילה הגדרות שיוצאו בגרסה 52.0 או 54.0, מפעילים מחדש את משימות GitSync המתוזמנות.

כללי הגנה על הסתעפויות: GitSync דוחף פריטי commit ישירות למאגר המרוחק ולא יוצר בקשות משיכה. אם בענף שהגדרתם (למשל main) נאכפים כללי הגנה על ענפים שדורשים בקשות משיכה או אישורי בדיקה, פעולות דחיפה ישירות מ-GitSync ייכשלו. חשוב לוודא שהאדמין של המאגר מגדיר חריגה שמאפשרת למפתח הפריסה או לחשבון של GitSync להעביר ב-push ישירות לענף היעד, או להגדיר את GitSync כך שישלח לענף ייעודי וימזג את השינויים ב-main באמצעות תהליך העבודה הרגיל של בקשת משיכה (pull request).

הגדרת השילוב

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

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

פרמטר	תיאור
`Repo URL`	חובה. כתובת ה-URL של מאגר Git המרוחק. כשמשתמשים באימות HTTPS, כתובת ה-URL חייבת להתחיל ב-`https://` (לדוגמה, `https://github.com/organization/secops-platform.git`). כשמשתמשים באימות SSH, כתובת ה-URL חייבת להתחיל ב-`git@` או ב-`ssh://` (לדוגמה, `git@github.com:organization/secops-platform.git`).
`Branch`	חובה. ההסתעפות של מאגר Git לסנכרון (לדוגמה, `main`).
`Git Password/Token/SSH Key`	חובה. פרטי הכניסה לאימות של מאגר Git המרוחק. הפרמטר הזה מקבל סיסמה לחשבון Git, טוקן גישה אישי (PAT) או מפתח פרטי של SSH בקידוד base64 (RSA 2048-bit או Ed25519).
`Git Username`	זה שינוי אופציונלי. שם המשתמש של החשבון ב-Git. נדרש כשמשתמשים באימות של שם משתמש וסיסמה דרך HTTPS.
`Git Server Fingerprint`	זה שינוי אופציונלי. המפתח הציבורי של המארח ב-SSH של שרת ה-Git המרוחק (לדוגמה, `github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...`). הגדרת הפרמטר הזה מאפשרת הצמדה של טביעת האצבע של המארח, כדי לוודא ש-GitSync מתחבר רק למארח Git המאומת שלכם, ומפחיתה את הסיכונים של התקפת אדם באמצע (PITM). כדי לאחזר את הערך הזה, קראו את המאמר הפעלת הצמדה של טביעת אצבע למארח.
`Commit Author`	זה שינוי אופציונלי. זהות המחבר שמצורפת ל-Git commits יוצאים שנוצרו על ידי GitSync. הפורמט צריך להיות לפי הסטנדרט של Git: `Name <email@domain.com>` (ברירת המחדל היא `GitSync <gitsync@siemplify.co>`).
`Siemplify Verify SSL`	חובה. אם בוחרים באפשרות הזו, השילוב מאמת את אישור ה-SSL של נקודת הקצה ל-API של Google SecOps. מופעלת כברירת מחדל.
`Git Verify SSL`	חובה. אם בוחרים באפשרות הזו, השילוב מאמת את אישור ה-SSL של שרת ספק ה-Git המרוחק. מופעלת כברירת מחדל.
`SOAR Username`	זה שינוי אופציונלי. שם המשתמש ב-Google SecOps של חשבון עם הרשאות עריכה של פלייבוקים. צריך לספק את הפרמטר הזה אם מפתח ה-API שמוגדר כברירת מחדל נכשל בגלל מגבלות הרשאה.
`SOAR Password`	זה שינוי אופציונלי. הסיסמה שתואמת ל-`SOAR Username` שהוגדר.

פעולות

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

פינג

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

קלט של הפעולה

אין.

פלט של פעולות

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

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

הודעות פלט

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

הודעת פלט	תיאור ההודעה
`Successfully executed action "Ping".`	הפעולה הצליחה והקישוריות למאגר אומתה.
`Error executing action "Ping". Reason: ERROR_REASON`	הפעולה נכשלה. צריך לאמת את כתובת ה-URL של המאגר, שם ההסתעפות, פרטי הכניסה או נתיבי הרשת.

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

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

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

תעסוקה

‫GitSync מספק 16 הגדרות של משימות סנכרון (2 משימות של מכונות מלאות ו-7 זוגות של משימות עצמאיות) לניהול נכסי הפלטפורמה. המשימות האלה תומכות בהיקפי הסנכרון המלאים ברמת המכונה ובהיקפי הסנכרון הממוקדים והעצמאיים.

היקף הסנכרון והנכסים הנתמכים

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

סנכרון מלא של המכונה (Push Content ו-Pull Content): סנכרון של כל פלטפורמת Google SecOps בפעולה אחת בכמות גדולה.

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

מספקת זוגות ייעודיים של משימות דחיפה ומשיכה לשבעה נכסים ספציפיים. כדאי להשתמש במשימות עצמאיות כשמפתחים, מעדכנים או בודקים רכיבים נפרדים בלי לסנכרן את שאר הסביבה או להחליף אותה:
- פלייבוקים ובלוקים של תהליכי עבודה: Push Playbook ו-Pull Playbook
- מחברים: Push Connectors ו-Pull Connector
- שילובים: Push Integration ו-Pull Integration
- משימות מתוזמנות: Push Job ו-Pull Jobs
- מיפויים אונטולוגיים: Push Mappings ו-Pull Mappings
- משפחות של רכיבים חזותיים בהתאמה אישית: Push Custom Family ו-Pull Custom Family
- מקרים של בדיקות סימולציה: Push Simulated Cases ו-Pull Simulated Cases

מבנה הספרייה של המאגר

כשמריצים משימה ראשונית של Push Content (חובה לפני שמריצים משימות pull בסניף חדש או בסניף שהועבר), נוצרים במאגר ה-Git המרוחק מבנה הספרייה המוגדר מראש, קובצי התצורה של JSON, קובץ המטא-נתונים ברמה הבסיסית (GitSync.json) והמסמכים שנוצרו ב-README.md.

אל תשנו את מבנה המאגר באופן ידני: GitSync מסתמך על פריסת הספרייה המוגדרת מראש ועל קובץ המטא-נתונים ברמה הבסיסית (root) GitSync.json כדי לעקוב אחרי נכסי הפלטפורמה ולפתור בעיות שקשורות אליהם. שינוי ידני של שמות קבצים, העברת ספריות או שינוי המבנה של המאגר באמצעות פקודות commit בהתאמה אישית עלולים לגרום לכשל במשימות הסנכרון.

├── Connectors/
│   └── <Integration_Name>/
│       └── <Connector_Name>/
│           ├── <Connector_Name>.json
│           └── README.md
├── Integrations/
│   └── <Integration_Identifier>/
│       ├── Actions/
│       ├── Connectors/
│       ├── Dependencies/
│       ├── Jobs/
│       ├── Managers/
│       ├── Resources/
│       ├── Integration-<Integration_Identifier>.def
│       └── README.md
├── Jobs/
│   ├── <Job_Name>.json
│   └── README.md
├── Ontology/
│   ├── Mappings/
│   │   └── <Source_Name>/
│   │       ├── <Source_Name>_Records.json
│   │       ├── <Source_Name>_Rules.json
│   │       └── README.md
│   └── VisualFamilies/
│       └── <Family_Name>/
│           ├── <Family_Name>.json
│           ├── <Family_Name>.png
│           └── README.md
├── Playbooks/
│   ├── README.md
│   └── <Folder_Name>/
│       └── <Playbook_Or_Block_Name>/
│           ├── <Playbook_Or_Block_Name>.json
│           └── README.md
├── Settings/
│   ├── blacklists.json
│   ├── caseCloseCauses.json
│   ├── caseTitles.json
│   ├── customLists.json
│   ├── domains.json
│   ├── dynamicParameters.json
│   ├── emailTemplates.json
│   ├── environments.json
│   ├── integrationInstances.json
│   ├── logo.json
│   ├── networks.json
│   ├── slaDefinitions.json
│   ├── stages.json
│   └── tags.json
├── SimulatedCases/
│   └── <Case_Name>.case
├── GitSync.json
└── README.md

משימות סנכרון ברמת המכונה

משימות ברמת המכונה מסנכרנות קטגוריות נכסים נבחרות בכל מכונה של Google SecOps.

תוכן בדחיפה

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

קלט של המשימה

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

פרמטר	תיאור
`Commit`	חובה. הודעת ה-commit ב-Git שמתארת את השינויים בתוכן שיוצא.
`Commit Passwords`	זה שינוי אופציונלי. אם בוחרים באפשרות הזו, המשימה מייצאת פרמטרים מסוג `Password` בטקסט פשוט בשביל מופעי שילוב, מחברים ומשימות שהוגדרו. אזהרה: אל תפעילו את האפשרות הזו במאגרים ציבוריים או משותפים, כי היא חושפת את פרטי הכניסה בטקסט פשוט. חשוב לזכור שגם אם `Commit Passwords` מושבת, פרמטרים שהם לא מסוג `Password` (כמו מזהי אפליקציות, מזהי לקוחות, שמות משתמשים וכתובות URL) תמיד מיוצאים כטקסט פשוט.
פרמטרים לבחירת נכסים: `Integrations`, `Playbooks`, `Jobs`, `Connectors`, `Simulated Cases`, `Integration Instances`, `Visual Families`, `Mappings`, `Environments`, `Dynamic Parameters`, `Logo`, `Case Tags`, `Case Stages`, `Case Title Settings`, `Case Close Reasons`, `Networks`, `Domains`, `Custom Lists`, `Email Templates`, `Blacklists`, `SLA Records`	אופציונלי (מתגים בוליאניים). בוחרים את כל קטגוריות הנכסים שרוצים לכלול בייצוא.
`Repo URL`	זה שינוי אופציונלי. מבטלת את כתובת ה-URL של המאגר שהוגדרה במופע השילוב.
`Branch`	זה שינוי אופציונלי. מבטל את ההגדרה של ענף המאגר במופע השילוב.
`Commit Author`	זה שינוי אופציונלי. מבטל את מחבר ה-commit שהוגדר במופע השילוב. צריך להשתמש בפורמט `Name <email@domain.com>`.
`Git Server Fingerprint`	זה שינוי אופציונלי. מבטלת את טביעת האצבע של מארח ה-SSH שהוגדרה במופע השילוב.

תוצאות המשימה

המשימה כותבת קובצי תצורה בפורמט JSON וסיכומי README.md לענף היעד ב-Git בהיררכיית הספריות הרגילה (/Playbooks,‏ /Connectors,‏ /Integrations,‏ /Jobs,‏ /Ontology/Mappings,‏ /Ontology/VisualFamilies,‏ /SimulatedCases ו-/Settings) ומוציאה יומני ביצוע למסוף של מריץ המשימות. שילובים בהתאמה אישית מיוצאים כחבילות שלמות, ואילו שילובים מסחריים מייצאים רק סקריפטים בהתאמה אישית או שינויים שנוספו לשילוב.

משיכת תוכן

משתמשים במשימה Pull Content כדי לאחזר קטגוריות הגדרה נבחרות מהענף המוגדר של מאגר Git ולהחיל אותן על פלטפורמת Google SecOps.

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

קלט של המשימה

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

פרמטר	תיאור
פרמטרים לבחירת נכסים: `Integrations`, `Playbooks`, `Jobs`, `Connectors`, `Simulated Cases`, `Integration Instances`, `Visual Families`, `Mappings`, `Environments`, `Dynamic Parameters`, `Logo`, `Case Tags`, `Case Stages`, `Case Title Settings`, `Case Close Reasons`, `Networks`, `Domains`, `Custom Lists`, `Email Templates`, `Blacklists`, `SLA Records`	אופציונלי (מתגים בוליאניים). בוחרים את כל קטגוריות הנכסים שרוצים לייבא מהמאגר לסביבה שלכם.
`Repo URL`	זה שינוי אופציונלי. מבטלת את כתובת ה-URL של המאגר שהוגדרה במופע השילוב.
`Branch`	זה שינוי אופציונלי. מבטל את ההגדרה של ענף המאגר במופע השילוב.
`Git Server Fingerprint`	זה שינוי אופציונלי. מבטלת את טביעת האצבע של מארח ה-SSH שהוגדרה במופע השילוב.

תוצאות המשימה

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

משימות סנכרון עצמאיות

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

פלייבוק להתראות Push

משתמשים במשימה Push Playbook כדי לייצא ל-Git פלייבוקים ספציפיים או בלוקים של תהליכי עבודה לשימוש חוזר.

קלט של המשימה

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

פרמטר	תיאור
`Commit`	חובה. הודעת ה-commit ב-Git שמתארת את השינויים בפלייבוק.
`Playbook Whitelist`	זה שינוי אופציונלי. רשימה מופרדת בפסיקים של שמות מדויקים של פלייבוקים או בלוקים לייצוא, תלויי אותיות רישיות. צריך לציין את `Playbook Whitelist` או את `Folders Whitelist`.
`Folders Whitelist`	זה שינוי אופציונלי. רשימה מופרדת בפסיקים של שמות תיקיות (קטגוריות) של פלייבוקים. כל הפלייבוקים והבלוקים שנמצאים בתיקיות האלה מיוצאים.
`Include Playbook Blocks`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייצאת בלוקים של תהליכי עבודה לשימוש חוזר לצד הפלייבוקים שנבחרו, כולל כל הבלוקים שמופיעים כשלבים בפלייבוקים האלה.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן מותאם אישית שנוסף ל-`README.md` שנוצר לכל הפלייבוקים שנדחפו בהפעלה הזו ונשמרו בקובץ המטא-נתונים ברמה הבסיסית (root) של `GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

הפעולה הזו מייצאת את הפלייבוקים שנבחרו ואת הבלוקים של תהליכי העבודה שנכללים בהם אל /Playbooks/<Folder_Name>/<Playbook_Name>/ ומעדכנת את /Playbooks/README.md.

הפעלת הפלייבוק

משתמשים במשימה Pull Playbook כדי לייבא פלייבוקים או בלוקים ספציפיים מ-Git.

קלט של המשימה

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

פרמטר	תיאור
`Playbook Whitelist`	חובה. רשימה מופרדת בפסיקים של שמות מדויקים של פלייבוקים או בלוקים שרוצים לייבא מהמאגר.
`Include Playbook Blocks`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייבאת באופן אוטומטי את כל הבלוקים של תהליכי העבודה לשימוש חוזר שאליהם מפנים הפלייבוקים שנבחרו.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

מייבאת לפלטפורמה את הפלייבוקים והבלוקים שצוינו מ-/Playbooks (או /Blocks), ומתקינה קודם את הבלוקים שאליהם מפנים לפני התקנת הפלייבוקים הראשיים.

מחברים מסוג Push

משתמשים במשימה Push Connectors כדי לייצא הגדרות של מחברים ל-Git.

קלט של המשימה

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

פרמטר	תיאור
`Connectors`	חובה. רשימה מופרדת בפסיקים של שמות המחברים שרוצים לייצא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Include Mappings`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייצאת את רשומות המיפוי של האונטולוגיה ואת הכללים שמשויכים לשילוב של המחבר אל `/Ontology/Mappings`.
`Include Visual Families`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייצאת אל `/Ontology/VisualFamilies` את משפחות הרכיבים החזותיים בהתאמה אישית שמשויכות לרשומות האונטולוגיה של המחבר.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן בהתאמה אישית שנוסף ל-`README.md` שנוצר לכל המחברים שנדחפו בהפעלה הזו ונשמרו ב-`GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

ייצוא של הגדרות המחבר ולוחות הזמנים אל /Connectors/<Integration_Name>/<Connector_Name>/ (יחד עם מיפויים של אונטולוגיה ומשפחות חזותיות, אם נבחרו).

מחבר משיכה

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

קלט של המשימה

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

פרמטר	תיאור
`Connector Name`	חובה. השם המוצג של המחבר שרוצים לייבא מהמאגר.
`Include Mappings`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייבאת את מיפויי האונטולוגיה שמשויכים לשילוב של המחבר.
`Include Visual Families`	זה שינוי אופציונלי. אם האפשרות הזו נבחרת, המערכת מייבאת את משפחות הרכיבים החזותיים בהתאמה אישית שמשויכות לשילוב של המחבר.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

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

שילוב של התראות

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

קלט של המשימה

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

פרמטר	תיאור
`Push Whitelist`	חובה. רשימה מופרדת בפסיקים של מזהי שילובים לייצוא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן בהתאמה אישית שנוסף לקובץ `README.md` שנוצר לכל השילובים שנדחפו בהפעלה הזו ונשמרו ב-`GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

ייצוא הגדרות של שילובים, סקריפטים בהתאמה אישית (Actions/,‏ Connectors/,‏ Jobs/,‏ Managers/), יחסי תלות ומסמכי תיעוד של README.md אל /Integrations/<Integration_Identifier>/.

שילוב של משיכת נתונים

משתמשים במשימה Pull Integration כדי לייבא מ-Git שילובים בהתאמה אישית או סקריפטים בהתאמה אישית לשילובים מסחריים. בשילובים מסחריים, GitSync מתקין את הגרסה העדכנית של השילוב מ-Content Hub ושומר בה את הסקריפטים בהתאמה אישית.

קלט של המשימה

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

פרמטר	תיאור
`Install Whitelist`	חובה. רשימה מופרדת בפסיקים של מזהי אינטגרציות שרוצים לייבא מהמאגר.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

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

משימת דחיפה

משתמשים במשימה Push Job כדי לייצא ל-Git הגדרות של משימות מתוזמנות בפלטפורמה.

קלט של המשימה

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

פרמטר	תיאור
`Job Whitelist`	חובה. רשימה מופרדת בפסיקים של שמות המשימות המתוזמנות שרוצים לייצא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן מותאם אישית שנוסף ל-`README.md` שנוצר לכל המשימות שנדחפו בהפעלה הזו ונשמרו ב-`GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

מייצאת את הפרמטרים של המשימה ואת מרווחי הזמן של לוח הזמנים אל /Jobs/<Job_Name>.json ומעדכנת את /Jobs/README.md.

משימות משיכה

משתמשים במשימה Pull Jobs כדי לייבא משימות מתוזמנות של הפלטפורמה מ-Git.

קלט של המשימה

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

פרמטר	תיאור
`Job Whitelist`	חובה. רשימה מופרדת בפסיקים של שמות של משימות מתוזמנות לייבוא מהמאגר.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

מגדירה ורושמת את המשימות המתוזמנות שצוינו במתזמן המשימות של הפלטפורמה.

מיפויים של התראות

משתמשים במשימה Push Mappings כדי לייצא ל-Git רשומות וכללים של מיפוי אירועים באונטולוגיה ממקור ספציפי.

קלט של המשימה

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

פרמטר	תיאור
`Source`	חובה. מקור האונטולוגיה (שם השילוב) שאת רשומות המיפוי והכללים שלו רוצים לייצא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן בהתאמה אישית שנוסף ל-`README.md` שנוצר לכל המיפויים שנדחפו בהפעלה הזו ונשמרו ב-`GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

כתיבת רשומות אונטולוגיה (<Source>_Records.json), כללי מיפוי (<Source>_Rules.json) ו-README.md אל /Ontology/Mappings/<Source>/.

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

משתמשים במשימה Pull Mappings כדי לייבא רשומות וכללים של מיפוי אונטולוגיה למקור ספציפי מ-Git.

קלט של המשימה

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

פרמטר	תיאור
`Source`	חובה. מקור האונטולוגיה (שם השילוב) שאת כללי ורשומות המיפוי שלו רוצים לייבא.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

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

משפחת גופנים מותאמת אישית ב-Push

משתמשים במשימה Push Custom Family כדי לייצא ל-Git הגדרות וסמלים של משפחות חזותיות בהתאמה אישית.

קלט של המשימה

כדי להגדיר את המשימה Push Custom Family, משתמשים בפרמטרים הבאים:

פרמטר	תיאור
`Family Name`	חובה. רשימה מופרדת בפסיקים של שמות משפחות של גופנים חזותיים בהתאמה אישית לייצוא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.
`Readme Addon`	זה שינוי אופציונלי. תוכן מותאם אישית שנוסף ל-`README.md` שנוצר לכל משפחות הרכיבים החזותיים המותאמים אישית שנדחפו בהפעלה הזו ונשמרו ב-`GitSync.json`. תומך גם בתחביר Markdown וגם בתבניות Jinja.

תוצאות המשימה

מייצא הגדרות חזותיות של משפחות (<Family_Name>.json), קובצי תמונות של סמלים (<Family_Name>.png) ו-README.md אל /Ontology/VisualFamilies/<Family_Name>/.

משפחת גופנים מותאמת אישית מסוג Pull

משתמשים במשימה Pull Custom Family כדי לייבא מ-Git הגדרה וסמל של משפחה חזותית בהתאמה אישית.

קלט של המשימה

כדי להגדיר את המשימה Pull Custom Family, משתמשים בפרמטרים הבאים:

פרמטר	תיאור
`Family Name`	חובה. השם המדויק של משפחת הרכיבים החזותיים בהתאמה אישית שרוצים לייבא.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

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

העברת פניות מדומות

משתמשים במשימה Push Simulated Cases כדי לייצא מקרי בדיקה מדומים ל-Git.

קלט של המשימה

כדי להגדיר את המשימה Push Simulated Cases, משתמשים בפרמטרים הבאים:

פרמטר	תיאור
`Simulated Cases`	חובה. רשימה מופרדת בפסיקים של שמות של מקרים מדומים לייצוא.
`Commit`	חובה. הודעת ה-commit ב-Git.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Commit Author`	זה שינוי אופציונלי. ההגדרה הזו משנה את מחבר ברירת המחדל של ה-commit.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

ייצוא של פניות סימולציה כקובצי .case אל /SimulatedCases/<Case_Name>.case.

שליפת פניות לדוגמה

משתמשים במשימה Pull Simulated Cases כדי לייבא מ-Git מקרי בדיקה מדומים.

קלט של המשימה

כדי להגדיר את המשימה Pull Simulated Cases, משתמשים בפרמטרים הבאים:

פרמטר	תיאור
`Simulated Cases`	חובה. רשימה מופרדת בפסיקים של שמות של מקרים מדומים שרוצים לייבא מהמאגר.
`Repo URL`	זה שינוי אופציונלי. המדיניות הזו מבטלת את כתובת ה-URL של מאגר ברירת המחדל.
`Branch`	זה שינוי אופציונלי. המדיניות הזו מבטלת את ענף ברירת המחדל.
`Git Server Fingerprint`	זה שינוי אופציונלי. המדיניות הזו מבטלת את טביעת האצבע של מארח ה-SSH שמוגדרת כברירת מחדל.

תוצאות המשימה

ייבוא של המקרים המדומים שצוינו לקטלוג המקרים המדומים של הפלטפורמה.

פתרון בעיות

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

הודעת שגיאה שזוהתה	סיבה תפעולית	תהליך התיקון
`AttributeError: 'OnePlatformSoarApi' object has no attribute 'update_ide_item'` או כשלים בסנכרון ב-GitSync בגרסה 53.0	הפעלת חבילת GitSync גרסה 53.0 הרגרסיבית, שמכילה בעיות סנכרון ידועות עם פריטי IDE בהתאמה אישית וסכימות JSON שהשתנו.	ב-Content Hub, מחזירים את GitSync לגרסה 52.0 או משדרגים לגרסה 54.0, ומוודאים שהפרמטר Branch מפנה להסתעפות של המאגר מלפני גרסה 53. הוראות מפורטות זמינות במאמר חזרה לגרסה 53.0 ותאימות לגרסאות 52.0 ו-54.0.
‫`Permission denied (publickey)` או `Host key verification failed` (או `Authentication failed for 'https://...'`)	האימות של Git נכשל בגלל פורמט לא תקין של פרטי כניסה, חוסר בהרשאות כתיבה של מפתח פריסה או טביעת אצבע לא תואמת של המארח.	אימות SSH: מוודאים שמפתח ה-SSH הפרטי מומר למחרוזת base64 בשורה אחת, בלי שורות חדשות או רווחים בסוף. מוודאים שהמפתח הציבורי התואם רשום במאגר Git עם גישת כתיבה. טביעת אצבע של המארח: אם הצמדת טביעת האצבע של המארח מופעלת, מאמתים את מחרוזת טביעת האצבע באמצעות `ssh-keyscan -t rsa <hostname>` ומעדכנים את הפרמטר טביעת אצבע של שרת Git. אימות HTTPS: מוודאים שהתוקף של טוקן הגישה האישי (PAT) לא פג ושיש לו היקף כתיבה במאגר.
`403 Forbidden: Insufficient permissions to modify playbook` (או `Failed to push playbook: Access denied`)	לפלייבוק היעד יש הרשאות גישה מוגבלות כברירת מחדל (למשל הרשאת צפייה), ולתפקיד `Administrator` SOC לא ניתנו הרשאות עריכה במערכת המקור.	ב-Google SecOps, עוברים אל Playbooks, בוחרים את הפלייבוק הרלוונטי, פותחים את הגדרות ההרשאות שלו ומוסיפים את תפקיד SOC של `Administrator` עם הרשאות Can Edit (או מגדירים את הפרמטרים האופציונליים SOAR Username ו-SOAR Password במופע של שילוב GitSync). הוראות מפורטות להגדרת הרשאות לפלייבוק
הזמן הקצוב לפעולות משיכת תוכן או משיכת שילוב הוא 5 דקות	התקנה של כמה שילובים מסחריים מ-Content Hub במהלך פעולת משיכה אחת חרגה ממגבלת הזמן הקצוב של 5 דקות לביצוע משימה.	מתקינים באופן ידני את השילובים המסחריים הנדרשים מ-Content Hub לפני שמפעילים את משיכת התוכן, או מפעילים מחדש את משימת משיכת התוכן כדי להמשיך לייבא את שאר הנכסים.
‫`General error performing Job Pull Content` (או `400 Bad Request` / `404 Not Found` כשמושכים מענף של מאגר)	ניסיון למשוך מענף מאגר שלא אותחל או מענף שקובצי ה-JSON שלו יוצאו באמצעות סכימה לא תואמת של GitSync בגרסה 53.0.	אם הענף שונה באמצעות GitSync בגרסה 53.0, צריך להחזיר את הפרמטר Branch לענף המאגר שלפני גרסה 53, או לשחזר את הגיבוי של הענף שלפני גרסה 53 (ראו חזרה לגרסה קודמת של גרסה 53.0 ותאימות לגרסאות 52.0 ו-54.0). אם אתם מגדירים סניף חדש בגרסה 52.0 או 54.0, קודם צריך להריץ משימה מלאה של דחיפת תוכן כדי לאכלס את הסניף, ורק אז להריץ משימות משיכה.
`Playbook '<Playbook_Name>' is assigned to environment(s) that don't exist`	פלייבוק או בלוק שמיובאים מוקצים לסביבה או לקבוצת סביבות שלא נוצרו במכונה של היעד.	מפעילים את Pull Content (משיכת תוכן) כשהאפשרות Environments (סביבות) נבחרה קודם, או יוצרים באופן ידני את הסביבה החסרה ב-Settings > Access Management > Environments (הגדרות > ניהול גישה > סביבות) במופע היעד לפני שמושכים פלייבוקים.
`Commit Author parameter must be in the following format: Name <example@gmail.com>`	בפרמטר Commit Author (מחבר ה-commit) במופע השילוב או בהגדרת המשימה חסרה כתובת אימייל בסוגריים זוויתיים.	מעדכנים את הפרמטר Commit Author כך שיתאים לפורמט הנדרש: `Name <email@domain.com>` (לדוגמה, `GitSync <gitsync@example.com>`).
‫`400 Bad Request` או `409 Conflict` כשמייבאים מיפויים של אונטולוגיה	כללי מיפוי האירועים במאגר מתנגשים עם כללי האונטולוגיה הקיימים בפלטפורמה, או שהם יוצאו באמצעות גרסת GitSync לא תואמת.	מפעילים משימה חדשה של Push Mappings (דחיפת מיפויים) באמצעות GitSync בגרסה 54.0 או 52.0 כדי לייצא מחדש את הגדרות המיפוי, או פותרים את הבעיה של כללי מיפוי אירועים כפולים בהגדרות > אונטולוגיה > כללי מיפוי לפני שמפעילים מחדש את המשימה.

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