הגדרת VPC Service Controls ו-Private Service Connect עם ארגזי חול

שליטה בתעבורת הנתונים הנכנסת הפרטית ובתעבורת הנתונים היוצאת לאינטרנט של ארגז חול (Sandbox) של Agent Platform באמצעות Private Service Connect ‏(PSC-E / PSC-I). אמצעי הבקרה האלה מאפשרים לארגז החול לעמוד בדרישות של VPC Service Controls בתוך היקף או מחוץ להיקף.

סקירה כללית

בעזרת VPC Service Controls אתם יכולים להגדיר גבולות גזרה לשירות שמבודדים את המשאבים של Google Cloud כדי לצמצם את הסיכון לזליגת נתונים. ארגז החול של Gemini Enterprise Agent Platform נותן לסוכנים סביבת מחשוב מאובטחת ומבודדת שבה הם יכולים להריץ קוד לא מהימן, להפעיל דפדפן אינטרנט (שימוש במחשב) או להריץ קובץ אימג' של קונטיינר בהתאמה אישית. ארגז החול חושף מישור נתונים אינטראקטיבי ומבצע שיחות יוצאות, ולכן הוא נשלט על ידי שני אמצעי בקרה של Private Service Connect: תעבורת נתונים נכנסת פרטית (PSC-E) ובקרת תעבורת נתונים יוצאת (PSC-I).

כשמריצים את ארגז החול בתוך היקף, הפריטים הבאים נשארים מוגנים בתוך הגבולות:

  • נתונים שהנציג קורא או כותב במהלך סשן בארגז חול (קבצים בדיסק של ארגז החול, מצב בזיכרון).
  • תמונות מצב של ארגז החול שמתעדות את מצב הדיסק והזיכרון, ונשמרות באופן אוטומטי בקטגוריה של Cloud Storage.
  • בקשות ותגובות שמוחלפות עם מישור הנתונים של ארגז החול (לדוגמה, פקודות לשימוש במחשב וצילומי מסך).
  • קובצי אימג' של קונטיינרים בהתאמה אישית שנשלפו מ-Artifact Registry.
  • קריאות שארגז החול שולח ל-Google APIs (לדוגמה, Cloud Storage או Agent Platform).

אתם יכולים גם להגדיר אמצעי בקרה על תעבורת נתונים נכנסת ויוצאת בלי היקף של VPC Service Controls, כי PSC-E (תעבורת נתונים נכנסת פרטית) ו-PSC-I (תעבורת נתונים יוצאת) הם אלה שהופכים את ארגז החול לתואם ל-VPC Service Controls. כדי להגדיר תעבורת נתונים נכנסת ויוצאת בלי היקף של VPC Service Controls, דלגו לקטע שליטה בתעבורת הנתונים היוצאת של ארגז החול באמצעות ממשק Private Service Connect ‏(PSC-I).

מגבלות ושיקולים

חשוב לזכור את המגבלות ואת גבולות האבטחה הבאים כשמגדירים את VPC Service Controls ואת Private Service Connect לארגזי חול:

  • אין רשימת היתרים מובנית של דומיינים בארגז החול: לארגזי חול ולמשאבים של SandboxEnvironmentTemplate אין שדה מובנה של רשימת היתרים של דומיינים. הפעלת internet_access: True ב-egress_control_config בלי network_attachment מעניקה גישה בלתי מוגבלת לכתובות IP ציבוריות (0.0.0.0/0, לא כולל טווחי RFC 1918 פרטיים וטווח המטא-נתונים 169.254.0.0/16). כדי להגביל את החיבורים היוצאים לפי שם דומיין (FQDN), כתובת URL או כתובת IP, צריך לגשר על תנועת הנתונים היוצאת של ארגז החול ל-VPC באמצעות ממשק Private Service Connect (network_attachment) ולאכוף סינון ב-VPC באמצעות Cloud Next Generation Firewall (Cloud NGFW) או Secure Web Proxy (Secure Web Proxy).
  • פרויקט צרכן יחיד לתעבורת נתונים נכנסת פרטית: אפשר להפעיל תעבורת נתונים נכנסת פרטית (PSC-E) לכל היותר לפרויקט צרכן אחד, שחייב להיות אותו פרויקט משתמש שבו פועלת סביבת ה-Sandbox.
  • תרגום שם (name resolution) של DNS ומניעת מנהור: כשמגשרים את תעבורת הנתונים היוצאת ל-VPC, יש תמיכה רק בתרגום שם (name resolution) פרטי באמצעות קישור בין רשתות שכנות (peering) ב-Cloud DNS‏ (dns_peering_configs). העברת DNS ציבורית מושבתת כדי למנוע זליגת נתונים באמצעות מנהור DNS.
  • יומני ביקורת של Cloud ובדיקת איומים ברשת: יומני הביקורת של Cloud מתעדים קריאות למחזור החיים של מישור הבקרה וקריאות RPC להפעלה של מישור הנתונים (ExecuteSandboxEnvironment,‏ BidiExecuteSandboxEnvironment ו-AuthorizeSandboxEnvironmentAccess), אבל רישום ביומן של המטען הייעודי (payload) של הבקשה והתגובה לא זמין למשאבים שמוגנים על ידי VPC Service Controls. תהליכי צאצא נפרדים ושקעי רשת בתוך הקונטיינר לא מתועדים ביומני הביקורת של Cloud. כדי לבדוק חיבורים יוצאים ולזהות איומים ברשת, צריך להפעיל את VPC Flow Logs, רישום ביומן של כללי Cloud NGFW, רישום ביומן של שאילתות Cloud DNS ויומני Secure Web Proxy ב-VPC.
  • זהות מבודדת בארגז החול: הקוד בתוך ארגז החול פועל בזהות של דייר (tenant) ללא הרשאות וללא תפקידים בניהול הזהויות והרשאות הגישה (IAM) בפרויקט. הוא לא יורש את זהות הנציג או את חשבון השירות של הנציג הראשי, ולא יכול לשלוח שאילתות לשרת המטא-נתונים של Compute Engine‏ (169.254.169.254:80) כדי לקבל פרטי כניסה. לפרטים נוספים, ראו זהות הביצוע וגבולות פרטי הכניסה.
  • רמות גישה למתחם: הגישה למתחם באמצעות קוד או דרך המסוף נדחית, אלא אם הגורם שמנסה לגשת עומד ברמת הגישה שמוגדרת למתחם.

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

לפני שמגדירים את VPC Service Controls או את Private Service Connect לארגזי החול, צריך לבצע את הפעולות הבאות:

  • יוצרים או מזהים את גבולות הגזרה לשירות של VPC Service Controls שמכילים את הפרויקט. כדי שארגזי החול יהיו מאובטחים על ידי גבולות הגזרה של VPC Service Controls, הפרויקט ב- Google Cloud צריך להיות בגבולות הגזרה לפני שיוצרים את ארגזי החול.
  • מפעילים את Agent Platform API (aiplatform.googleapis.com) בפרויקט.
  • רשת VPC באזור שבו אתם מפעילים את ארגזי החול.
  • מוודאים שיש לכם את התפקידים הנדרשים:
    • התפקיד אדמין של Access Context Manager בסביבה המאובטחת
    • אדמין רשת של Compute‏ (roles/compute.networkAdmin) בפרויקט שבבעלותו נמצא מחבר הרשת.

הוספת Agent Platform לגבולות הגזרה לשירות

מוסיפים את Agent Platform API לרשימת השירותים המוגבלים בהיקף של VPC Service Controls. כך פלטפורמת הסוכנים (כולל מישור הבקרה של ארגז החול) מוגנת, והגישה הציבורית לאינטרנט נחסמת ל-API, אלא אם המתקשר נמצא ברמת גישה.

  1. פותחים את VPC Service Controls במסוף Google Cloud ועורכים את ההיקף.
  2. בקטע Restricted services, מוסיפים את Agent Platform API (aiplatform.googleapis.com).
  3. חשוב לוודא שהתלויות שבהן משתמשת סביבת ה-Sandbox נמצאות באותו היקף, בדרך כלל Cloud Storage (storage.googleapis.com) ו-Artifact Registry (artifactregistry.googleapis.com, לקובצי אימג' של קונטיינרים בהתאמה אישית). האחסון של תמונות המצב מטופל באופן אוטומטי.
  4. כדי לשחזר את הגישה למשתמשים מהימנים מחוץ להיקף (לדוגמה, הרשת הארגונית), צריך לצרף רמת גישה להיקף.

אופציונלי: הגדרת גישה פרטית ל-Google APIs

בתוך גבולות הגזרה של VPC Service Controls, ארגז החול מגיע לממשקי Google API באופן פרטי דרך כתובת ה-IP הווירטואלית (VIP) המוגבלת. מה-VPC ומהרשתות המקומיות שלכם, השתמשו גם ב-VIP המוגבל כדי שהבקשות לא יעברו אף פעם באינטרנט הציבורי:

  • מנתבים את *.googleapis.com ל-VIP המוגבל 199.36.153.4/30 ומפעילים את הגישה הפרטית ל-Google ברשתות המשנה שקוראות לממשקי Google API.
  • יוצרים אזורים פרטיים ב-Cloud DNS בשביל googleapis.com (ואם אתם שולפים קובצי אימג', בשביל pkg.dev או gcr.io) שמפנים ל-VIP המוגבל.

שליטה בתעבורת הנתונים היוצאת (egress) של ארגז החול באמצעות ממשק Private Service Connect ‏(PSC-I)

בארגזי חול אין הגדרה מובנית של רשימת היתרים לדומיינים. לכן, אם אתם צריכים להוסיף לרשימת ההיתרים דומיינים יוצאים (FQDN), לסנן כתובות URL או לאפשר לארגז החול להגיע לשירותים פרטיים, השתמשו בממשק Private Service Connect ‏ (PSC-I). ‫PSC-I מגשר על כל תעבורת הנתונים היוצאת של ארגז החול ל-VPC, כדי שתוכלו לנהל את תעבורת הנתונים הזו ולתעד אותה ביומן באמצעות אמצעי הבקרה של אבטחת ה-VPC שלכם, בין אם הפרויקט נמצא בתוך מתחם אבטחה היקפית של VPC Service Controls ובין אם לא.

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

יצירת חיבור הרשת

יוצרים את מחבר הרשת לארגז החול:

# A dedicated subnet for the PSC interface (minimum /28)
gcloud compute networks subnets create sandbox-psc-subnet \
    --network=YOUR_VPC \
    --range=10.0.0.0/28 \
    --region=REGION

# The network attachment the sandbox connects into
gcloud compute networks network-attachments create sandbox-egress-na \
    --region=REGION \
    --connection-preference=ACCEPT_AUTOMATIC \
    --subnets=sandbox-psc-subnet

הפניה לקובץ המצורף מתבנית ארגז החול

מגדירים את שדות תעבורת הנתונים היוצאת ב-SandboxEnvironmentTemplate כדי שארגז החול ינתב את תעבורת הנתונים היוצאת דרך ה-VPC:

from vertexai import Client

client = Client(project="PROJECT_ID", location="REGION",
                http_options={"api_version": "v1beta1"})

templates = client.agent_engines.sandboxes.templates
op = templates.create(
    name=agent_instance_name,
    display_name="cu-vpcsc-template",
    config={
        "custom_container_environment": {
            "custom_container_spec": {"image_uri": "IMAGE_URI"},
            "ports": [{"port": 8080, "protocol": "TCP"}],
        },
        "egress_control_config": {
            "internet_access": True, # Enables outbound access from the sandbox. With VPC-SC, that traffic is bridged into your VPC.
            "customer_vpc_network":
                "projects/PROJECT_ID/global/networks/YOUR_VPC", # The VPC network in your project that egress is bridged into. Checked by VPC-SC at creation time.
            "network_attachment":
                "projects/PROJECT_ID/regions/REGION/networkAttachments/sandbox-egress-na", # The network attachment that accepts the sandbox's PSC interface.
        },
    },
)

ממשק ה-PSC יוצר את הנתיב הפרטי ל-VPC, והפלטפורמה מנתבת אליו באופן אוטומטי את תעבורת הנתונים היוצאת של ארגז החול כשמפעילים את internet_access.

כדי להגדיר ולנהל את הנתיב מחוץ ל-VPC, צריך להחליט אם אתם צריכים תעבורת נתונים יוצאת לאינטרנט או תעבורת נתונים יוצאת פרטית בלבד:

  • תעבורת נתונים לאינטרנט: כדי להעביר נתונים לאינטרנט, צריך להשתמש ב-Cloud NAT ובבקרת יעדים באמצעות כללים של Cloud Next Generation Firewall‏ (Cloud NGFW) או של Secure Web Proxy.
  • תעבורת נתונים יוצאת פרטית בלבד (גישה לשירותים ב-VPC או באתר המקומי, ללא אינטרנט): לא נדרש Cloud NAT. אתם צריכים רק נתיבים, כלל של חומת אש וקישור בין רשתות שכנות (peering) ב-DNS.

הגדרה של תעבורת נתונים לאינטרנט וניהול יעדים

ארגז החול נכנס ל-VPC שלכם בכתובת פנימית (RFC 1918), ולכן הוא צריך את Cloud NAT כדי להגיע לאינטרנט. אם היעדים שלכם מאפשרים רשימת היתרים לפי כתובת IP של מקור, אתם יכולים לשמור כתובת IP סטטית לתעבורת נתונים יוצאת.

# Reserve a static egress IP (optional, for destination-side allow-listing)
gcloud compute addresses create sandbox-egress-ip --region=REGION

# Cloud Router + NAT for the region, scoped to the PSC subnet
gcloud compute routers create sandbox-egress-router \
    --network=YOUR_VPC --region=REGION

gcloud compute routers nats create sandbox-egress-nat \
    --router=sandbox-egress-router --region=REGION \
    --nat-external-ip-pool=sandbox-egress-ip \
    --nat-custom-subnet-ip-ranges=sandbox-psc-subnet

כדי להגביל את היעדים שארגז החול יכול להגיע אליהם כשהתנועה שלו עוברת ב-VPC, צריך לבחור את רמת השליטה הרצויה:

  • ‫Cloud NGFW (ברמת הרשת): מדיניות חומת אש בין רשתות גלובליות עם כללי הרשאה (יש תמיכה באובייקטים של FQDN) ודחייה כברירת מחדל לכל השאר:

    gcloud compute network-firewall-policies create sandbox-egress-policy --global
    
    # Allow only the destinations your agent needs (by FQDN)
    gcloud compute network-firewall-policies rules create 1000 \
        --firewall-policy=sandbox-egress-policy --global-firewall-policy \
        --direction=EGRESS --action=allow --layer4-configs=tcp:443 \
        --dest-fqdns=api.partner.example.com
    
    # Default-deny the rest of egress
    gcloud compute network-firewall-policies rules create 65000 \
        --firewall-policy=sandbox-egress-policy --global-firewall-policy \
        --direction=EGRESS --action=deny --layer4-configs=all \
        --dest-ip-ranges=0.0.0.0/0
    
    gcloud compute network-firewall-policies associations create \
        --firewall-policy=sandbox-egress-policy --global-firewall-policy \
        --network=YOUR_VPC
    
  • ‫Secure Web Proxy (אפליקציה/L7): פורסים את Secure Web Proxy כנקודת הבדיקה של תעבורת הנתונים היוצאת ב-VPC, למדיניות מבוססת-TLS לכל כתובת URL, ומנתבים דרכה את תעבורת הנתונים היוצאת של רשת המשנה של ה-PSC.

הגדרה של תעבורת נתונים יוצאת פרטית בלבד

אם ארגז החול צריך רק שירותים פרטיים ב-VPC או באופן מקומי, צריך לוודא שיש ל-VPC נתיב ליעד, לאפשר אותו באמצעות כלל חומת אש לתעבורת נתונים יוצאת (egress) מרשת המשנה של ה-PSC (10.0.0.0/28), ולפתור את שם השירות באמצעות קישור בין רשתות שכנות (peering) ב-DNS.

הגדרת קישור בין רשתות שכנות (peering) ב-DNS

נותנים לארגז החול תרגום שם (name resolution) דרך ה-VPC במקום פותרים ציבוריים (זה גם חוסם זליגת מידע דרך מנהרת DNS). יוצרים אזור פרטי ב-Cloud DNS ב-VPC עם הרשומות שארגז החול צריך, ואז מגדירים קישור בין רשתות שכנות (peering) ב-DNS כדי שארגז החול יתאים שמות מהאזור הזה.

מתן גישה לסוכן השירות (VPC משותף)

אם מחבר הרשת נמצא בפרויקט נפרד (פרויקט א') מהפרויקט שבו פועלת סביבת ה-Sandbox (פרויקט ב'), צריך להקצות לסוכן השירות של Agent Platform בפרויקט ב' את התפקיד "משתמש ברשת Compute" בפרויקט א':

# Agent Platform service agent of the project that runs the sandbox
service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com

# On the project that owns the network attachment
gcloud projects add-iam-policy-binding NETWORK_PROJECT_ID \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com" \
    --role="roles/compute.networkUser"

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

  • ‫PROJECT_NUMBER: מספר הפרויקט שבו פועל ארגז החול.
  • ‫NETWORK_PROJECT_ID: מזהה הפרויקט שבבעלותו נמצא חיבור הרשת.

הפעלת תעבורת נתונים נכנסת פרטית באמצעות Private Service Connect ‏(PSC-E)

עומסי עבודה אינטראקטיביים חושפים מישור נתונים שהלקוח צריך להתחבר אליו. אפשר לגשת למישור הנתונים הזה דרך נקודת קצה פרטית של Private Service Connect ‏(PSC-E) ב-VPC, במקום דרך האינטרנט הציבורי.

הצהרה על פרויקט הצרכן המורשה

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

מתחברים לארגז החול מ-VPC באותו פרויקט:

config = {
    # ...custom_container_environment, egress_control_config...
    "ingress_control_config": {
        "private_service_connect_config": {
            # Must be the same project the sandbox runs in.
            "enable_private_service_connect": True,
        }
    },
}

יצירת נקודת קצה של PSC ב-VPC

אחרי שיוצרים את ארגז החול, קוראים את צירוף השירות מפרטי החיבור שלו:

# The sandbox returns a service attachment to connect to
service_attachment = sandbox.connection_info.service_attachment

אחר כך, שומרים כתובת IP פנימית ויוצרים כלל העברה (נקודת קצה של PSC) ב-VPC שמטרגט את צירוף השירות:

# Reserve an internal IP and create the PSC endpoint
gcloud compute addresses create sandbox-ingress-ip \
    --region=REGION --subnet=YOUR_SUBNET

gcloud compute forwarding-rules create sandbox-ingress-ep \
    --region=REGION \
    --network=YOUR_VPC \
    --address=sandbox-ingress-ip \
    --target-service-attachment=SERVICE_ATTACHMENT_URI

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

המאמרים הבאים

כדי להמשיך להגדיר ולאבטח את ארגזי החול, אתם יכולים להיעזר במקורות המידע הבאים: