אימות של סוכן מרוחק באמצעות איחוד שירותי אימות הזהות של עומסי עבודה

נתמך ב:

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

באיחוד שירותי אימות הזהות של עומסי עבודה, סוכנים מרוחקים שפועלים אצל ספקי שירותי ענן חיצוניים, בתשתית מקומית, באשכולות Kubernetes או בצינורות עיבוד נתונים של CI/CD משתמשים בטוקני גישה מאוחדים של Google Cloud לטווח קצר, שנגזרים מספק הזהויות החיצוני שלהם.

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

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

  • גרסה 2.6.2 ומעלה של Remote Agent.
  • למשתמש שמגדיר את איחוד שירותי אימות הזהות של עומסי העבודה צריכות להיות הרשאות IAM הנדרשות ב- Google Cloud כדי ליצור ולנהל מאגרי Workload Identity‏ (roles/iam.workloadIdentityPoolAdmin) וחשבונות שירות (roles/iam.serviceAccountAdmin).
  • חשבון שירות ייעודי שנוצר ב- Google Cloud עם התפקיד Chronicle SOAR Remote Agent‏ (roles/chronicle.soarRemoteAgent). כדי ליצור חשבון שירות, פועלים לפי השלבים שמפורטים במאמר יצירת חשבון שירות.
  • גישה לספק הזהויות החיצוני (AWS, ‏Azure, ‏Active Directory/ADFS, ‏Kubernetes, ‏CI/CD pipeline, ‏X.509 CA או ספק OIDC/SAML בהתאמה אישית).
  • חומת האש צריכה לאפשר תעבורת נתונים יוצאת של HTTPS (יציאת TCP‏ 443) מהמארח של הסוכן המרוחק אל sts.googleapis.com, iamcredentials.googleapis.com ונקודת הקצה של מיקום ה-API של Chronicle (REGION-chronicle.googleapis.com, שהוגדרה ב-ONE_PLATFORM_URL_DOMAIN). לרשימת ההיתרים המלאה ולפרטים על Private Service Connect, ראו דרישות הרשת ו-Private Service Connect ודרישות הרשת וחומת האש.

שלב 1: יצירת ספק ומאגר זהויות של עומסי עבודה

ב- Google Cloud, מאגרי הזהויות של עומסי העבודה מנהלים את הזהויות החיצוניות, וספקי מאגרי הזהויות של עומסי העבודה מגדירים את הפרמטרים של החיבור בין ספק הזהויות החיצוני לבין Google Cloud.

  1. במסוף Google Cloud , נכנסים לדף מאגרי זהויות של עומסי עבודה. כניסה לדף Workload Identity Pools
  2. לוחצים על Create Pool.
  3. מזינים שם ותיאור למאגר (לדוגמה, soar-remote-agent-pool).
  4. לוחצים על Continue.
  5. בקטע Add a provider to pool, בוחרים את סוג הספק ומזינים את פרטי החיבור של הספק (כמו מזהה חשבון AWS או מנפיק וקהל של OIDC) מהמדריך של הספק.
  6. בקטע Configure attribute mappings, ממפים את ההצהרות מהאסימון החיצוני (כמו google.subject=assertion.sub) למאפייני Google Cloud IAM, כמו שמפורט במדריך של הספק.
  7. לוחצים על Save.

שלב 2: נותנים הרשאות התחזות לחשבון השירות

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

  1. נכנסים לדף Service Accounts במסוף Google Cloud .
  2. בוחרים את חשבון השירות של הסוכן המרוחק.
  3. לוחצים על הכרטיסייה Principals with access.
  4. לוחצים על הענקת גישה.
  5. בשדה New principals, מזינים את מזהה החשבון שמתאים למאגר הזהויות של עומסי העבודה:
    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
  6. ברשימה Select a role, בוחרים באפשרות Workload Identity User ‏(roles/iam.workloadIdentityUser).
  7. לוחצים על Save.

שלב 3: מורידים או יוצרים פרטי כניסה לחשבון חיצוני (agent-key.json)

במחשב המארח של הסוכן המרוחק, משיגים קובץ תצורה של פרטי כניסה לחשבון חיצוני בשם agent-key.json באמצעות אחת מהאפשרויות הבאות.

אפשרות א': הורדה ממסוף Google Cloud (מומלץ)

  1. במסוף Google Cloud , נכנסים לדף מאגרי זהויות של עומסי עבודה.
  2. בוחרים את מאגר הזהויות של עומסי העבודה ולוחצים על Grant access.
  3. בחלונית Grant access, בוחרים באפשרות Grant access using service account impersonation.
  4. ברשימה Select service account, בוחרים את חשבון השירות של הסוכן המרוחק.
  5. בקטע Select principals (identities that can access the service account), מציינים אילו זהויות יכולות לגשת לחשבון השירות (למשל, בוחרים שם מאפיין וערך).
  6. לוחצים על Save.
  7. בחלון Configure your application:
    • בוחרים את ספק מאגרי הזהויות של עומסי העבודה.
    • בשדה OIDC ID token path, מזינים את הנתיב המדויק שבו הטוקן החיצוני מאוחסן או נטען (בטוקנים מוקרנים של Kubernetes, הנתיב צריך להתאים ל-mountPath + path שמוגדרים במניפסט של ה-Pod, למשל /var/run/secrets/tokens/gcp-kms-token).
    • מגדירים את Format type (סוג הפורמט) בתור Text (טקסט) (מחרוזת JWT גולמית). אל תבחרו ב-JSON לקובצי טוקנים רגילים.
    • לוחצים על Download config ושומרים את הקובץ בשם agent-key.json (או משנים את השם של הקובץ שהורדתם ל-agent-key.json).
  8. מעבירים את הקובץ agent-key.json למחשב המארח של הסוכן המרוחק.

אפשרות ב': יצירה באמצעות ה-CLI של gcloud

מריצים את הפקודה gcloud iam workload-identity-pools create-cred-config כדי ליצור את קובץ התצורה של פרטי הכניסה:

gcloud iam workload-identity-pools create-cred-config \
    projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \
    --service-account=SERVICE_ACCOUNT_EMAIL \
    --output-file=agent-key.json \
    --credential-source-file=/var/run/secrets/tokens/gcp-kms-token

הפניה לקובץ תצורה לדוגמה

לעיון, קובץ ה-agent-key.json שנוצר מכיל מבנה דומה לזה:

{
  "type": "external_account",
  "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID",
  "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
  "token_url": "https://sts.googleapis.com/v1/token",
  "credential_source": {
    "file": "/var/run/secrets/tokens/gcp-kms-token"
  },
  "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken"
}

שלב 4: מיפוי חשבון השירות ב-Google SecOps

לפני שפורסים את הסוכן המרוחק, צריך לאשר את כתובת האימייל של חשבון השירות ב-Google SecOps:

  1. עוברים אל הגדרות > ניהול גישה > מיפוי קבוצות.
  2. לוחצים על סמל ההוספה הוספה.
  3. בתיבת הדו-שיח Add Role, מזינים את כתובת האימייל המלאה של חשבון השירות בשדה IAM Role / IdP group.
  4. בוחרים את הסביבות המתאימות שהסוכן המרוחק ינהל.
  5. לוחצים על הוספה.

שלב 5: פריסה או עדכון של אימות סוכן מרוחק

Podman

כדי להגדיר אימות של סוכן מרוחק ב-Podman, פועלים לפי השלבים הבאים:

  1. מציגים את הקונטיינרים של Podman שפועלים:
    podman ps
  2. מזינים את מזהה המאגר של הנציג:
    CONTAINER_ID
  3. כדי להעתיק את קובץ התצורה של פרטי הכניסה לנתיב הייעודי בקונטיינר, משתמשים בפקודה הבאה:

    podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. כדי לשנות את הבעלים של קובץ התצורה של פרטי הכניסה בקונטיינר, משתמשים בפקודה הבאה:

    podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. מריצים את הפקודה הבאה כדי להחיל את השינויים:
    podman restart CONTAINER_ID

Docker

כדי להגדיר אימות של סוכן מרוחק ב-Docker, צריך לבצע את השלבים הבאים:

  1. מציגים את הקונטיינרים של Docker שפועלים:
    docker ps
  2. מזינים את מזהה המאגר של הנציג:
    CONTAINER_ID
  3. כדי להעתיק את קובץ התצורה של פרטי הכניסה לנתיב הייעודי בקונטיינר, משתמשים בפקודה הבאה:

    docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. כדי לשנות את הבעלים של קובץ התצורה של פרטי הכניסה בקונטיינר, משתמשים בפקודה הבאה:

    docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. מריצים את הפקודה הבאה כדי להחיל את השינויים:
    docker restart CONTAINER_ID

מתקין

כדי להגדיר אימות של סוכן מרוחק ב-CentOS/RHEL, צריך לבצע את השלבים הבאים:

  1. מעבירים את קובץ התצורה של פרטי הכניסה לנתיב הצפוי:

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. כדי לשנות את הבעלים של קובץ התצורה של פרטי הכניסה, משתמשים בפקודה הבאה:

    chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  3. מריצים את הפקודה הבאה כדי להפעיל מחדש את שירות הסוכן:
    supervisorctl restart siemplify_agent

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