פריסת אפליקציית Antigravity ו-Antigravity CLI למגזר הציבורי בארה"ב

אתם יכולים לפרוס את Antigravity App ואת Antigravity CLI בסביבות של גבולות נתונים מסוג FedRAMP High,‏ IL4,‏ IL5,‏ ITAR ו-CJIS כשאתם משתמשים בהן עם פלטפורמת Gemini.

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

ארגון להערכת צדדים שלישיים (3PAO) אישר שהוראות הפריסה האלה מאפשרות לאפליקציית Antigravity ול-Antigravity CLI לתקשר רק עם נקודת קצה אזורית אחת של API לשירותי ענן בארה"ב. נקודת הקצה ל-API של aiplatform.us.rep.googleapis.com כבר נתמכת בגבולות הנתונים של Assured Workloads ל-FedRAMP High,‏ IL4,‏ IL5,‏ ITAR ו-CJIS. מידע נוסף זמין במאמר הערכת Coalfire של אפליקציית Antigravity ו-CLI.

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

פריסת אפליקציית Antigravity ו-Antigravity CLI

כדי לפרוס את אפליקציית Antigravity ואת Antigravity CLI ולהגדיר את הסביבה המקומית ואת הלקוח בהתאם לציפיות האבטחה של הארגון:

  1. מורידים את אפליקציית Antigravity ואת Antigravity CLI באופן מקומי.
  2. יוצרים פרויקט בתיקיית Assured Workloads ומפעילים את ה-API של aiplatform.googleapis.com. הוראות מפורטות מופיעות בקטע הגדרת הפרויקט ו-Google Cloud API.
  3. מגדירים את האימות ל-Antigravity בהתאם למשתמשים וללקוחות. כדי לבצע אימות ב-Antigravity, אתם יכולים להשתמש ב-Cloud Identity (לאיחוד עם ספק הזהויות או המערכת החיצונית שלכם) וב Google Cloud חשבונות שירות.

  4. נכנסים ל-Antigravity באמצעות Application Default Credentials, באופן הבא:

    • כשמשתמשים בתוכנת Antigravity למחשב:

      1. בוחרים פרויקט בתיקיית Assured Workloads.
      2. בוחרים את המיקום בארה"ב.

    • כשמשתמשים ב-Antigravity CLI:

      1. משתמשים ב-Google Cloud CLI כדי להגדיר את פרויקט המכסות:

        gcloud auth application-default set-quota-project QUOTA_PROJECT_ID

        מחליפים את QUOTA_PROJECT_ID במזהה הפרויקט שבתיקיית Assured Workloads.

      2. מגדירים את משתני הסביבה הבאים:

        export AGY_ADC_AUTH=true
export GOOGLE_CLOUD_LOCATION=us
export AGY_CLI_DISABLE_AUTO_UPDATE=true

חיבור למודלים נתמכים

המודלים הבאים נתמכים ב-FedRAMP High,‏ IL4,‏ IL5,‏ ITAR ו-CJIS:

  • Gemini 3.6 Flash
  • Gemini 3.7 Flash
  • Gemini 3.8 Flash
  • ‫Gemini 4.0 Argon

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

השבתת ממשקי API אופציונליים

אפליקציית Antigravity ו-Antigravity CLI שולחות קריאות לממשקי API אחרים לקצה העורפי, שלא כולם תומכים בדרישות של המגזר הציבורי בארה"ב. ממשקי ה-API האלה לא נחוצים לפונקציונליות העיקרית של המוצר. כדי לשמור על התאימות של הפריסה, צריך להשבית את היכולת להפעיל את ממשקי ה-API הבאים מהסביבה המקומית:

  • כל נקודות הקצה עם מספר אזורים מחוץ לארה"ב ב-aiplatform.*.rep.googleapis.com (חוץ מ-aiplatform.us.rep.googleapis.com)
  • antigravity.google
  • *.antigravity.google
  • antigravity.google.com
  • *.antigravity.google.com
  • antigravity-cli-auto-updater-974169037036.us-central1.run.app
  • antigravity-hub-auto-updater-974169037036.us-central1.run.app
  • antigravity-unleash.goog
  • businessaicode.googleapis.com
  • chromewebstore.google.com
  • cloudcode-pa.googleapis.com
  • aicode.googleapis.com
  • daily-cloudcode-pa.googleapis.com
  • play.googleapis.com

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

  • כללי רשת ושרת proxy: בשרת ה-proxy לאינטרנט, בחומת האש או במדיניות ה-DNS של הארגון, חוסמים בקשות יוצאות לדומיינים שברשימה, אבל עדיין מאפשרים תנועה לנקודת הקצה של aiplatform.us.rep.googleapis.com.
  • מדיניות הארגון לגבי שימוש בנקודות קצה (endpoint): מגדירים את האילוץ constraints/gcp.restrictEndpointUsage של מדיניות הארגון ברמת התיקייה או הפרויקט כדי לדחות את קבוצת הערכים in:non-us-aiplatform-endpoints (שחוסמת את נקודות הקצה הגלובליות ואת נקודות הקצה מחוץ לארה"ב של Gemini Enterprise Agent Platform) ואת נקודות הקצה businessaicode.googleapis.com,‏ businessaicode.us.rep.googleapis.com ו-businessaicode.eu.rep.googleapis.com. ברשימה הזו מפורטות נקודות הקצה במספר אזורים שנתמכות ב-Agent Platform. הוראות להגדרת האילוץ הזה וקבוצות הערכים שנבחרו בשבילו מפורטות במאמר הגבלת השימוש בנקודות קצה.
  • ניהול ממשקי API של פרויקטים: אם ממשקי ה-API של businessaicode.googleapis.com ו-cloudaicompanion.googleapis.com מופעלים בפרויקט Assured Workloads, צריך להשבית אותם. נקודת הקצה cloudcode-pa.googleapis.com היא נקודת קצה פנימית של לקוח Google, שאי אפשר להפעיל או להשבית באמצעות Service Usage, וצריך לחסום אותה באמצעות כללי הרשת או ה-proxy. למידע נוסף, קראו את המאמר השבתת שירותים.
  • עדכונים אוטומטיים של ה-CLI: מגדירים את משתנה הסביבה AGY_CLI_DISABLE_AUTO_UPDATE=true כדי למנוע מ-Antigravity CLI לשלוח שאילתות לנקודת הקצה (endpoint) של antigravity-cli-auto-updater-974169037036.us-central1.run.app בזמן ההפעלה.

תמיכה בבדיקה ובאישורים של SSL/TLS

אפליקציית Antigravity ו-CLI שולחים שאילתות באופן אוטומטי ומשתמשים במאגר הבסיס המהימן של מערכת ההפעלה המארחת, כמו /etc/ssl/certs ב-Linux, מאגר האישורים של Windows ב-Windows ו-Keychain ב-macOS.

אם פורסים את חבילת אישורי ה-CA של הארגון במערכת ההפעלה של הלקוח, Antigravity פועלת באופן אוטומטי בסביבת ה-SSL/TLS שנבדקה ונותנת בה אמון. אתם לא צריכים לשנות את רשות האישורים המותאמת אישית.

אם אתם משתמשים בשרתי proxy ארגוניים, תעבורת הנתונים ב-HTTP משפת Go תומכת במשתני הסביבה הרגילים של שרת ה-proxy במערכת. צריך להגדיר את המשתנים האלה במכונות שמריצות את Antigravity:

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

מידע נוסף זמין בקטע הגדרות.