Gerenciar regiões

A Application Integration é regional. Isso significa que a infraestrutura que executa as integrações está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região. Além de selecionar a região de provisionamento inicial para o Application Integration durante o processo de configuração, também é possível ativar ou provisionar novas regiões para criar e gerenciar suas integrações no mesmo projeto do Google Cloud.

Nesta página, descrevemos as etapas necessárias para provisionar uma nova região do Application Integration e editar uma região atual no projeto do Google Cloud .

Antes de começar

Ative as APIs a seguir:

• API Application Integration (integrations.googleapis.com)
• API Connectors (connectors.googleapis.com)

Provisionar nova região

Para provisionar uma nova região para a Application Integration no seu projeto do Google Cloud , selecione uma das seguintes opções:

Console

1. Acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Regiões.

   A página Regiões aparece listando todas as regiões provisionadas no seu projeto.

3. Clique em Provisionar nova região.
4. Configure os seguintes campos na página Provisionar nova região:
   1. Região: selecione o novo local regional que você quer provisionar.

      Para informações sobre as regiões compatíveis com o Application Integration, consulte Locais do Application Integration.

   2. Configurações avançadas: se quiser, expanda essa seção para ativar ou desativar o acesso HTTP para integrações e configurar o método de criptografia para a região selecionada.
      • HTTP: clique no botão Ativar HTTP para ativar o acesso HTTP para integrações na região selecionada. Quando ativadas, as integrações nessa região podem ser acessadas por HTTP.
        Observação: o botão HTTP fica desativado por padrão para garantir que todas as integrações sejam invocadas com segurança por HTTPS.
      • Recursos de IA: clique no botão Ativar recursos de IA para ativar os recursos de IA na região selecionada. Para mais informações sobre como resolver problemas usando a IA do Gemini, consulte Resolver problemas de registros de execução com falha usando a IA.
      • Criptografia: selecione o método de criptografia para a região selecionada. Existem duas opções:
        • Google-owned and Google-managed encryption key: este é o método de criptografia padrão. Use esse método se quiser que o Google gerencie as chaves de criptografia que protegem seus dados na região selecionada.
        • Chave de criptografia gerenciada pelo cliente (CMEK): use esse método se quiser gerenciar as chaves de criptografia que protegem seus dados na região selecionada.
          Atenção: não é possível desfazer a ativação da criptografia CMEK em uma região do Application Integration. Isso também significa que não é possível mudar o método de criptografia de uma região depois que a CMEK é ativada.

          Ao definir as configurações de criptografia, você tem duas opções para gerenciar a CMEK: Application Integration e Connectors (CMEK) e Usar uma CMEK diferente para o Integration Connectors, conforme descrito abaixo:

          • Application Integration e Connectors - CMEK: essa é a opção padrão e é adequada se você quiser usar a mesma chave de criptografia para a Application Integration e o Integration Connectors. Para usar essa opção, siga estas etapas:
            1. Clique em Selecionar uma chave do Cloud KMS e escolha uma chave CMEK disponível na região selecionada. Também é possível criar uma nova chave ou usar o ID do recurso do KMS da sua chave atual.
            2. Clique em Verificar para conferir se a conta de serviço padrão tem acesso de CryptoKey à chave CMEK selecionada.
            3. Se a verificação falhar, clique em Conceder para atribuir o papel do IAM de criptografador/descriptografador de CryptoKey à conta de serviço padrão.
            Dica: conceder acesso à CryptoKey é uma etapa opcional, o que significa que você pode clicar diretamente em "Concluído" para concluir o processo de configuração do Application Integration. No entanto, se você não conceder acesso à CryptoKey, os perfis de autenticação do Application Integration não serão configurados, e você precisará conceder esse acesso manualmente ao criar um novo perfil de autenticação.
          • Usar uma CMEK diferente para o Integration Connectors: marque essa caixa de seleção se preferir usar chaves de criptografia separadas para o Application Integration e o Integration Connectors. Se selecionada, as seguintes opções vão aparecer:
            • Application Integration - CMEK
              1. Clique em Selecionar uma chave do Cloud KMS e escolha uma chave CMEK para o Application Integration na região selecionada. Também é possível criar uma nova chave ou usar o ID de recurso de uma chave atual.
              2. Clique em Verificar para concluir a configuração da CMEK para a Application Integration.
            • Integration Connectors - CMEK
              1. Clique em Selecionar uma chave do Cloud KMS e escolha uma chave CMEK para o Integration Connectors na região selecionada. Também é possível criar uma nova chave ou usar o ID de recurso de uma chave atual.
              2. Clique em Verificar para conferir se a conta de serviço padrão tem acesso de CryptoKey à CMEK selecionada.
              3. Se a verificação da chave CMEK selecionada falhar, clique em Conceder para atribuir o papel do IAM de criptografia/descriptografia do CryptoKey à conta de serviço padrão.
            Observação: o Application Integration verifica automaticamente se a conta de serviço padrão tem acesso de CryptoKey à CMEK selecionada, se a CMEK do Integration Connectors estiver ativada. Se a verificação falhar, você precisará conceder esse acesso manualmente.

          Para mais informações sobre CMEK, consulte Chaves de criptografia gerenciadas pelo cliente.

5. Clique em Concluído.

Terraform

Use o recurso google_integrations_client. O exemplo a seguir provisiona a região us-east1:

resource "random_id" "default" {
  byte_length = 8
}

resource "google_kms_key_ring" "default" {
  name     = "${random_id.default.hex}-example-keyring"
  location = "us-east1"
}

resource "google_kms_crypto_key" "default" {
  name            = "crypto-key-example"
  key_ring        = google_kms_key_ring.default.id
  rotation_period = "7776000s"
}

resource "google_kms_crypto_key_version" "default" {
  crypto_key = google_kms_crypto_key.default.id
}

resource "google_service_account" "default" {
  account_id   = "service-account-id"
  display_name = "Service Account"
}

resource "google_integrations_client" "example" {
  location                   = "us-east1"
  create_sample_integrations = true
  run_as_service_account     = google_service_account.default.email
  cloud_kms_config {
    kms_location   = "us-east1"
    kms_ring       = basename(google_kms_key_ring.default.id)
    key            = basename(google_kms_crypto_key.default.id)
    key_version    = basename(google_kms_crypto_key_version.default.id)
    kms_project_id = data.google_project.default.project_id
  }
}

Editar região

É possível editar uma região para ativar ou desativar a governança de integração e atualizar o método de criptografia de dados da região.

Atenção: não é possível desfazer a ativação da criptografia CMEK em uma região da Application Integration. Isso também significa que não é possível mudar o método de criptografia de uma região se a CMEK já estiver ativada.

Para editar uma região na Application Integration, siga estas etapas:

1. No console do Google Cloud , acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Regiões.

A página Regiões é exibida, listando as regiões provisionadas na Application Integration.

3. Para a região que você quer editar, na coluna Ações, clique em Ações da região e selecione Editar.

   O painel Editar região é exibido.

4. Expanda Configurações avançadas.
5. Para ativar ou desativar a governança de integração na região selecionada, clique no botão Ativar governança.
   Observação:

   • Ative a governança para tornar a autenticação da conta de serviço obrigatória para a região. Depois que a governança for ativada, você precisará adicionar manualmente uma conta de serviço a todas as novas integrações e versões de integração criadas nesta região. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Configurações de integração na barra de ferramentas de integração.

     Se a governança estiver ativada, só será possível publicar ou testar uma integração quando uma conta de serviço estiver anexada a ela.

   • Se você desativar a governança para a região selecionada, todas as integrações publicadas vão continuar usando as respectivas contas de serviço anexadas até que uma nova versão das integrações seja criada.
6. Para ativar ou desativar o acesso HTTP para integrações na região selecionada, clique no botão Ativar HTTP. Quando ativadas, as integrações nessa região podem ser acessadas por HTTP.
7. Para ativar ou desativar os recursos de IA para integrações na região selecionada, clique no botão Ativar recursos de IA. Quando ativado, você pode usar recursos de IA, como solução de problemas com a IA do Gemini, na região selecionada.
8. Para ativar o mascaramento de variáveis, na seção Mascaramento de variáveis, clique no botão Ativar mascaramento de variáveis nos registros.

   Para saber mais sobre o mascaramento, consulte Mascarar dados sensíveis nos registros.

9. Para ativar a criptografia CMEK na região selecionada, selecione Chave de criptografia gerenciada pelo cliente (CMEK) e faça o seguinte:
   1. Selecione uma CMEK na lista suspensa disponível. As CMEKs listadas no menu suspenso são baseadas na região provisionada. Para criar uma nova chave, consulte Criar nova CMEK.
   2. Clique em Verificar para conferir se a conta de serviço padrão tem acesso de CryptoKey à CMEK selecionada.
   3. Se a verificação da CMEK selecionada falhar, clique em Conceder para atribuir o papel do IAM de criptografia/descriptografia do CryptoKey à conta de serviço padrão.
10. Para ativar a criptografia CMEK para o Integration Connectors, selecione Usar CMEK diferente para o Integration Connectors e faça o seguinte:
    1. Selecione uma CMEK na lista suspensa disponível. As CMEKs listadas no menu suspenso são baseadas na região provisionada. Para criar uma nova chave, consulte Criar nova CMEK.
    2. Clique em Verificar para concluir a configuração da CMEK do Integration Connectors.
11. Clique em Concluído para terminar de editar a região.