שילוב של Google Translate עם Google SecOps

במסמך הזה מוסבר איך להגדיר את Google Translate ולשלב אותו עם Google Security Operations ‏ (Google SecOps).

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

כדי להשתמש בשילוב, צריך ליצור מפתח API ולהגדיר אותו.

יצירת מפתח API

כדי ליצור מפתח API:

1. במסוף Google Cloud , עוברים אל APIs & Services > Credentials.

   כניסה לדף Credentials

2. לוחצים על add Create credentials.

3. בוחרים באפשרות מפתח API כדי ליצור מפתח API חדש. תיפתח תיבת דו-שיח עם מפתח API שנוצר.

4. כדי להעתיק את מפתח ה-API, לוחצים על העתקה.

הגדרת ההגבלות על מפתחות API

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

1. לוחצים על Restrict key.

2. בקטע API restrictions, בוחרים באפשרות Restrict key.

3. ברשימת ה-API, בוחרים באפשרות Cloud Translation API.

4. מגדירים את ההגבלות הרלוונטיות.

5. לוחצים על שמירה כדי לשמור את ההגדרה של מפתח ה-API.

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

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

פרמטר	תיאור
API Root	חובה. ה-API root של מופע Google Translate. ערך ברירת המחדל הוא https://translation.googleapis.com. מידע נוסף על Cloud Translation API זמין במאמר Cloud Translation API.
API Key	חובה. מפתח ה-API של חשבון Google Translate.
Verify SSL	חובה. אם האפשרות הזו נבחרה, האינטגרציה מאמתת את אישור ה-SSL כשמתחברים לשרת של Google Translate. האפשרות הזו מסומנת כברירת מחדל.

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

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

פעולות

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

רשימת שפות

משתמשים בפעולה List Languages כדי להציג רשימה של השפות הזמינות ב-Google Translate.

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

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

הפעולה List Languages (הצגת רשימת השפות) דורשת את הפרמטרים הבאים:

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

פלט של פעולות

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

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

טבלת קיר עם תושבת

הפעולה List Languages יכולה ליצור את הטבלה הבאה:

שם הטבלה: השפות הזמינות

עמודה בטבלה: מפתח שפה

תוצאה בפורמט JSON

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

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}

הודעות פלט

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

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

תוצאת סקריפט

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

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

פינג

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

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

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

אין.

פלט של פעולות

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

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

הודעות פלט

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

הודעת פלט	תיאור ההודעה
Successfully connected to the Google Translate server with the provided connection parameters!	הפעולה הסתיימה בהצלחה.
Failed to connect to the Google Translate server! Error is ERROR_REASON	הפעולה נכשלה. בודקים את החיבור לשרת, את פרמטרים הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

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

תרגום טקסט

משתמשים בפעולה Translate Text (תרגום טקסט) כדי לתרגם טקסט באמצעות Google Translate.

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

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

הפעולה Translate Text (תרגום טקסט) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Source Language	זה שינוי אופציונלי. שפת המקור של הטקסט. אם לא מגדירים את הפרמטר הזה, הפעולה מזהה את השפה באופן אוטומטי.
Target Language	חובה. שפת יעד. ערך ברירת המחדל הוא en.
Text	חובה. טקסט לתרגום.

פלט של פעולות

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

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

תוצאה בפורמט JSON

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

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}

הודעות פלט

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

הודעת פלט	תיאור ההודעה
Successfully translated the provided text in Google Translate.	הפעולה הסתיימה בהצלחה.
Error executing action "Translate Text". Reason: ERROR_REASON	הפעולה נכשלה. בודקים את החיבור לשרת, את פרמטרים הקלט או את פרטי הכניסה.

תוצאת סקריפט

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

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

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