Implantar o app Antigravity e a CLI do Antigravity para o setor público dos EUA

É possível implantar o app e a CLI do Antigravity em ambientes de limite de dados FedRAMP High, IL4, IL5, ITAR e CJIS quando usados com a plataforma Gemini.

Use estas instruções para configurar o app Antigravity e a CLI Antigravity para oferecer suporte aos padrões regulatórios e diretrizes semelhantes exigidos para organizações do setor público dos EUA e clientes corporativos. O desvio das etapas nesta página pode levar a uma configuração que não está em conformidade.

Uma organização de avaliação terceirizada (3PAO, na sigla em inglês) validou que essas instruções de implantação permitem que o app e a CLI do Antigravity se comuniquem apenas com um endpoint regional da API de serviço de nuvem nos EUA. O endpoint de API aiplatform.us.rep.googleapis.com já é compatível com os limites de dados do Assured Workloads para FedRAMP High, IL4, IL5, ITAR e CJIS. Para mais informações, consulte Avaliação da Coalfire do app e da CLI do Antigravity.

Observação: não é possível usar a integração empresarial do Antigravity no Gemini Enterprise para atender aos requisitos de compliance do setor público dos EUA.

Pré-requisitos

• Crie uma pasta do Assured Workloads para seu framework de compliance.

Implantar o app Antigravity e a CLI do Antigravity

Siga as etapas abaixo para implantar o app Antigravity e a CLI do Antigravity e configurar o ambiente local e o cliente para atender às expectativas de segurança da sua organização:

1. Baixe o app e a CLI do Antigravity localmente.
2. Crie um projeto na pasta do Assured Workloads e ative a API aiplatform.googleapis.com. Para ver instruções, consulte a seção Configuração do projeto e da API Google Cloud .
3. Configure a autenticação para o Antigravity conforme apropriado para seus usuários e clientes. É possível usar o Cloud Identity (para federação com seu provedor ou sistema de identidade externo) e as contas de serviço do Google Cloud para autenticação no Antigravity.

4. Faça login no Antigravity usando o Application Default Credentials, da seguinte maneira:

   • Ao usar o cliente para computador do Antigravity:

     1. Selecione um projeto na pasta do Assured Workloads.
     2. Escolha o local nos EUA.

   • Ao usar a CLI do Antigravity:

     1. Use a Google Cloud CLI para configurar o projeto de cota:

        gcloud auth application-default set-quota-project QUOTA_PROJECT_ID
        

        Substitua QUOTA_PROJECT_ID pelo ID do projeto na pasta do Assured Workloads.

     2. Configure as variáveis de ambiente a seguir:

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

Conectar-se a modelos compatíveis

Os seguintes modelos são compatíveis com FedRAMP High, IL4, IL5, ITAR e CJIS:

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

Para se conectar a uma versão do modelo que atenda aos requisitos de conformidade do setor público dos EUA, selecione EUA como o URI do endpoint de base. Selecione EUA para garantir que os comandos e as respostas estejam em conformidade com os requisitos específicos dos clientes do setor público dos EUA. Para instruções, consulte Endpoints regionais e listas de permissões de rede.

Desativar APIs opcionais

O app Antigravity e a CLI do Antigravity chamam outras APIs de back-end, mas nem todas são compatíveis com os requisitos do setor público dos EUA. Essas APIs não são necessárias para a funcionalidade principal do produto. Para manter a conformidade da implantação, desative a capacidade de invocar as seguintes APIs do ambiente local:

• Todos os endpoints multirregionais fora dos EUA em aiplatform.*.rep.googleapis.com (exceto 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

Para desativar esses endpoints no ambiente local, aplique os seguintes controles:

• Regras de rede e proxy: no proxy da Web corporativo, no firewall ou na política de DNS, bloqueie as solicitações de saída para os domínios listados, mas permita o tráfego para o endpoint aiplatform.us.rep.googleapis.com.
• Política da organização de uso de endpoints: configure a restrição da política da organização constraints/gcp.restrictEndpointUsage no nível da pasta ou do projeto para negar o grupo de valores in:non-us-aiplatform-endpoints (que bloqueia endpoints globais e não americanos da Gemini Enterprise Agent Platform) e os endpoints businessaicode.googleapis.com, businessaicode.us.rep.googleapis.com e businessaicode.eu.rep.googleapis.com. Para encontrar os endpoints multirregionais compatíveis com a Agent Platform, consulte Endpoints multirregionais. Para instruções sobre como configurar essa restrição e os grupos de valores selecionados, consulte Restringir o uso de endpoints.
• Gerenciamento de APIs do projeto: desative as APIs businessaicode.googleapis.com e cloudaicompanion.googleapis.com no projeto do Assured Workloads, se estiverem ativadas. O endpoint cloudcode-pa.googleapis.com é um endpoint interno do cliente do Google que não pode ser ativado ou desativado pelo Service Usage e precisa ser bloqueado usando as regras de rede ou de proxy. Para mais informações, consulte Desativar serviços.
• Atualizações automáticas da CLI: defina a variável de ambiente AGY_CLI_DISABLE_AUTO_UPDATE=true para evitar que a CLI do Antigravity consulte o endpoint antigravity-cli-auto-updater-974169037036.us-central1.run.app na inicialização.

Suporte para inspeção e certificados SSL/TLS

O app e a CLI do Antigravity consultam e usam automaticamente o repositório raiz confiável do sistema operacional host, como /etc/ssl/certs no Linux, o repositório de certificados do Windows no Windows e o Keychain no macOS.

Se você implantar o pacote de certificados de CA corporativa da empresa no SO do cliente, o Antigravity vai confiar e operar automaticamente no ambiente SSL/TLS inspecionado. Você não precisa de uma substituição de CA personalizada.

Se você usa proxies corporativos, o transporte HTTP da linguagem Go é compatível com as variáveis de ambiente de proxy padrão do sistema. Configure essas variáveis nas máquinas que executam o Antigravity:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Para mais informações, consulte Configurações.