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

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

הערה: בפלטפורמת Google SecOps, השילוב של Akeyless נקרא Akeyless Security.

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

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

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

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

• רוטציית פרטי כניסה אוטומטית: אפשר להפיץ מפתחות API, טוקנים וסיסמאות שעברו רוטציה מ-Akeyless לשילובים, למחברים ולמשימות של Google SecOps, על ידי מיפוי פרמטרים לגרסת הסוד של latest, כדי למנוע שיבושים שנגרמים כתוצאה מפרטי כניסה שפג תוקפם.

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

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

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

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

• פרטי כניסה של מפתח API: מזהה גישה ומפתח גישה של Akeyless לאימות.

  מידע נוסף מופיע במאמר בנושא אימות מפתח API ללא מפתח.

• הרשאות גישה: הרשאות קריאה שניתנו לשיטת האימות שלכם לגבי הסודות ש-Google SecOps מאחזר.

  מידע נוסף זמין במאמר בקרת גישה מבוססת-תפקיד (RBAC) של Akeyless.

• קישוריות לרשת: גישה לרשת ממכונת Google SecOps או מהסוכן המרוחק לכתובת ה-URL של API Gateway של Akeyless.

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

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

פרמטר	תיאור
API Gateway URL	זה שינוי אופציונלי. כתובת ה-URL של שער ה-API של Akeyless. ערך ברירת המחדל הוא https://api.akeyless.io.
Access ID	חובה. מזהה הגישה של שיטת האימות של מפתח ה-API של Akeyless.
Access Key	חובה. מפתח הגישה שמשויך למזהה הגישה שלכם ב-Akeyless.
Verify SSL	חובה. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Akeyless. מופעלת כברירת מחדל.

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

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

פעולות

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

קבלת ערך הסוד

משתמשים בפעולה Get Secret Value (קבלת ערך סודי) כדי לאחזר ערך סודי מ-Akeyless לשימוש ב-playbooks.

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

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

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

הפעולה Get Secret Value (קבלת ערך סודי) דורשת את הפרמטרים הבאים:

פרמטר	תיאור
Secret Name	חובה. השם או הנתיב של הסוד שצריך לאחזר מ-Akeyless. כדי לאחזר את הגרסה העדכנית, מזינים את הפקודה SECRET_NAME או את הפקודה SECRET_NAME:latest. כדי לאחזר גרסה ספציפית, מזינים את הערך SECRET_NAME:VERSION_NUMBER, כאשר VERSION_NUMBER הוא מספר שלם חיובי (לדוגמה, /prod/api-key:2).

פלטים של פעולות

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

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

תוצאת JSON

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

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}

הודעות פלט

ב-Case Wall, הפעולה Get Secret Value מספקת את הודעות הפלט הבאות:

הודעת פלט	תיאור ההודעה
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security.	הפעולה בוצעה בהצלחה.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON	הפעולה נכשלה. מוודאים שנתיב הסוד והגרסה קיימים ב-Akeyless ושפרטי כניסה לאימות שלכם כוללים גישת קריאה לסוד.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').	הפעולה נכשלה. בודקים את הפורמט של הפרמטר Secret Name.

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

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

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

פינג

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

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

קלט של הפעולה

אין.

פלטים של פעולות

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

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

הודעות פלט

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

הודעת פלט	תיאור ההודעה
Successfully connected to the Akeyless server with the provided connection parameters!	הפעולה בוצעה בהצלחה.
Failed to connect to the Akeyless server! Reason: ERROR_REASON	הפעולה נכשלה. צריך לוודא שההגדרות של API Gateway URL, Access ID, Access Key ו-SSL נכונות.

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

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

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

תעסוקה

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

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

אתם יכולים להשתמש ב-Sync Integration Credentials Job כדי לסנכרן באופן אוטומטי את הסודות ששמורים ב-Akeyless עם המופעים, המחברים והמשימות של השילובים שהגדרתם ב-Google SecOps.

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

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

פרמטר	תיאור
API Gateway URL	זה שינוי אופציונלי. כתובת ה-URL של שער ה-API של Akeyless. ערך ברירת המחדל הוא https://api.akeyless.io.
Access ID	חובה. מזהה הגישה של שיטת האימות של מפתח ה-API של Akeyless.
Access Key	חובה. מפתח הגישה שמשויך למזהה הגישה שלכם ב-Akeyless.
Verify SSL	חובה. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת Akeyless. מופעלת כברירת מחדל.
Environment Name	חובה. סביבת Google SecOps שבה מוגדרים מופעי השילוב, המחברים והמשימות. ערך ברירת המחדל הוא Default Environment.
Credential Mapping	חובה. מילון JSON או YAML שממפה מופעי שילוב, מחברים ומשימות של היעד לסודות של Akeyless שמכילים את ערכי הפרמטרים שלהם. צריך לכלול לפחות פרמטר ממופה אחד במפתחות integration_instances, connectors או jobs. כשממפים פרמטר, צריך להפנות לגרסאות באחת מהדרכים הבאות: ‫הגרסה העדכנית (‎`SECRET_NAME` ‎ או ‎`SECRET_NAME:latest`‎): מאחזרת את ערך הסוד האחרון מ-Akeyless ומעדכנת את הפרמטר הממופה בכל פעם שהמשימה פועלת. השתמשו בפורמט הזה לסודות שמתחלפים באופן קבוע. גרסה ספציפית (`SECRET_NAME:VERSION_NUMBER`): מאחזר גרסה ספציפית של הסוד, כאשר VERSION_NUMBER הוא מספר שלם חיובי (לדוגמה, /secops/prod/jira-api-token:2). אחרי שהפרמטר יעודכן לגרסה הזו, הפעלות עתידיות של המשימה ידלגו על עדכון הפרמטר, אלא אם תשנו את הסוד או הגרסה הממופים. לדוגמה של Credential Mapping. ערך ברירת המחדל הוא {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

דוגמה לערכים בשדה Credential Mapping

בדוגמה הבאה אפשר לראות איך ממפים פרמטרים של מופעי אינטגרציה, מחברים ומשימות בפרמטר Credential Mapping:

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

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