Antigravity-Anwendung und Antigravity CLI für den öffentlichen Sektor in den USA bereitstellen

Sie können die Antigravity-App und die Antigravity-CLI in FedRAMP High-, IL4-, IL5-, ITAR- und CJIS-Datengrenzumgebungen bereitstellen, wenn sie mit der Gemini-Plattform verwendet werden.

Folgen Sie dieser Anleitung, um die Antigravity App und die Antigravity CLI so zu konfigurieren, dass sie die regulatorischen Standards und ähnlichen Richtlinien unterstützen, die für Organisationen des öffentlichen Sektors und Unternehmenskunden in den USA erforderlich sind. Eine Abweichung von den Schritten auf dieser Seite kann zu einer nicht konformen Konfiguration führen.

Eine Third-Party Assessment Organization (3PAO) hat bestätigt, dass diese Bereitstellungsanleitung dafür sorgt, dass die Antigravity App und die Antigravity CLI nur mit einem regionalen Endpunkt einer US-amerikanischen Cloud-Dienst-API kommunizieren können. Der API-Endpunkt aiplatform.us.rep.googleapis.com wird bereits von den Assured Workloads-Datengrenzen für FedRAMP High, IL4, IL5, ITAR und CJIS unterstützt. Weitere Informationen finden Sie unter Coalfire-Bewertung der Antigravity-Anwendung und -Befehlszeile.

Vorbereitung

Antigravity-Anwendung und Antigravity CLI bereitstellen

Führen Sie die folgenden Schritte aus, um die Antigravity-Anwendung und die Antigravity CLI bereitzustellen und Ihre lokale Umgebung und Ihren Client so zu konfigurieren, dass sie den Sicherheitsanforderungen Ihrer Organisation entsprechen:

  1. Laden Sie die Antigravity App und die Antigravity CLI lokal herunter.
  2. Erstellen Sie ein Projekt in Ihrem Assured Workloads-Ordner und aktivieren Sie die aiplatform.googleapis.com API. Eine Anleitung finden Sie im Abschnitt Google Cloud -Projekt und API einrichten.
  3. Konfigurieren Sie die Authentifizierung bei Antigravity entsprechend Ihren Nutzern und Clients. Sie können Cloud Identity (für die Föderation mit Ihrem externen Identitätsanbieter oder -system) und Google Cloud -Dienstkonten verwenden, um sich bei Antigravity zu authentifizieren.

  4. Melden Sie sich mit Standardanmeldedaten für Anwendungen so in Antigravity an:

    • Wenn du den Antigravity-Desktop-Client verwendest:

      1. Wählen Sie ein Projekt im Assured Workloads-Ordner aus.
      2. Wählen Sie den US-Standort aus.

    • Bei Verwendung der Antigravity CLI:

      1. Verwenden Sie die Google Cloud CLI, um Ihr Kontingentprojekt zu konfigurieren:

        gcloud auth application-default set-quota-project QUOTA_PROJECT_ID

        Ersetzen Sie QUOTA_PROJECT_ID durch die ID des Projekts in Ihrem Assured Workloads-Ordner.

      2. Legen Sie die folgenden Umgebungsvariablen fest:

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

Verbindung zu unterstützten Modellen herstellen

Die folgenden Modelle werden für FedRAMP High, IL4, IL5, ITAR und CJIS unterstützt:

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

Wenn Sie eine Verbindung zu einer Version des Modells herstellen möchten, die die Compliance-Anforderungen des US-amerikanischen öffentlichen Sektors erfüllt, wählen Sie US als Basis-Endpunkt-URI aus. Sie müssen US auswählen, damit Prompts und Antworten den spezifischen Anforderungen von Kunden des öffentlichen Sektors in den USA entsprechen. Eine Anleitung finden Sie unter Regionale Endpunkte und Netzwerk-Zulassungslisten.

Optionale APIs deaktivieren

Die Antigravity-App und die Antigravity-CLI rufen andere Backend-APIs auf, von denen nicht alle die Einhaltung der Anforderungen des öffentlichen Sektors in den USA unterstützen. Diese APIs sind für die Hauptfunktionen des Produkts nicht erforderlich. Um die Compliance Ihrer Bereitstellung aufrechtzuerhalten, deaktivieren Sie die Möglichkeit, die folgenden APIs aus Ihrer lokalen Umgebung aufzurufen:

  • Alle nicht US-amerikanischen multiregionalen Endpunkte in aiplatform.*.rep.googleapis.com (außer 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

Wenn Sie diese Endpunkte in Ihrer lokalen Umgebung deaktivieren möchten, wenden Sie die folgenden Einstellungen an:

  • Netzwerk- und Proxyregeln: Blockieren Sie in Ihrem Unternehmens-Webproxy, Ihrer Firewall oder Ihrer DNS-Richtlinie ausgehende Anfragen an die aufgeführten Domains, während Sie Traffic zum aiplatform.us.rep.googleapis.com-Endpunkt zulassen.
  • Organisationsrichtlinie für die Endpunktnutzung: Konfigurieren Sie die Organisationsrichtlinien-Einschränkung constraints/gcp.restrictEndpointUsage auf Ordner- oder Projektebene, um die Wertgruppe in:non-us-aiplatform-endpoints (die globale und nicht US-amerikanische Gemini Enterprise Agent Platform-Endpunkte blockiert) und die Endpunkte businessaicode.googleapis.com, businessaicode.us.rep.googleapis.com und businessaicode.eu.rep.googleapis.com abzulehnen. Die unterstützten multiregionalen Endpunkte für die Agent Platform finden Sie unter Multiregionale Endpunkte. Eine Anleitung zum Konfigurieren dieser Einschränkung und ihrer ausgewählten Wertgruppen finden Sie unter Endpunktnutzung einschränken.
  • Projekt-API-Verwaltung: Deaktivieren Sie die APIs businessaicode.googleapis.com und cloudaicompanion.googleapis.com in Ihrem Assured Workloads-Projekt, falls sie aktiviert sind. Der Endpunkt cloudcode-pa.googleapis.com ist ein interner Google-Client-Endpunkt, den Sie nicht über Service Usage aktivieren oder deaktivieren können und den Sie mithilfe Ihrer Netzwerk- oder Proxyregeln blockieren müssen. Weitere Informationen finden Sie unter Dienste deaktivieren.
  • Automatische CLI-Updates: Legen Sie die Umgebungsvariable AGY_CLI_DISABLE_AUTO_UPDATE=true fest, um zu verhindern, dass die Antigravity CLI beim Start den Endpunkt antigravity-cli-auto-updater-974169037036.us-central1.run.app abfragt.

Unterstützung von SSL/TLS-Prüfung und -Zertifikaten

Die Antigravity-Anwendung und die Befehlszeile fragen automatisch den vertrauenswürdigen Stammspeicher des Hostbetriebssystems ab und verwenden ihn, z. B. /etc/ssl/certs unter Linux, den Windows-Zertifikatsspeicher unter Windows und den Schlüsselbund unter macOS.

Wenn Sie das CA-Zertifikat-Bundle des Unternehmens auf dem Client-Betriebssystem bereitstellen, vertraut Antigravity der geprüften SSL/TLS-Umgebung automatisch und arbeitet darin. Sie benötigen keine benutzerdefinierte CA-Überschreibung.

Wenn Sie Unternehmensproxys verwenden, unterstützt der HTTP-Transport der Go-Sprache die Standard-Proxy-Umgebungsvariablen des Systems. Konfigurieren Sie diese Variablen auf den Maschinen, auf denen Antigravity ausgeführt wird:

  • HTTP_PROXY
  • HTTPS_PROXY
  • NO_PROXY

Weitere Informationen findest du unter Einstellungen.