Esegui il deployment dell'app Antigravity e della CLI Antigravity per il settore pubblico degli Stati Uniti

Puoi eseguire il deployment dell'app Antigravity e della CLI Antigravity in ambienti con confini dei dati FedRAMP High, IL4, IL5, ITAR e CJIS se utilizzati con la piattaforma Gemini.

Utilizza queste istruzioni per configurare l'app Antigravity e l'interfaccia a riga di comando Antigravity in modo da supportare gli standard normativi e linee guida simili richieste per le organizzazioni del settore pubblico e i clienti aziendali degli Stati Uniti. La deviazione dai passaggi descritti in questa pagina può portare a una configurazione non conforme.

Un'organizzazione di valutazione di terze parti (3PAO) ha convalidato che queste istruzioni di deployment consentono all'app Antigravity e ad Antigravity CLI di comunicare solo con un endpoint regionale dell'API del servizio cloud con sede negli Stati Uniti. L'endpoint API aiplatform.us.rep.googleapis.com è già supportato dai confini dei dati di Assured Workloads per FedRAMP High, IL4, IL5, ITAR e CJIS. Per saperne di più, consulta Coalfire's Evaluation of Antigravity App and CLI.

Nota: non puoi utilizzare l'integrazione aziendale di Antigravity in Gemini Enterprise per supportare la conformità del settore pubblico degli Stati Uniti.

Prerequisiti

• Crea una cartella Assured Workloads per il tuo framework di conformità.

Esegui il deployment dell'app Antigravity e di Antigravity CLI

Completa i seguenti passaggi per eseguire il deployment di Antigravity App e Antigravity CLI e configurare l'ambiente locale e il client in modo che soddisfino le aspettative di sicurezza della tua organizzazione:

1. Scarica l'app Antigravity e Antigravity CLI localmente.
2. Crea un progetto nella cartella Assured Workloads e abilita l'API aiplatform.googleapis.com. Per istruzioni, consulta la sezione Configurazione del progetto e dell'APIGoogle Cloud .
3. Configura l'autenticazione ad Antigravity in base alle esigenze dei tuoi utenti e client. Puoi utilizzare Cloud Identity (per la federazione con il tuo provider o sistema di identità esterno) e gli account di servizio Google Cloud per autenticarti ad Antigravity.

4. Accedi ad Antigravity utilizzando le Credenziali predefinite dell'applicazione, come segue:

   • Quando utilizzi il client desktop Antigravity:

     1. Seleziona un progetto all'interno della cartella Assured Workloads.
     2. Scegli la località negli Stati Uniti.

   • Quando utilizzi Antigravity CLI:

     1. Utilizza Google Cloud CLI per configurare il progetto di quota:

        gcloud auth application-default set-quota-project QUOTA_PROJECT_ID
        

        Sostituisci QUOTA_PROJECT_ID con l'ID del progetto nella cartella Assured Workloads.

     2. Imposta le seguenti variabili di ambiente:

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

Connettiti ai modelli supportati

I seguenti modelli sono supportati per FedRAMP High, IL4, IL5, ITAR e CJIS:

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

Per connetterti a una versione del modello che supporta i requisiti di conformità del settore pubblico degli Stati Uniti, seleziona Stati Uniti come URI dell'endpoint di base. Devi selezionare Stati Uniti per assicurarti che i prompt e le risposte siano conformi ai requisiti specifici dei clienti del settore pubblico degli Stati Uniti. Per istruzioni, consulta Endpoint regionali e liste consentite di rete.

Disabilita le API facoltative

L'app Antigravity e l'interfaccia a riga di comando Antigravity chiamano altre API di backend, non tutte supportano la conformità ai requisiti del settore pubblico degli Stati Uniti. Queste API non sono necessarie per la funzionalità di base del prodotto. Per mantenere la conformità del deployment, disabilita la possibilità di richiamare le seguenti API dal tuo ambiente locale:

• Tutti gli endpoint multiregionali non statunitensi in aiplatform.*.rep.googleapis.com (ad eccezione di 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

Per disattivare questi endpoint nel tuo ambiente locale, applica i seguenti controlli:

• Regole di rete e proxy: nel proxy web, nel firewall o nella policy DNS aziendale, blocca le richieste in uscita verso i domini elencati, consentendo al contempo il traffico verso l'endpoint aiplatform.us.rep.googleapis.com.
• Policy dell'organizzazione per l'utilizzo degli endpoint: configura il vincolo della policy dell'organizzazione constraints/gcp.restrictEndpointUsage a livello di cartella o progetto per negare il gruppo di valori in:non-us-aiplatform-endpoints (che blocca gli endpoint globali e non statunitensi di Gemini Enterprise Agent Platform) e gli endpoint businessaicode.googleapis.com, businessaicode.us.rep.googleapis.com e businessaicode.eu.rep.googleapis.com. Per trovare gli endpoint multiregionali supportati per Agent Platform, consulta Endpoint multiregionali. Per istruzioni su come configurare questo vincolo e i relativi gruppi di valori selezionati, consulta Limita l'utilizzo degli endpoint.
• Gestione delle API del progetto: disabilita le API businessaicode.googleapis.com e cloudaicompanion.googleapis.com nel tuo progetto Assured Workloads, se sono abilitate. L'endpoint cloudcode-pa.googleapis.com è un endpoint client Google interno che non puoi attivare o disattivare tramite Service Usage e che devi bloccare utilizzando le regole di rete o del proxy. Per saperne di più, consulta Disattiva i servizi.
• Aggiornamenti automatici della CLI: imposta la variabile di ambiente AGY_CLI_DISABLE_AUTO_UPDATE=true per impedire alla CLI Antigravity di eseguire query sull'endpoint antigravity-cli-auto-updater-974169037036.us-central1.run.app all'avvio.

Supporto dell'ispezione e dei certificati SSL/TLS

L'app e l'interfaccia a riga di comando di Antigravity eseguono automaticamente query e utilizzano l'archivio radice attendibile del sistema operativo host, ad esempio /etc/ssl/certs su Linux, l'archivio certificati di Windows su Windows e il portachiavi su macOS.

Se esegui il deployment del bundle di certificati CA aziendali nel sistema operativo client, Antigravity considera automaticamente attendibile l'ambiente SSL/TLS ispezionato e opera al suo interno. Non è necessario un override della CA personalizzata.

Se utilizzi proxy aziendali, il trasporto HTTP dal linguaggio Go supporta le variabili di ambiente proxy standard del sistema. Configura queste variabili sulle macchine che eseguono Antigravity:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Per ulteriori informazioni, vedi Impostazioni.