מדריך לאימות לפני העברת נתונים
במסמך הזה מפורטת גישה שיטתית לאבחון, שלב אחר שלב, כדי לאמת את המכונה של Google Security Operations ואת הגדרת האימות לפני ההעברה ל-SOAR. המדריך הזה מתמקד בתקני SAML ו-OIDC שמשמשים לאימות ולהרשאה של משתמשים.
אימות הגדרת Chronicle API
כדי לבדוק אם Chronicle API מוגדר כמו שצריך בפרויקט ב- Google Cloud , פועלים לפי השלבים הבאים:
- נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט הנכון של Google Cloud מרשימת הפרויקטים בסרגל הניווט העליון.
- פותחים את תפריט הניווט (≡) ועוברים אל APIs & Services (ממשקי API ושירותים) > Enabled APIs & services (ממשקי API ושירותים מופעלים).
- עוברים לרשימה Enabled APIs & Services כדי למצוא את
Chronicle API. אם הוא מופיע ברשימה: ה-API מופעל.
אם הוא לא מופיע ברשימה: לוחצים על + ENABLE APIS AND SERVICES בחלק העליון, מחפשים את
Chronicle APIולוחצים על Enable.
כדי לוודא שחשבון השירות נוצר, מבצעים את הפעולות הבאות:
- נכנסים לדף IAM במסוף Google Cloud .
- הצגת חשבונות מוסתרים (שלב חיוני): צריך לסמן את התיבה Include Google-provided role grants בצד ימין של סרגל הסינון.
- חיפוש הנציג: בסרגל הסינון, מקלידים
chronicle. אתם מחפשים כתובת אימייל שתואמת לתבנית הספציפית הזו:service-[PROJECT_NUMBER]@gcp-sa-chronicle.iam.gserviceaccount.com - אימות ההרשאות: מוודאים שיש לו את התפקיד סוכן שירות של Chronicle. אם התפקיד חסר, לוחצים על עריכה Edit ומוסיפים אותו מחדש.
אימות ההגדרה של Google SecOps
- במסוף Google Cloud , בוחרים את הפרויקט המתאים ב- Google Cloud מהרשימה.
- עוברים אל אבטחה > Google SecOps והכרטיסייה כניסה יחידה (SSO) מופיעה.
- אם Google SecOps מופעל, אמורה להופיע כרטיסייה בשם כניסה יחידה (SSO). אם לא, תהליך ההצטרפות של הלקוח הפוטנציאלי לא הושלם. מזינים את מזהה הפרויקט ב- Google Cloud בטופס ב-Google Forms שנמצא בהודעה במוצר. מאשרים את התאריך ואת משבצת הזמן של ההעברה ושולחים את הטופס. אם לא קיבלתם תשובה תוך 72 שעות מרגע השליחה, פנו לכתובת soar-migration-to-gcom@google.com.
- אם הכרטיסייה קיימת, לוחצים על Go to SecOps. אם ההתחברות מצליחה, סימן שהגדרת האימות נכונה. אם ההתחברות נכשלת, צריך לוודא שחומת האש או שרת ה-Proxy מאפשרים גישה לדומיינים שמופיעים בקטע גישה לרשת ורשימת היתרים של דומיינים. אם הבעיה נמשכת, אפשר להיעזר בקטע הבא כדי לנפות באגים בהגדרות האישיות.
תהליך SAML ופתרון בעיות
בקטע הזה נסביר בקצרה על תהליך האימות באמצעות SAML ואיך לאבחן ולפתור בעיות נפוצות בהגדרות.
ארכיטקטורה של תהליך עבודה לאימות
כדי לבודד נקודות כשל, חשוב להבין את תהליך הבקשה. בתרשים הבא מוצג הנתיב הרציף של התחברות מוצלחת.

הוראות מפורטות לפתרון בעיות
כדי לאבחן ולעקוב אחרי תהליך האימות ב-SAML בצורה יעילה, אתם יכולים להשתמש בכלים מבוססי-האינטרנט שמפורטים בקטעים הבאים.
Google לא ממליצה על מוצר מסוים, אבל הכלים הבאים יכולים לעזור לכם לפתור בעיות בתהליך:
- אימות SAML: samltool.io
- המטרה: משמש לפענוח ולאימות של בקשות ותגובות SAML גולמיות.
- בדיקת JWT: jwt.io
- המטרה: בדיקת ההצהרות והתוכן של אסימוני JWT (JSON Web Tokens).
שלב 1: הכנת הסביבה
לפני שמתחילים, צריך לוודא שסביבת הדפדפן מוכנה לתעד את התנועה ברשת. כדי לעשות את זה, מבצעים את השלבים הבאים:
- פותחים כרטיסייה חדשה בדפדפן או משתמשים בחלון פרטי.
פותחים את הכלים למפתחים באמצעות מקש הקיצור של מערכת ההפעלה:
- Windows: לוחצים על F12
- Linux: מקישים על Ctrl + Shift + I
- ב-macOS: מקישים על Cmd + Option + I
עוברים לכרטיסייה רשת.
מסמנים את התיבה Preserve log כדי לוודא שלא יאבדו נתונים במהלך הפניות אוטומטיות.

עוברים לכתובת ה-URL של סביבת Google SecOps כדי להתחיל את תהליך ההתחברות. תקבלו את כתובת ה-URL הזו באימייל אחרי שתשלימו את הגדרת Google SecOps בשלב 5 של שלב 1 בתהליך המעבר ללקוחות SOAR עצמאיים. נושא האימייל הוא
Your Google SecOps instance is ready.
שלב 2: אימות בקשת ה-SAML ל-IDP
בשלב הזה מאמתים את ההודעה הראשונית שנשלחה על ידי Google Cloud לספק הזהויות (IDP).
מאתרים את הבקשה: בסרגל הסינון של הכרטיסייה Network, מחפשים את
saml.
חילוץ נתונים: בוחרים את הבקשה ולוחצים על הכרטיסייה מטען ייעודי (payload). מאתרים את הפרמטר של מחרוזת השאילתה שנקרא
SAMLRequest.
פענוח: מעתיקים את ערך הבקשה ומדביקים אותו בכלי אימות SAML (
samltool.io) כדי לפענח אותו.
אימות:
- בודקים את יעד הבקשה.
- מוודאים שכתובת ה-URL הזו תואמת להגדרות האישיות ב-IDP.
שלב 3: אימות התגובה של SAML מספק הזהויות (IDP)
בשלב הזה מאמתים את המאפיינים שמוחזרים על ידי ה-IDP אל Google Cloud אחרי האימות.
מאתרים את התשובה: בסרגל הסינון של הכרטיסייה Network, מחפשים את
signin-callback.
חילוץ נתונים: בוחרים את הבקשה ולוחצים על הכרטיסייה מטען ייעודי (payload). מאתרים את הנתונים של
SAMLResponse.
פענוח: מעתיקים את ערך התגובה ומדביקים אותו בכלי אימות SAML.
אימות:
- בודקים את ההצהרות (המאפיינים) שהוחזרו, כמו
groups,first name,last nameו-email. - חשוב: ודאו שהמאפיינים האלה תואמים להגדרות של מאגר כוח העבודה ב- Google Cloud.
מוודאים שהערכים נכונים למשתמש הספציפי שמנסה להתחבר.

- בודקים את ההצהרות (המאפיינים) שהוחזרו, כמו
בתמונה הבאה מוצג מיפוי מאפיינים:

המיפוי בתמונה הוא כזה:
google.subject = assertion.subjectattribute.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.
מאתרים את האסימון בדפדפן של המשתמש: בסרגל הסינון של הכרטיסייה רשת, מחפשים את נקודת הקצה
auth/siem.
חילוץ נתונים: בוחרים את הבקשה ומציגים את הכרטיסייה מטען ייעודי (payload). מאתרים את המחרוזת
jwt.פענוח: מעתיקים את מחרוזת ה-JWT ומדביקים אותה בכלי JWT Inspection (jwt.io).

אימות:
- משווים בין ההצהרות המפוענחות של
given_name,family_name,emailו-idpgroups. - אישור התאמה: הערכים האלה חייבים להתאים בדיוק למאפיינים שאומתו בשלב 3 (תגובת SAML).
- אם הערכים תואמים ועדיין אין לכם גישה, בדקו את הקצאת התפקידים ב-IAM. מוודאים שלכל המשתמשים מוקצה אחד מהתפקידים המוגדרים מראש ב-Chronicle, באמצעות פורמט החשבון הייעודי הנכון להגדרת הזהות (איחוד שירותי אימות הזהות של כוח עבודה או Cloud Identity לחשבונות בניהול Google).
- משווים בין ההצהרות המפוענחות של
שלב 5: אימות הגישה להרשאות SOAR
השלב הזה מאשר שהמערכת מקצה הרשאות ב-SOAR בצורה נכונה דרך הדף Group Mapping בפלטפורמה.
לאדמינים יש גישה אוטומטית ל-SOAR כי הדף מיפוי קבוצות מאפשר גישה כברירת מחדל.
כדי לאמת את הגישה של המשתמשים לקבוצה, אתם יכולים להוסיף כמה מיפויים של קבוצות IDP במופע החדש הזה של SOAR. כברירת מחדל, במופעים חדשים הדף מיפוי קבוצות ריק. כדי לאמת את הגישה של משתמשים אחרים לקבוצה, צריך להוסיף מיפויים של קבוצות IDP למכונה החדשה של SOAR. לשם כך, מבצעים את השלבים הבאים:
- מעתיקים את מיפויי הקבוצות מהדף Group Mappings במכונה הקיימת של SOAR.
- מבקשים ממשתמש בקבוצת ה-IdP לגשת לכתובת ה-URL החדשה של Google SecOps.
אם המשתמש לא יכול לגשת ל-SOAR, נסו את השלבים הבאים לפתרון בעיות:
א. בודקים את התגובה: פותחים את הבקשה של
auth/siemמשלב 4 ולוחצים על הכרטיסייה תצוגה מקדימה.ב. בדיקת ההרשאות: מאתרים את האובייקט
permissionsבתגובת ה-JSON.
אופציונלי: כדי לחסוך זמן, אפשר להעתיק את המיפויים האלה למכונה הקיימת של Google SecOps בקטע הגדרות > מתקדם > מיפוי קבוצות.
תהליך OIDC ופתרון בעיות
בקטע הזה נסביר בקצרה על תהליך האימות של OIDC ואיך לאבחן ולפתור בעיות נפוצות בשילוב.
ארכיטקטורה של תהליך עבודה לאימות
כדי לבודד נקודות כשל, חשוב להבין את תהליך הבקשה. בתרשים הבא מוצג הנתיב הרציף של התחברות מוצלחת.

הוראות מפורטות לפתרון בעיות ב-OIDC
כדי לאבחן ולעקוב אחרי תהליך האימות של OIDC בצורה יעילה, אתם יכולים להשתמש בכלים למפתחים בדפדפן ובמפענחי JWT אונליין.
- בדיקת JWT: jwt.io
- המטרה: בדיקת ההצהרות והתוכן של אסימוני JWT (JSON Web Tokens).
שלב 1: הכנת הסביבה
לפני שמתחילים, צריך לוודא שסביבת הדפדפן מוכנה לתעד את הרשת. לשם כך, מבצעים את השלבים הבאים:
- פותחים כרטיסייה חדשה וריקה בדפדפן או בחלון פרטי.
פותחים את הכלים למפתחים באמצעות מקש הקיצור של מערכת ההפעלה:
- Windows: לוחצים על F12
- Linux: מקישים על Ctrl + Shift + I
- ב-macOS: מקישים על Cmd + Option + I
עוברים לכרטיסייה רשת.
מסמנים את התיבה Preserve log כדי לוודא שלא יאבדו נתונים במהלך הפניות אוטומטיות.

עוברים לכתובת ה-URL של סביבת Google SecOps כדי להתחיל את תהליך ההתחברות. תקבלו את כתובת ה-URL הזו באימייל אחרי שתשלימו את הגדרת Google SecOps בשלב 5 של שלב 1 בתהליך המעבר ללקוחות SOAR עצמאיים. נושא האימייל הוא
YourGoogle SecOps instance is ready.
שלב 2: אימות בקשת ההרשאה לספק OIDC
בשלב הזה מאמתים את ההפניה האוטומטית הראשונית מ- Google Cloud לספק OpenID Connect (IdP).
מאתרים את הבקשה: בכרטיסייה Network, מחפשים את ההפניה האוטומטית הראשונית לנקודת הקצה לאימות של ספק ה-OIDC. כתובת ה-URL בדרך כלל מכילה פרמטרים כמו
client_id,redirect_uri,scope,response_typeו-state.
אימות:
- מוודאים שהערך של
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.
מאתרים את הקריאה החוזרת (callback): בכרטיסייה רשת, מאתרים את הבקשה לכתובת ה-URL של הקריאה החוזרת לכניסה: (
.../signin-callback/...).
בדיקת הנתונים: בודקים את הפרמטרים של כתובת ה-URL בבקשה הזו. הוא צריך להכיל פרמטר קוד שסופק על ידי ספק הזהויות של OIDC.
מאחורי הקלעים: איחוד שירותי אימות הזהות של כוח העבודה מחליף את הקוד הזה בטוקנים (טוקן של מזהה, טוקן גישה) מנקודת הקצה של הטוקן של ספק ה-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.
מאתרים את האסימון בדפדפן של המשתמש: בסרגל הסינון של הכרטיסייה רשת, מחפשים את נקודת הקצה
auth/siem.
חילוץ נתונים: בוחרים את הבקשה ומציגים את הכרטיסייה מטען ייעודי (payload). מאתרים את המחרוזת
jwt.פענוח: מעתיקים את מחרוזת ה-JWT ומדביקים אותה בכלי JWT Inspection (jwt.io).

אימות:
- משווים בין ההצהרות המפוענחות של
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. לשם כך, מבצעים את השלבים הבאים:
- מעתיקים את מיפויי הקבוצות מהדף Group Mappings במכונה הקיימת של SOAR.
- מבקשים ממשתמש בקבוצת ה-IdP לגשת לכתובת ה-URL החדשה של Google SecOps.
אם המשתמש לא יכול לגשת ל-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:
בצד של ה-IdP: מוודאים שלקוח ה-OIDC מוגדר לשחרר את ההצהרות הנדרשות (שממופות ב-WIF, כמו
sub,groups,email,given_name,family_name) בטוקן של המזהה.בצד של WIF: ודאו שההצהרות הנכנסות האלה ממופות בצורה נכונה בקטע WIF Attribute Mapping (לדוגמה, google.groups=assertion.groups). אם יש הצהרה בטוקן אבל היא לא ממופה ב-WIF, יכול להיות שפלטפורמת ה-SOAR לא תצליח לאשר את המשתמש. כדי לוודא שמיפוי המאפיינים מניב את התוצאות הצפויות, עיינו בקטע אימות הגדרת הספק.
מיפוי קבוצות אחרי ההעברה
מיפוי הקבוצות נשאר קריטי ב-Google SecOps אחרי שההעברה מסתיימת
אחרי ההעברה, המופע שהועבר שומר על מיפויי הקבוצות. הם משמשים כבסיס לקביעת הגישה של המשתמשים ל-SOAR. כדי שכל משתמש יוכל לגשת ל-Google SecOps, צריך לוודא שהוא ממופה בדף הזה. מידע נוסף זמין במאמר גישה למכונה.
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.