העברת תשתית האימות של הסוכן המרוחק
במאמר הזה מוסבר איך להעביר את תשתית הסוכנים המרוחקים באמצעות חשבונות שירות ב- Google Cloud . ההעברה הזו מיועדת רק לתשתית האימות. אתם לא צריכים להעביר או להחליף את המכונות או המארחים של הסוכן המרוחק.
לפני שמתחילים
חשוב לוודא שיש לכם את הפריטים הבאים:
- ההרשאות שנדרשות כדי ליצור חשבונות שירות ב- Google Cloud.
- התפקידים שנדרשים כדי ליצור מפתחות של חשבונות שירות.
- הגרסה המינימלית הנדרשת של Remote Agent היא 2.6.2 ואילך.
דרישות לגבי הרשת ו-Private Service Connect
אחרי שמעבירים את תשתית האימות, הסוכן המרוחק מתקשר עם Chronicle API דרך ממשקי Google API רגילים במקום נקודות הקצה (endpoints) הישנות של *.siemplify-soar.com.
רשימת היתרים של נקודות קצה יוצאות
מוודאים שחומת האש מאפשרת תנועת HTTPS יוצאת ביציאת TCP 443 מהמארח של הסוכן המרוחק לנקודות הקצה הבאות:
- מאפשרים תנועת HTTPS יוצאת לנקודת הקצה (endpoint) של מיקום ה-API של Google Security Operations Chronicle (
<var>REGION</var>-chronicle.googleapis.com, שהוגדר ב-ONE_PLATFORM_URL_DOMAIN, כמוasia-southeast1-chronicle.googleapis.com) ולשם המארח של Publisher בדייר (SERVER_API_ROOT). - מאפשרים תעבורת נתונים יוצאת ב-HTTPS לנקודות הקצה לאימות של Google Cloud :
oauth2.googleapis.com(להחלפת אסימונים של חשבון שירות),sts.googleapis.comו-iamcredentials.googleapis.com(לאימות ללא מפתח באמצעות איחוד שירותי אימות הזהות של עומסי עבודה). - מאפשרים תנועת HTTPS יוצאת ל-Container Registry שמשמשים לפריסות של Podman או Docker, כמו
*.pkg.dev(כוללus-docker.pkg.dev) ו-gcr.ioל-Artifact Registry, אוdocker.io.
מידע נוסף זמין במאמר דרישות הרשת וחומת האש.
הגדרת Private Service Connect
אם הסוכן המרוחק מתחבר לממשקי Google API באופן פרטי (לדוגמה, מרשת מקומית, מ-Amazon Web Services (AWS) או מ-Microsoft Azure דרך Cloud Interconnect או Cloud VPN), צריך לבצע את ההגדרות הבאות:
- יוצרים נקודת קצה (endpoint) של Private Service Connect לממשקי Google APIs (באמצעות החבילה
all-apisאוvpc-sc) בענן הפרטי הווירטואלי (VPC). הוראות מפורטות זמינות במאמר הגדרת Private Service Connect לממשקי Google API. - מגדירים DNS פרטי כדי שנקודות הקצה הנדרשות יתאימו לכתובת ה-IP של נקודת הקצה של Private Service Connect. ב- Google Cloud, מגדירים אזור פרטי של Cloud DNS ל-
googleapis.com. מחוץ ל-Google Cloud, צריך להשתמש בהעברת DNS מותנית או באזור פרטי שמתארח (כמו AWS Route 53). - חשוב להשאיר את כל החיבורים הקודמים של SOAR Private Service Connect (קובץ מצורף של שירות ההפקה של
<var>TENANT</var>.siemplify-soar.com) פעילים עד שמסיימים להעביר את כל הסוכנים המרוחקים.
יצירה של חשבון שירות
חשבון שירות הוא סוג מיוחד של חשבון Google, שאפליקציה משתמשת בו כדי לבצע קריאות מורשות ל-API.
כדי ליצור חשבון שירות:
- נכנסים לדף Service Accounts במסוף Google Cloud . לדף Service accounts
- לוחצים על Create Service Account.
- בקטע Service account details:
- מזינים שם לחשבון השירות.
- מזינים תיאור לחשבון השירות.
- לוחצים על יצירה והמשך.
- בקטע Permissions מבצעים את הפעולות הבאות:
- ברשימה Select a role, בוחרים את התפקיד Chronicle SOAR Remote Agent.
- לוחצים על Continue.
- בקטע Grant users access to this service account, לוחצים על Done.
יצירת מפתח של חשבון שירות
המפתח של חשבון השירות נדרש כדי לאמת את הנציג המרוחק. כדי ליצור את המפתח הזה, מבצעים את השלבים הבאים:
- נכנסים לדף Service Accounts במסוף Google Cloud . לדף Service accounts
- לוחצים על השם של חשבון השירות שיצרתם.
- לוחצים על הכרטיסייה Keys.
- לוחצים על Add Key > Create new key.
- בוחרים באפשרות JSON בתור סוג המפתח ולוחצים על Create.
A JSON file containing the key is downloaded to your computer. - לוחצים על Close.
אחסון מאובטח של קובץ המפתח
אחרי שמורידים את המפתח של חשבון השירות, צריך להעביר אותו למכונה המארחת שבה הסוכן המרוחק יפעל.
Podman
- מאתרים במחשב את קובץ ה-JSON שהורדתם.
- מאחסנים את הקובץ במיקום מאובטח במכונה המארחת, שבו לתהליך של הסוכן יש גישה אליו.
-
מזינים את הנתיב המלא של מפתח חשבון השירות של הנציג במכונה המארחת.
AGENT_SERVICE_ACCOUNT_PATH
Docker
- מאתרים במחשב את קובץ ה-JSON שהורדתם.
- מאחסנים את הקובץ במיקום מאובטח במכונה המארחת, שבו לתהליך של הסוכן יש גישה אליו.
-
מזינים את הנתיב המלא של מפתח חשבון השירות של הנציג במכונה המארחת.
AGENT_SERVICE_ACCOUNT_PATH
מתקין
- מאתרים במחשב את קובץ ה-JSON שהורדתם.
- שומרים את הקובץ במיקום הבא:
AGENT_SERVICE_ACCOUNT_PATH
- חשוב לשמור את הנתיב המלא לקובץ הזה, כי תצטרכו אותו כשתגדירו את הסוכן המרוחק.
מיפוי חשבון השירות של הסוכן המרוחק
אחרי שיוצרים את חשבון השירות של הנציג המרוחק, צריך לתת לו הרשאה בפלטפורמה כדי לוודא שהוא יכול לתקשר עם Google SecOps.
כדי לתת לחשבון שירות או לאיחוד שירותי אימות הזהות של עומסי עבודה גישה ל-Google SecOps, צריך למפות את הזהות לפרמטרים של בקרת הגישה של הפלטפורמה. המיפוי הזה הוא שלב חובה כדי לספק לזהות את הגישה הנדרשת לתפקידי SOC ולסביבות שנדרשות לביצוע משימות אוטומטיות או פעולות API.
- עוברים אל הגדרות > ניהול גישה > מיפוי קבוצות.
- לוחצים על סמל ההוספה הוספה.
ממלאים את השדות בתיבת הדו-שיח Add Mapping כדי למפות את הזהות לפרמטרים של בקרת הגישה של הפלטפורמה.
- בשדה IdP / User group, מזינים אחת מהאפשרויות הבאות:
- כתובת האימייל המלאה של חשבון השירות, אם הזהות הוגדרה באמצעות Cloud Identity.
- מחרוזת חשבון המשתמש של Workload Identity, אם הזהות הוגדרה באמצעות איחוד שירותי אימות הזהות של כוח העבודה.
מגדירים את השדות הבאים של בקרת הגישה:
שדה תיאור קבוצות הרשאות בוחרים את קבוצות ההרשאות כדי להגדיר לאילו מודולים ומודולי משנה הזהות יכולה לגשת. תפקידים ב-SOC בוחרים את תפקידי ה-SOC כדי להגדיר את תפקיד הזהות (למשל, רמה 1). סביבות בוחרים את הסביבות או את קבוצות הסביבות שהזהות יכולה לגשת אליהן (למשל, כל הסביבות). חברי הקבוצה אם רלוונטי, מזינים את כתובות האימייל של המשתמשים הנדרשים. אחרי שמוסיפים כל כתובת אימייל, לוחצים על Enter. פעולות מוגבלות כדי להגביל פעולות ספציפיות במודולים, בוחרים את הפעולות המוגבלות.
- בשדה IdP / User group, מזינים אחת מהאפשרויות הבאות:
לוחצים על הוספה.
הגדרת אימות של סוכן מרוחק ל- Google Cloud
Podman
אם אתם פורסים סוכן חדש, קראו את המאמר פריסת סוכן באמצעות Podman.
אם אתם משדרגים סוכן, קראו את המאמר שדרוג סוכן באמצעות Podman.
Docker
אם אתם פורסים סוכן חדש, קראו את המאמר פריסת סוכן באמצעות Docker.
אם אתם משדרגים סוכן, קראו את המאמר שדרוג סוכן באמצעות Docker.
מתקין
אם אתם פורסים סוכן חדש, קראו את המאמר פריסת סוכן עם CentOS או את המאמר פריסת סוכן עם RHEL.
אם אתם משדרגים סוכן, קראו את המאמר שדרוג סוכן עם CentOS או את המאמר שדרוג סוכן עם RHEL .
העברת משתני סביבה של נציג קיים
עוברים אל SOAR Settings > Advanced > Remote Agents ולוחצים על View More בסוכן המרוחק הרצוי.
מעתיקים את הערכים הבאים מהשדה Docker Command ומדביקים אותם בפקודות הבאות.
תצטרכו להשתמש בהם בתהליך ההעברה:
-
ONE PLATFORM URL DOMAIN.ONE_PLATFORM_URL_DOMAIN
-
ONE PLATFORM URL PROJECT.ONE_PLATFORM_URL_PROJECT
-
ONE PLATFORM URL LOCATION.ONE_PLATFORM_URL_LOCATION
-
ONE PLATFORM URL INSTANCE.ONE_PLATFORM_URL_INSTANCE
Podman
כדי להעביר את משתני הסביבה של הנציג המרוחק, פועלים לפי השלבים הבאים:
-
הצגת רשימה של קונטיינרים פעילים ב-Podman.
podman ps -
מזינים את מזהה המאגר של הנציג:
CONTAINER_ID
-
מדביקים את משתני הסביבה הבאים מההליכים הקודמים ומריצים את הפקודה הזו:
podman exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'
Docker
כדי להעביר את משתני הסביבה של הנציג המרוחק, פועלים לפי השלבים הבאים:
-
מציגים את הקונטיינרים של Docker שפועלים.
docker ps -
מזינים את מזהה המאגר של הנציג:
CONTAINER_ID
-
מדביקים את משתני הסביבה הבאים מההליכים הקודמים ומריצים את הפקודה הזו:
docker exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'
מתקין
כדי להעביר את משתני הסביבה של הנציג המרוחק, פועלים לפי השלבים הבאים:
מדביקים את משתני הסביבה הבאים מההליכים הקודמים ומריצים את הפקודה הזו:
cat << EOF >> /home/siemplify_agent/.bash_profile export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN export ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT export ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION export ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE export GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json EOF
העברת חשבון השירות אל הסוכן המרוחק
אחרי שהשלב הזה מסתיים וכל משתני הסביבה נמצאים בנציג המרוחק, ההעברה מסתיימת והנציג המרוחק מתקשר דרך Google Cloud.
Podman
כדי להעביר את תשתית האימות של הנציג המרוחק, פועלים לפי השלבים הבאים:
-
הצגת רשימה של קונטיינרים פעילים ב-Podman.
podman ps -
מזינים את מזהה המאגר של הנציג:
CONTAINER_ID
-
משתמשים בפקודה הבאה כדי להעתיק את המפתח של חשבון השירות לנתיב ייעודי בקונטיינר.
podman cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
כדי לשנות את הבעלים של המפתח של חשבון השירות בקונטיינר, משתמשים בפקודה הבאה:
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
מריצים את הפקודה הבאה כדי להחיל את השינויים:
podman restart CONTAINER_ID
Docker
כדי להעביר את תשתית האימות של הנציג המרוחק, פועלים לפי השלבים הבאים:
-
מציגים את הקונטיינרים של Docker שפועלים.
docker ps -
מזינים את מזהה המאגר של הנציג:
CONTAINER_ID
-
משתמשים בפקודה הבאה כדי להעתיק את המפתח של חשבון השירות לנתיב ייעודי בקונטיינר.
docker cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
כדי לשנות את הבעלים של המפתח של חשבון השירות בקונטיינר, משתמשים בפקודה הבאה:
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
מריצים את הפקודה הבאה כדי להחיל את השינויים:
docker restart CONTAINER_ID
מתקין
כדי להעביר את תשתית האימות של הנציג המרוחק, פועלים לפי השלבים הבאים:
-
מעבירים את חשבון השירות לנתיב הצפוי
mv AGENT_SERVICE_ACCOUNT_PATH /opt/SiemplifyAgent/agent-key.json
-
כדי לשנות את הבעלים של המפתח של חשבון השירות בקונטיינר, משתמשים בפקודה הבאה:
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
מריצים את הפקודה הבאה כדי להפעיל מחדש את שירות הסוכן:
supervisorctl restart siemplify_agent
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.