שימוש ב-VPC Service Controls עם Apigee ו-Apigee Hybrid

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge.

‫Apigee משתלב עם VPC Service Controls, שמאפשר לבודד משאבים של פרויקטים בענן שלכם ב-Google Cloud. כך אפשר למנוע דליפות נתונים או זליגת נתונים.

בקטע הזה מוסבר איך להשתמש ב-VPC Service Controls עם Apigee.

סקירה כללית

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

בנוסף, בעזרת VPC Service Controls אפשר לוודא שלקוחות בתוך גבולות הגזרה שיש להם גישה פרטית למשאבים, לא יכולים לגשת למשאבים לא מורשים מחוץ לגבולות הגזרה.

לסקירה מפורטת של היתרונות של גבולות גזרה לשירות, קראו את הסקירה הכללית על VPC Service Controls.

כשמשתמשים ב-VPC Service Controls, חשוב לשים לב לדברים הבאים:

  • הפרויקט בענן ב-Google Cloud וסביבת זמן הריצה שמשויכת אליו נכללים בגבולות הגזרה של VPC Service Controls של הפרויקט.
  • אפשר להגביל את האינטראקציה בין שירותים בתוך היקף ההרשאות באמצעות התכונה שירותים נגישים ברשת VPC.

גם Apigee וגם Apigee Hybrid משתלבים עם VPC Service Controls. ברשימת המוצרים הנתמכים מפורטים כל המוצרים שמשתלבים עם VPC Service Controls.

ההשפעה על החיבור לאינטרנט

כשהשירות VPC Service Controls מופעל, הגישה לאינטרנט מושבתת: זמן הריצה של Apigee לא יתקשר יותר עם אף יעד באינטרנט הציבורי. כדי לנתב את התנועה ל-VPC, צריך להגדיר מסלולים בהתאמה אישית. ייבוא וייצוא של נתיבים בהתאמה אישית

הגדרת VPC Service Controls עם Apigee

התהליך הכללי להגדרת VPC Service Controls עם Apigee הוא:

  1. מפעילים את VPC Service Controls.
  2. יוצרים גבולות גזרה חדשים לשירות.
  3. מגדירים את גבולות הגזרה לשירות.

השלבים האלה מפורטים בהמשך.

כדי להגדיר את VPC Service Controls עם Apigee:

  1. מפעילים את VPC Service Controls לחיבור בין הרשת שלכם ל-Apigee באמצעות הפקודה הבאה:

    gcloud services vpc-peerings enable-vpc-service-controls \
      --network=SHARED_VPC_NETWORK --project=PROJECT_ID

    כאשר:

    • ‫SHARED_VPC_NETWORK הוא השם של רשת ה-VPC המשותפת.
    • ‫PROJECT_ID הוא שם הפרויקט שמארח את רשת ה-VPC המשותפת, ולא הפרויקט שמשמש ליצירת הארגון ב-Apigee.

    הפקודה הזו מפעילה את VPC Service Controls בפרויקט. אפשר להריץ את הפקודה הזו כמה פעמים כדי להפעיל את VPC Service Controls ביותר מפרויקט אחד.

  2. יוצרים היקף חדש כמו שמתואר במדריך למתחילים של VPC Service Controls. כשיוצרים גבולות גזרה, בוחרים אילו פרויקטים להוסיף בתוך גבולות הגזרה האלה ואילו שירותים לאבטח.

    ב-Apigee וב-Apigee Hybrid, ‏ Google ממליצה לאבטח את כל השירותים כשיוצרים היקף, כולל Apigee API.

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

  3. מגדירים את גבולות הגזרה לשירות, כמו שמוסבר במאמר פרטים והגדרה של גבולות גזרה לשירות.

כדי להוסיף פורטל משולב למתחם, קראו את המאמר הוספת פורטל משולב למתחם.

הגדרת VPC Service Controls עם Apigee Hybrid

ב-Apigee Hybrid יש תמיכה ב-VPC Service Controls, אבל צריך לבצע כמה שלבים נוספים. התהליך הכללי לשילוב של Apigee Hybrid עם VPC Service Controls הוא:

  1. מגדירים קישוריות פרטית.
  2. אבטחת שירותים נוספים בתוך אזור האבטחה.
  3. מגדירים מאגר פרטי. (מאגר פרטי הוא מאגר שנמצא בתוך ההיקף. הוא לא חייב להיות מאגר מקומי, כל עוד הוא נמצא בתוך ההיקף).
  4. מעבירים את קובצי האימג' של Apigee למאגר הפרטי.
  5. מעדכנים את ההגדרות המקומיות כדי להשתמש במאגר הפרטי במהלך תהליך ההתקנה וההגדרה ההיברידית.

כל אחד מהשלבים האלה מתואר בפירוט בתהליך הבא.

כדי להגדיר את VPC Service Controls עם Apigee Hybrid:

  1. מגדירים כתובות IP פרטיות למארחים ברשת ההיברידית, כמו שמתואר במאמר הגדרת קישוריות פרטית לממשקי Google APIs ולשירותים של Google. כדי לעשות את זה, צריך להגדיר מסלולים, כללים של חומת אש ורשומות DNS שיאפשרו ל-Google APIs לגשת לכתובות ה-IP הפרטיות האלה.
  2. פועלים לפי השלבים שמפורטים במאמר הגדרת VPC Service Controls באמצעות Apigee.

    במהלך התהליך הזה, חשוב לוודא שאתם מאבטחים את השירותים הבאים בנוסף לאלה שצוינו ל-Apigee, בתוך גבולות האבטחה:

    • Anthos Service Mesh
    • ‫Cloud Monitoring‏ (Stackdriver)
    • ‫Google Kubernetes Engine (אם אתם מריצים ב-GKE)
    • Google Container Registry (אם משתמשים בו כמאגר מקומי)

    כדי להוסיף את השירותים האלה לגבולות גזרה לשירות, פועלים לפי ההוראות במאמר פרטים והגדרה של גבולות גזרה לשירות.

  3. מעתיקים את קובצי האימג' של Apigee למאגר הפרטי:
    1. מורידים את קובצי האימג' החתומים של Apigee מ-Docker Hub, כמו שמתואר כאן. חשוב לציין את מספרי הגרסאות העדכניים.

      לדוגמה:

      docker pull google/apigee-installer:1.3.3
      docker pull google/apigee-authn-authz:1.3.3
      docker pull google/apigee-mart-server:1.3.3
      docker pull google/apigee-synchronizer:1.3.3
      docker pull google/apigee-runtime:1.3.3
      docker pull google/apigee-hybrid-cassandra-client:1.3.3
      docker pull google/apigee-hybrid-cassandra:1.3.3
      docker pull google/apigee-cassandra-backup-utility:1.3.3
      docker pull google/apigee-udca:1.3.3
      docker pull google/apigee-stackdriver-logging-agent:1.6.8
      docker pull google/apigee-prom-prometheus:v2.9.2
      docker pull google/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker pull google/apigee-connect-agent:1.3.3
      docker pull google/apigee-watcher:1.3.3
      docker pull google/apigee-operators:1.3.3
      docker pull google/apigee-kube-rbac-proxy:v0.4.1
    2. מתייגים את התמונות.

      בדוגמה הבאה מתויגים קובצי האימג' במאגר GCR בארה"ב:

      docker tag google/apigee-installer:1.3.3 us.gcr.io/project_ID/apigee-installer:1.3.3
      docker tag google/apigee-authn-authz:1.3.3 us.gcr.io/project_ID/apigee-authn-authz:1.3.3
      docker tag google/apigee-mart-server:1.3.3 us.gcr.io/project_ID/apigee-mart-server:1.3.3
      docker tag google/apigee-synchronizer:1.3.3 us.gcr.io/project_ID/apigee-synchronizer:1.3.3
      docker tag google/apigee-runtime:1.3.3 us.gcr.io/project_ID/apigee-runtime:1.3.3
      docker tag google/apigee-hybrid-cassandra-client:1.3.3 us.gcr.io/project_ID/apigee-hybrid-cassandra-client:1.3.3
      docker tag google/apigee-hybrid-cassandra:1.3.3 us.gcr.io/project_ID/apigee-hybrid-cassandra:1.3.3
      docker tag google/apigee-cassandra-backup-utility:1.3.3 us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker tag google/apigee-udca:1.3.3 us.gcr.io/project_ID/apigee-udca:1.3.3
      docker tag google/apigee-stackdriver-logging-agent:1.6.8 us.gcr.io/project_ID/apigee-stackdriver-logging-agent:1.6.8
      docker tag google/apigee-prom-prometheus:v2.9.2 us.gcr.io/project_ID/apigee-prom-prometheus:v2.9.2
      docker tag google/apigee-stackdriver-prometheus-sidecar:0.7.5 us.gcr.io/project_ID/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker tag google/apigee-connect-agent:1.3.3 us.gcr.io/project_ID/apigee-connect-agent:1.3.3
      docker tag google/apigee-watcher:1.3.3 us.gcr.io/project_ID/apigee-watcher:1.3.3
      docker tag google/apigee-operators:1.3.3 us.gcr.io/project_ID/apigee-operators:1.3.3
      docker tag google/apigee-kube-rbac-proxy:v0.4.1 us.gcr.io/project_ID/apigee-kube-rbac-proxy:v0.4.1

      ‫Google ממליצה לכלול את מזהה הפרויקט או ערך מזהה אחר בנתיב המאגר של כל קובץ אימג', אבל זה לא חובה.

    3. מעבירים את קובצי האימג' למאגר הפרטי.

      בדוגמה הבאה, התמונות נשלחות למאגר GCR בארה"ב:

      docker push us.gcr.io/project_ID/apigee-installer:1.3.3
      docker push us.gcr.io/project_ID/apigee-authn-authz:1.3.3
      docker push us.gcr.io/project_ID/apigee-mart-server:1.3.3
      docker push us.gcr.io/project_ID/apigee-synchronizer:1.3.3
      docker push us.gcr.io/project_ID/apigee-runtime:1.3.3
      docker push us.gcr.io/project_ID/apigee-hybrid-cassandra-client:1.3.3
      docker push us.gcr.io/project_ID/apigee-hybrid-cassandra:1.3.3
      docker push us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker push us.gcr.io/project_ID/apigee-cassandra-backup-utility:1.3.3
      docker push us.gcr.io/project_ID/apigee-udca:1.3.3
      docker push us.gcr.io/project_ID/apigee-stackdriver-logging-agent:1.6.8
      docker push us.gcr.io/project_ID/apigee-prom-prometheus:v2.9.2
      docker push us.gcr.io/project_ID/apigee-stackdriver-prometheus-sidecar:0.7.5
      docker push us.gcr.io/project_ID/apigee-connect-agent1.3.3
      docker push us.gcr.io/project_ID/apigee-watcher1.3.3
      docker push us.gcr.io/project_ID/apigee-operators1.3.3
      docker push us.gcr.io/project_ID/apigee-kube-rbac-proxy:v0.4.1

      ‫Google ממליצה לכלול את מזהה הפרויקט או ערך מזהה אחר בנתיב המאגר של כל קובץ אימג', אבל זה לא חובה.

  4. מעדכנים את קובץ השינויים כדי להפנות את כתובות ה-URL של התמונות למאגר הפרטי, כמו שמתואר בקטע ציון שינויים בהגדרות.

    צריך לשנות את כתובות ה-URL של התמונות ברכיבים הבאים:

    שם הרכיב (בקובץ ההחרגות) כתובת האתר של התמונה
    ao your_private_repo/apigee-operators
    authz your_private_repo/apigee-authn-authz
    cassandra your_private_repo/apigee-hybrid-cassandra

    auth: your_private_repo/apigee-hybrid-cassandra-client
    backup: your_private_repo/apigee-cassandra-backup-utility
    restore: your_private_repo/apigee-cassandra-backup-utility
    connectAgent your_private_repo/apigee-connect-agent
    installer your_private_repo/apigee-installer
    kubeRBACProxy your_private_repo/apigee-kube-rbac-proxy
    logger your_private_repo/apigee-stackdriver-logging-agent
    mart your_private_repo/apigee-mart-server
    metrics your_private_repo/apigee-prom-prometheus

    sdSidecar: your_private_repo/apigee-stackdriver-prometheus-sidecar
    runtime your_private_repo/apigee-runtime
    synchronizer your_private_repo/apigee-synchronizer
    udca your_private_repo/apigee-udca

    fluentd: your_private_repo/apigee-stackdriver-logging-agent
    watcher your_private_repo/apigee-watcher

  5. מחילים את השינויים באמצעות התמונות החדשות ב-GCR, כפי שמתואר בקטע החלת ההגדרות על האשכול.

פרויקטים של Private Service Connect וגבולות היקפיים

אם אתם משתמשים ב-VPC Service Controls יחד עם Private Service Connect, צריך להיות אפשר להגיע לפרויקט בענן ב-Google Cloud שבקצה הרחוק של החיבור ל-Private Service Connect מאותם גבולות גזרה לשירות כמו של הפרויקט ב-Apigee.

החל מ-15 בינואר 2027, Apigee מעריכה את הפרויקט המקביל כמשאב מוגן נוסף בפעולות שברשימה הבאה. אם פרויקט Apigee נמצא בתוך גבולות הגזרה לשירות והפרויקט המקביל נמצא מחוץ להם, הפעולות האלה מחזירות את השגיאה PERMISSION_DENIED.

הפעולות המושפעות

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

איך בודקים אם הבעיה משפיעה על החשבון שלכם

  1. בודקים אם הפרויקט ב-Apigee שייך לגבולות גזרה לשירות שמגבילים את apigee.googleapis.com. ניהול גבולות גזרה לשירות
  2. מציינים את הפרויקטים של השותפים שבהם אתם משתמשים ב-Private Service Connect:
    • בחיבורים נכנסים, הפרויקטים ברשימת ההיתרים של הצרכן בכל מכונה.
    • בחיבורים יוצאים, הפרויקט שבבעלותו נמצא צירוף השירות שנקרא על שם כל נקודת קצה של הקישור.
  3. לכל פרויקט מקביל, בודקים אם הוא מוגן על ידי אותו היקף כמו הפרויקט ב-Apigee.

אם כל הפרויקטים המקושרים נמצאים באותו היקף, לא צריך לעשות כלום.

פתרון בעיות בפרויקט מקביל מחוץ להיקף

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

  • מוסיפים את הפרויקט המקושר למתחם. כדאי להשתמש באפשרות הזו כששני הפרויקטים שייכים לאותו גבול אמון. ניהול גבולות גזרה לשירות
  • מאשרים את הגישה באמצעות כלל תעבורת נתונים נכנסת או יוצאת. השתמשו באפשרות הזו כשהפרויקטים צריכים להישאר במתחמי אבטחה נפרדים. מידע נוסף זמין במאמר כללים לתעבורת נתונים נכנסת (ingress) ויוצאת (egress).
  • הסרת ההפניה חוצת-ההיקף. מסירים את הפרויקט מרשימת הצרכנים המורשים, או מוחקים את נקודת הקצה של הקישור שמפנה אל מחוץ להיקף.

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

מתן גישה לפורטלים משולבים למתחם האבטחה

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

אם לא תעניקו רמת גישה לפורטלים משולבים, הם לא יהיו זמינים לארגוני Apigee שמופעל בהם VPC-SC.

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

  • לא מכניס פורטלים משולבים לתוך ההיקף.
  • מאפשרת גישה לפורטלים משולבים מחוץ להיקף.
  • מאפשרת לחשוף למשתמשי הפורטל נתוני Apigee שמוגנים על ידי VPC-SC (כמו נתוני אפליקציות) מחוץ להיקף של VPC-SC.

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

דרישות מוקדמות

לפני שנותנים גישה להיקף לפורטל משולב, צריך להפעיל את Access Context Manager API בפרויקט, אם הוא עדיין לא מופעל. אפשר לעשות את זה במסוף Cloud או באמצעות הפקודה gcloud services enable.

כדי לבדוק אם ה-API מופעל, בודקים את הפלט של הפקודה gcloud services list, כמו שמתואר בשלב 2: הפעלת ממשקי ה-API של Apigee.

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

  1. כדי לקבל את פרטי הפרויקט בענן ב-Google Cloud, משתמשים בפקודה gcloud projects list, כמו בדוגמה הבאה:
    gcloud projects list

    הפקודה הזו מחזירה את מזהה הפרויקט (בעמודה PROJECT_ID) ואת מספר הפרויקט (בעמודה PROJECT_NUMBER) לכל פרויקט בארגון ב-GCP.

  2. מזהים את כתובת האימייל של חשבון השירות של Apigee. זה אותו חשבון שנוצר על ידי תוכנת ההתקנה של Apigee כשהקציתם את הארגון בשלב 3: יצירת ארגון.

    כדי לקבל את כתובת האימייל הזו, משתמשים בפקודה iam service-accounts list, שמשתמשת בתחביר הבא:

    gcloud iam service-accounts list --project GCP_PROJECT_ID

    לדוגמה:

    gcloud iam service-accounts list --project my-project
    
    DISPLAY NAME                              EMAIL                                                DISABLED
    Apigee default service account            service-8675309@gcp-sa-apigee.  False
    Compute Engine default service account     8675309-compute@          False

    חשבון השירות שאתם צריכים הוא החשבון שכתובת האימייל שלו תואמת לפורמט הבא:
    service-GCP_PROJECT_NUMBER@gcp-sa-apigee.

    לדוגמה:
    service-8675309@gcp-sa-apigee.

  3. משיגים את מזהה המדיניות (או ההיקף) באמצעות הפקודה access-context-manager policies list. מעבירים את מזהה הארגון לפקודה הזו, כמו בדוגמה הבאה:

    gcloud access-context-manager policies list --organization=organizations/GCP_ORG_ID

    ‫gcloud מחזיר רשימה של כללי מדיניות שמשויכים לארגון שצוין, לדוגמה:

    gcloud access-context-manager policies list --organization=organizations/2244340
    
    NAME          ORGANIZATION      TITLE                 ETAG
    04081981      2244340           Default policy        421924c5a97c0Icu8

    מזהה המדיניות של VPC-SC (נקרא גם מזהה גבולות הגזרה) הוא המזהה של גבולות הגזרה לשירות של VPC-SC, שמשמש כגבול בין הפרויקט שלכם לבין שירותים אחרים. זה הערך בעמודה NAME.

שלבים למתן גישה להיקף לפורטלים משולבים

כדי לתת גישה להיקף לפורטל משולב:

  1. אוספים את כתובת האימייל של חשבון השירות ואת מזהה המדיניות של VPC-SC, כמו שמתואר בקטע Prerequsites.
  2. יוצרים קובץ תנאים במכונה של האדמין, שמציין את כתובת חשבון השירות שתעניק לפורטל גישה דרך גבולות האבטחה.

    אתם יכולים לתת לקובץ כל שם שתרצו, אבל הוא חייב להיות עם הסיומת *.yaml. לדוגמה, my-portal-access-rules.yaml.

  3. בקובץ התנאים, מוסיפים קטע members שמציין את חשבון השירות של Apigee, כמו בדוגמה הבאה:

    - members:
      - serviceAccount:service-8675309@gcp-sa-apigee.

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

  4. יוצרים רמת גישה באמצעות הפקודה access-context-manager levels create, לדוגמה:
    gcloud access-context-manager levels create ACCESS_LEVEL_ID \
      --title ACCESS_LEVEL_TITLE \
      --basic-level-spec PATH/TO/CONDITIONS_FILE.yaml \
      --policy=POLICY_ID

    כאשר:

    • ‫ACCESS_LEVEL_ID הוא מזהה של רמת הגישה החדשה שמוענקת, למשל my-portal-access-level.
    • ‫ACCESS_LEVEL_TITLE הוא שם רמת הגישה. אפשר לתת לכלל כל שם שרוצים, אבל Google ממליצה לתת לו שם בעל משמעות כדי שאתם ואדמינים אחרים תדעו על מה הוא חל. לדוגמה, My Portal Access Level.
    • ‫CONDITIONS_FILE הוא הנתיב לקובץ ה-YAML שיצרתם בשלב הקודם.
    • ‫POLICY_ID הוא המזהה של המדיניות או של היקף ההרשאות.

    לדוגמה:

    gcloud access-context-manager levels create my-portal-access-level \
      --title My Portal Access Level \
      --basic-level-spec ~/my-portal-access-rules.yaml \
      --policy=04081981
  5. מעדכנים את היקף ההרשאות עם רמת הגישה החדשה באמצעות הפקודה access-context-manager perimeters update:
    gcloud access-context-manager perimeters update POLICY_ID \
      --add-access-levels=ACCESS_LEVEL_ID \
      --policy=POLICY_ID

    לדוגמה:

    gcloud access-context-manager perimeters update 04081981 \
      --add-access-levels=my-portal-access-level \
      --policy=04081981

פתרון בעיות

זה מה שכדאי לבדוק:

  • אם Access Context Manager API לא מופעל בפרויקט בענן שלכם ב-Google Cloud, תתבקשו להפעיל אותו על ידי gcloud כשתנסו להציג רשימה של כללי מדיניות או להגדיר אותם.
  • כשאתם מקבלים פרטים על הארגון, חשוב לוודא שאתם משתמשים במזהה הארגון ב-Google Cloud ולא במזהה הארגון ב-Apigee.
  • חלק מהפקודות שמתוארות בקטע הזה דורשות הרשאות מתקדמות. לדוגמה, כדי לקבל פרטים על חשבונות שירות של פרויקט, אתם צריכים להיות הבעלים של הפרויקט.
  • כדי לוודא שחשבון השירות קיים, מריצים את הפקודה iam service-accounts describe, כמו בדוגמה הבאה:

    gcloud iam service-accounts describe service-8675309@gcp-sa-apigee.

    ‫gcloud מחזיר מידע על חשבון השירות, כולל השם המוצג ומזהה הפרויקט שאליו הוא שייך. אם חשבון השירות לא קיים, gcloud יחזיר שגיאת NOT_FOUND.

מגבלות

לשילובים של Apigee עם VPC Service Controls יש את המגבלות הבאות:

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