מדריך לאימות לפני העברת נתונים

נתמך ב:

במסמך הזה מפורטת גישה שיטתית לאבחון, שלב אחר שלב, כדי לאמת את המכונה של Google Security Operations ואת הגדרת האימות לפני ההעברה ל-SOAR. המדריך הזה מתמקד בתקני SAML ו-OIDC שמשמשים לאימות ולהרשאה של משתמשים.

אימות הגדרת Chronicle API

כדי לבדוק אם Chronicle API מוגדר כמו שצריך בפרויקט ב- Google Cloud , פועלים לפי השלבים הבאים:

  1. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט הנכון של Google Cloud מרשימת הפרויקטים בסרגל הניווט העליון.
  2. פותחים את תפריט הניווט (≡) ועוברים אל APIs & Services (ממשקי API ושירותים) > Enabled APIs & services (ממשקי API ושירותים מופעלים).
  3. עוברים לרשימה Enabled APIs & Services כדי למצוא את Chronicle API.
  4. אם הוא מופיע ברשימה: ה-API מופעל.

    אם הוא לא מופיע ברשימה: לוחצים על ‎+ ENABLE APIS AND SERVICES בחלק העליון, מחפשים את Chronicle API ולוחצים על Enable.

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

  1. נכנסים לדף IAM במסוף Google Cloud .
  2. הצגת חשבונות מוסתרים (שלב חיוני): צריך לסמן את התיבה Include Google-provided role grants בצד ימין של סרגל הסינון.
  3. חיפוש הנציג: בסרגל הסינון, מקלידים chronicle. אתם מחפשים כתובת אימייל שתואמת לתבנית הספציפית הזו: service-[PROJECT_NUMBER]@gcp-sa-chronicle.iam.gserviceaccount.com
  4. אימות ההרשאות: מוודאים שיש לו את התפקיד סוכן שירות של Chronicle. אם התפקיד חסר, לוחצים על עריכה Edit ומוסיפים אותו מחדש.

אימות ההגדרה של Google SecOps

  1. במסוף Google Cloud , בוחרים את הפרויקט המתאים ב- Google Cloud מהרשימה.
  2. עוברים אל אבטחה > Google SecOps והכרטיסייה כניסה יחידה (SSO) מופיעה.
  3. אם Google SecOps מופעל, אמורה להופיע כרטיסייה בשם כניסה יחידה (SSO). אם לא, תהליך ההצטרפות של הלקוח הפוטנציאלי לא הושלם. מזינים את מזהה הפרויקט ב- Google Cloud בטופס ב-Google Forms שנמצא בהודעה במוצר. מאשרים את התאריך ואת משבצת הזמן של ההעברה ושולחים את הטופס. אם לא קיבלתם תשובה תוך 72 שעות מרגע השליחה, פנו לכתובת soar-migration-to-gcom@google.com.
  4. אם הכרטיסייה קיימת, לוחצים על Go to SecOps. אם ההתחברות מצליחה, סימן שהגדרת האימות נכונה. אם ההתחברות נכשלת, צריך לוודא שחומת האש או שרת ה-Proxy מאפשרים גישה לדומיינים שמופיעים בקטע גישה לרשת ורשימת היתרים של דומיינים. אם הבעיה נמשכת, אפשר להיעזר בקטע הבא כדי לנפות באגים בהגדרות האישיות.

תהליך SAML ופתרון בעיות

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

ארכיטקטורה של תהליך עבודה לאימות

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

ארכיטקטורה של תהליך עבודה לאימות

הוראות מפורטות לפתרון בעיות

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

‫Google לא ממליצה על מוצר מסוים, אבל הכלים הבאים יכולים לעזור לכם לפתור בעיות בתהליך:

  • אימות SAML: samltool.io
    • המטרה: משמש לפענוח ולאימות של בקשות ותגובות SAML גולמיות.
  • בדיקת JWT: jwt.io
    • המטרה: בדיקת ההצהרות והתוכן של אסימוני JWT ‏(JSON Web Tokens).

שלב 1: הכנת הסביבה

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

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

    • ‫Windows: לוחצים על F12
    • ‫Linux: מקישים על Ctrl + Shift + I
    • ב-macOS: מקישים על Cmd + Option + I
  3. עוברים לכרטיסייה רשת.

  4. מסמנים את התיבה Preserve log כדי לוודא שלא יאבדו נתונים במהלך הפניות אוטומטיות.

    שמירת יומן הרישום

  5. עוברים לכתובת ה-URL של סביבת Google SecOps כדי להתחיל את תהליך ההתחברות. תקבלו את כתובת ה-URL הזו באימייל אחרי שתשלימו את הגדרת Google SecOps בשלב 5 של שלב 1 בתהליך המעבר ללקוחות SOAR עצמאיים. נושא האימייל הוא Your Google SecOps instance is ready.

שלב 2: אימות בקשת ה-SAML ל-IDP

בשלב הזה מאמתים את ההודעה הראשונית שנשלחה על ידי Google Cloud לספק הזהויות (IDP).

  1. מאתרים את הבקשה: בסרגל הסינון של הכרטיסייה Network, מחפשים את saml.

    איתור הבקשה

  2. חילוץ נתונים: בוחרים את הבקשה ולוחצים על הכרטיסייה מטען ייעודי (payload). מאתרים את הפרמטר של מחרוזת השאילתה שנקרא SAMLRequest.

    חילוץ נתונים

  3. פענוח: מעתיקים את ערך הבקשה ומדביקים אותו בכלי אימות SAML (samltool.io) כדי לפענח אותו.

    פענוח

  4. אימות:

    • בודקים את יעד הבקשה.
    • מוודאים שכתובת ה-URL הזו תואמת להגדרות האישיות ב-IDP.

שלב 3: אימות התגובה של SAML מספק הזהויות (IDP)

בשלב הזה מאמתים את המאפיינים שמוחזרים על ידי ה-IDP אל Google Cloud אחרי האימות.

  1. מאתרים את התשובה: בסרגל הסינון של הכרטיסייה Network, מחפשים את signin-callback.

    איתור התשובה

  2. חילוץ נתונים: בוחרים את הבקשה ולוחצים על הכרטיסייה מטען ייעודי (payload). מאתרים את הנתונים של SAMLResponse.

    איתור הנתונים של תגובת SAML

  3. פענוח: מעתיקים את ערך התגובה ומדביקים אותו בכלי אימות SAML.

  4. אימות:

    • בודקים את ההצהרות (המאפיינים) שהוחזרו, כמו groups,‏ first name,‏ last name ו-email.
    • חשוב: ודאו שהמאפיינים האלה תואמים להגדרות של מאגר כוח העבודה ב- Google Cloud.
    • מוודאים שהערכים נכונים למשתמש הספציפי שמנסה להתחבר.

      הגדרות של מאגר כוח עבודה

בתמונה הבאה מוצג מיפוי מאפיינים:

מיפוי מאפיינים

המיפוי בתמונה הוא כזה:

  • google.subject = assertion.subject
  • attribute.last_name = assertion.attributes.last_name[0]
  • attribute.user_email = assertion.attributes.user_email[0]
  • attribute.first_name = assertion.attributes.first_name[0]
  • google.groups = assertion.attributes.groups

החלק השמאלי תמיד זהה, זה התחביר של Google. הצד השמאלי הוא לפי מפתחות המאפיינים של טענת הנכוֹנוּת שמוצגים בתגובת ה-SAML.

המאפיין [0] הוא קריטי למאפיינים הספציפיים שצוינו (last_name,‏ user_email,‏ first_name), ולא רלוונטי ל-subject ול-groups.

שלב 4: אימות של Google SecOps

בשלב הזה מאמתים אם Google Cloud מאמת את המשתמש כדי להתחבר ל-Google SecOps SOAR.

  1. מאתרים את האסימון בדפדפן של המשתמש: בסרגל הסינון של הכרטיסייה רשת, מחפשים את נקודת הקצה auth/siem.

    איתור הטוקן בדפדפן של המשתמש

  2. חילוץ נתונים: בוחרים את הבקשה ומציגים את הכרטיסייה מטען ייעודי (payload). מאתרים את המחרוזת jwt.

  3. פענוח: מעתיקים את מחרוזת ה-JWT ומדביקים אותה בכלי JWT Inspection ‏(jwt.io).

    מעתיקים את מחרוזת ה-JWT ומדביקים אותה

  4. אימות:

    • משווים בין ההצהרות המפוענחות של given_name,‏ family_name,‏ email ו-idpgroups.
    • אישור התאמה: הערכים האלה חייבים להתאים בדיוק למאפיינים שאומתו בשלב 3 (תגובת SAML).
    • אם הערכים תואמים ועדיין אין לכם גישה, בדקו את הקצאת התפקידים ב-IAM. מוודאים שלכל המשתמשים מוקצה אחד מהתפקידים המוגדרים מראש ב-Chronicle, באמצעות פורמט החשבון הייעודי הנכון להגדרת הזהות (איחוד שירותי אימות הזהות של כוח עבודה או Cloud Identity לחשבונות בניהול Google).

שלב 5: אימות הגישה להרשאות SOAR

השלב הזה מאשר שהמערכת מקצה הרשאות ב-SOAR בצורה נכונה דרך הדף Group Mapping בפלטפורמה.

לאדמינים יש גישה אוטומטית ל-SOAR כי הדף מיפוי קבוצות מאפשר גישה כברירת מחדל.

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

  1. מעתיקים את מיפויי הקבוצות מהדף Group Mappings במכונה הקיימת של SOAR.
  2. מבקשים ממשתמש בקבוצת ה-IdP לגשת לכתובת ה-URL החדשה של Google SecOps.
  3. אם המשתמש לא יכול לגשת ל-SOAR, נסו את השלבים הבאים לפתרון בעיות:

    א. בודקים את התגובה: פותחים את הבקשה של auth/siem משלב 4 ולוחצים על הכרטיסייה תצוגה מקדימה.

    ב. בדיקת ההרשאות: מאתרים את האובייקט permissions בתגובת ה-JSON.

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

תהליך OIDC ופתרון בעיות

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

ארכיטקטורה של תהליך עבודה לאימות

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

ארכיטקטורה של תהליך עבודה לאימות

הוראות מפורטות לפתרון בעיות ב-OIDC

כדי לאבחן ולעקוב אחרי תהליך האימות של OIDC בצורה יעילה, אתם יכולים להשתמש בכלים למפתחים בדפדפן ובמפענחי JWT אונליין.

  • בדיקת JWT: jwt.io
    • המטרה: בדיקת ההצהרות והתוכן של אסימוני JWT‏ (JSON Web Tokens).

שלב 1: הכנת הסביבה

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

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

    • ‫Windows: לוחצים על F12
    • ‫Linux: מקישים על Ctrl + Shift + I
    • ב-macOS: מקישים על Cmd + Option + I
  3. עוברים לכרטיסייה רשת.

  4. מסמנים את התיבה Preserve log כדי לוודא שלא יאבדו נתונים במהלך הפניות אוטומטיות.

    שמירת יומן הרישום

  5. עוברים לכתובת ה-URL של סביבת Google SecOps כדי להתחיל את תהליך ההתחברות. תקבלו את כתובת ה-URL הזו באימייל אחרי שתשלימו את הגדרת Google SecOps בשלב 5 של שלב 1 בתהליך המעבר ללקוחות SOAR עצמאיים. נושא האימייל הוא YourGoogle SecOps instance is ready.

שלב 2: אימות בקשת ההרשאה לספק OIDC

בשלב הזה מאמתים את ההפניה האוטומטית הראשונית מ- Google Cloud לספק OpenID Connect‏ (IdP).

  1. מאתרים את הבקשה: בכרטיסייה Network, מחפשים את ההפניה האוטומטית הראשונית לנקודת הקצה לאימות של ספק ה-OIDC. כתובת ה-URL בדרך כלל מכילה פרמטרים כמו client_id,‏ redirect_uri,‏ scope,‏ response_type ו-state.

    איתור הבקשה

  2. אימות:

    • מוודאים שהערך של client_id תואם לערך שהוגדר בספק ה-OIDC.
    • חשוב לוודא שהערך של redirect_uri זהה בדיוק לערך של https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_ID, ולהחליף את POOL_ID ואת PROVIDER_ID במאגר ובספק מאיחוד שירותי אימות הזהות של כוח העבודה.
    • מוודאים שהשדה response_type מוגדר כקוד.
    • שימו לב לפרמטר scope, שצריך לכלול את openid וכל היקף אחר שנדרש כדי לשחרר את ההצהרות הנדרשות (לדוגמה, אימייל, פרופיל).

שלב 3: אימות של הקריאה החוזרת (callback) והחלפת הטוקנים

בשלב הזה מאמתים את התשובה של ה-IdP שחוזרת אל Google Cloud.

  1. מאתרים את הקריאה החוזרת (callback): בכרטיסייה רשת, מאתרים את הבקשה לכתובת ה-URL של הקריאה החוזרת לכניסה: (.../signin-callback/...).

    איתור הקריאה החוזרת (callback)

  2. בדיקת הנתונים: בודקים את הפרמטרים של כתובת ה-URL בבקשה הזו. הוא צריך להכיל פרמטר קוד שסופק על ידי ספק הזהויות של OIDC.

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

    • אימות הפצת המאפיינים והטוקן המלא: כדי לוודא שמיפוי המאפיינים באיחוד שירותי אימות הזהות של כוח עבודה מניב את התוצאות הצפויות:
      • מוסיפים את כתובת ה-URI להפניה אוטומטית, שמופיעה בהגדרות של ספק איחוד שירותי אימות הזהות של כוח העבודה, לכתובות ה-URI להפניה אוטומטית של הספק (לדוגמה, https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID).
      • כדי לנפות באגים באסימון ה-IdP, עוברים לספק של איחוד שירותי אימות הזהות של כוח עבודה. אפשר גם לבדוק את הטוקן המלא. מידע נוסף זמין במאמר אימות הגדרת המוצר.

    הצגת הטוקן המלא אימות מאפיינים

שלב 4: אימות של Google SecOps

בשלב הזה מאמתים אם Google Cloud מאמת את המשתמש כדי להתחבר ל-Google SecOps SOAR.

  1. מאתרים את האסימון בדפדפן של המשתמש: בסרגל הסינון של הכרטיסייה רשת, מחפשים את נקודת הקצה auth/siem.

    איתור הטוקן בדפדפן של המשתמש

  2. חילוץ נתונים: בוחרים את הבקשה ומציגים את הכרטיסייה מטען ייעודי (payload). מאתרים את המחרוזת jwt.

  3. פענוח: מעתיקים את מחרוזת ה-JWT ומדביקים אותה בכלי JWT Inspection ‏(jwt.io).

    מעתיקים את מחרוזת ה-JWT ומדביקים אותה

  4. אימות:

    • משווים בין ההצהרות המפוענחות של sub,‏ given_name,‏ family_name,‏ email ו-idpgroups.
    • אישור התאמה: הערכים האלה חייבים להתאים למאפיינים שספק ה-OIDC שלכם משחרר, ולאופן שבו הם ממופים במיפוי המאפיינים של איחוד שירותי אימות הזהות של כוח העבודה. לדוגמה, attribute.first_name ב- Google Cloud צריך למפות ל-given_name ב-JWT.
    • תפקידי IAM: אם ההצהרות נכונות אבל הגישה נדחית עם הודעה כמו Cannot Authenticate user, because user does not have access to the GCP project...,, צריך לבדוק את הקצאות התפקידים ב-IAM. מוודאים שהקבוצות של המשתמש (idp_groups ב-JWT) קיבלו את התפקידים הנדרשים בפורמט principalSet הנכון (לדוגמה, principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/IDP_GROUP_NAME).

שלב 5: אימות הגישה להרשאות SOAR

השלב הזה מאשר שהמערכת מקצה הרשאות ב-SOAR בצורה נכונה דרך הדף Group Mapping בפלטפורמה.

לאדמינים יש גישה אוטומטית ל-SOAR כי הדף מיפוי קבוצות מאפשר גישה כברירת מחדל.

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

  1. מעתיקים את מיפויי הקבוצות מהדף Group Mappings במכונה הקיימת של SOAR.
  2. מבקשים ממשתמש בקבוצת ה-IdP לגשת לכתובת ה-URL החדשה של Google SecOps.
  3. אם המשתמש לא יכול לגשת ל-SOAR, נסו את השלבים הבאים לפתרון בעיות:

    א. בודקים את התגובה: פותחים את הבקשה של auth/siem משלב 4 ולוחצים על הכרטיסייה תצוגה מקדימה.

    ב. בדיקת ההרשאות: מאתרים את האובייקט permissions בתגובת ה-JSON.

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

שגיאות נפוצות ב-OIDC:

  • ‫invalid_redirect_uri מ-IdP: ודאו שכתובת ה-URI להפניה אוטומטית שהוגדרה ב-IdP זהה לכתובת https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_ID, והחליפו את POOL_ID ואת PROVIDER_ID במאגר ובספק מאיחוד שירותי אימות הזהות של כוח עבודה. השגיאה הזו תופיע גם אם יש לוכסן בסוף הכתובת או אם יש חוסר התאמה בין http ל-https.
  • הצהרות חסרות ב-JWT:

    1. בצד של ה-IdP: מוודאים שלקוח ה-OIDC מוגדר לשחרר את ההצהרות הנדרשות (שממופות ב-WIF, כמו sub,‏ groups,‏ email,‏ given_name,‏ family_name) בטוקן של המזהה.

    2. בצד של WIF: ודאו שההצהרות הנכנסות האלה ממופות בצורה נכונה בקטע WIF Attribute Mapping (לדוגמה, google.groups=assertion.groups). אם יש הצהרה בטוקן אבל היא לא ממופה ב-WIF, יכול להיות שפלטפורמת ה-SOAR לא תצליח לאשר את המשתמש. כדי לוודא שמיפוי המאפיינים מניב את התוצאות הצפויות, עיינו בקטע אימות הגדרת הספק.

מיפוי קבוצות אחרי ההעברה

מיפוי הקבוצות נשאר קריטי ב-Google SecOps אחרי שההעברה מסתיימת

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

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