Administrar regiones

Application Integration es regional, lo que significa que la infraestructura que ejecuta tus integraciones se encuentra en una región específica, y Google la administra para que esté disponible de forma redundante en todas las zonas dentro de esa región. Además de seleccionar la región de aprovisionamiento inicial para Application Integration durante el proceso de configuración, también puedes habilitar o aprovisionar regiones nuevas para crear y administrar tus integraciones dentro del mismo proyecto de Google Cloud.

En esta página, se describen los pasos necesarios para aprovisionar correctamente una nueva región de Application Integration y editar una región existente en tu proyecto de Google Cloud .

Antes de comenzar

Habilita las siguientes APIs:

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

Aprovisionar nueva región

Para aprovisionar una región nueva para Application Integration en tu proyecto de Google Cloud , selecciona una de las siguientes opciones:

Console

1. Ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Regiones.

   Aparecerá la página Regiones con una lista de todas las regiones aprovisionadas en tu proyecto.

3. Haz clic en Aprovisionar región nueva.
4. Configura los siguientes campos en la página Aprovisionar región nueva:
   1. Región: Selecciona la nueva ubicación regional que deseas aprovisionar.

      Para obtener información sobre las regiones compatibles de Application Integration, consulta Ubicaciones de Application Integration.

   2. Configuración avanzada: De manera opcional, expande esta sección para habilitar o inhabilitar el acceso HTTP para las integraciones y configurar el método de encriptación de la región seleccionada.
      • HTTP: Haz clic en el botón de activación Habilitar HTTP para habilitar el acceso HTTP para las integraciones dentro de la región seleccionada. Cuando se habilita, se puede acceder a las integraciones de esta región a través de HTTP.
        Nota: El botón de activación de HTTP está inhabilitado de forma predeterminada para garantizar que todas las integraciones se invoquen de forma segura a través de HTTPS.
      • Funciones potenciadas por IA: Haz clic en el botón de activación Habilitar funciones potenciadas por IA para habilitar las funciones potenciadas por IA en la región seleccionada. Para obtener más información sobre cómo solucionar problemas con la IA de Gemini, consulta Soluciona problemas de registros de ejecución con errores con IA.
      • Encriptación: Selecciona el método de encriptación para la región seleccionada. Existen dos opciones:
        • Google-owned and Google-managed encryption key: Este es el método de encriptación predeterminado. Usa este método si quieres que Google administre las claves de encriptación que protegen tus datos en la región seleccionada.
        • Clave de encriptación administrada por el cliente (CMEK): Usa este método si quieres administrar las claves de encriptación que protegen tus datos en la región seleccionada.
          Precaución: No se puede deshacer la habilitación de la encriptación de CMEK para una región de Application Integration. Esto también significa que no puedes cambiar el método de encriptación de una región una vez que se habilitan las CMEK.

          Cuando configures los parámetros de encriptación, tendrás dos opciones para administrar las CMEK: Application Integration y Connectors (CMEK), y Usar una CMEK diferente para Integration Connectors, como se indica a continuación:

          • Application Integration y conectores - CMEK: Esta es la opción predeterminada y es adecuada si deseas usar la misma clave de encriptación para Application Integration y Integration Connectors. Para usar esta opción, sigue estos pasos:
            1. Haz clic en Seleccionar una clave de Cloud KMS y elige una clave de CMEK existente disponible en la región seleccionada. También puedes crear una clave nueva o usar el ID de recurso de KMS de tu clave existente.
            2. Haz clic en Verificar para comprobar si tu cuenta de servicio predeterminada tiene acceso de CryptoKey a la clave de CMEK seleccionada.
            3. Si la verificación falla, haz clic en Otorgar para asignar el rol de IAM de encriptador/desencriptador de CryptoKey a la cuenta de servicio predeterminada.
            Sugerencia: Otorgar acceso a CryptoKey es un paso opcional, lo que significa que puedes hacer clic directamente en Listo para completar el proceso de configuración de Application Integration. Sin embargo, si no otorgas acceso a CryptoKey, no se configuran los perfiles de autenticación para Application Integration, y debes otorgar este acceso de forma manual cuando creas un perfil de autenticación nuevo.
          • Usa una CMEK diferente para Integration Connectors: Selecciona esta casilla de verificación si prefieres usar claves de encriptación independientes para Application Integration y Integration Connectors. Si se selecciona, aparecen las siguientes opciones:
            • Application Integration: CMEK
              1. Haz clic en Seleccionar una clave de Cloud KMS y elige una clave de CMEK existente para Application Integration en la región seleccionada. Como alternativa, puedes crear una clave nueva o usar el ID de recurso de clave de una existente.
              2. Haz clic en Verificar para terminar de configurar la CMEK para Application Integration.
            • Integration Connectors: CMEK
              1. Haz clic en Selecciona una clave de Cloud KMS y elige una clave de CMEK existente para Integration Connectors en la región seleccionada. Como alternativa, puedes crear una clave nueva o usar el ID de recurso de clave de una clave existente.
              2. Haz clic en Verificar para comprobar si tu cuenta de servicio predeterminada tiene acceso de CryptoKey a la CMEK seleccionada.
              3. Si falla la verificación de la clave de CMEK seleccionada, haz clic en Otorgar para asignar el rol de IAM de encriptador/desencriptador de CryptoKey a la cuenta de servicio predeterminada.
            Nota: Application Integration verifica automáticamente si tu cuenta de servicio predeterminada tiene acceso de CryptoKey a la CMEK seleccionada, si la CMEK de Integration Connectors está habilitada. Si la verificación falla, deberás otorgar este acceso de forma manual.

          Para obtener más información sobre las CMEK, consulta Claves de encriptación administradas por el cliente.

5. Haz clic en Listo.

Terraform

Usa el recurso google_integrations_client. En el siguiente ejemplo, se aprovisiona la región 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
  }
}

Edita la región

Puedes editar una región existente para habilitar o inhabilitar la administración de integraciones, y actualizar el método de encriptación de datos de la región.

Precaución: No se puede deshacer la habilitación de la encriptación de CMEK para una región de Application Integration. Esto también significa que no puedes cambiar el método de encriptación de una región si las CMEK ya están habilitadas.

Para editar una región existente en Application Integration, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Regiones.

Aparecerá la página Regiones, en la que se enumeran las regiones aprovisionadas en Application Integration.

3. Para la región existente que deseas editar, en la columna Acciones, haz clic en Acciones de la región y selecciona Editar.

   Aparecerá el panel Editar región.

4. Expande la opción Configuración avanzada.
5. Para habilitar o inhabilitar la administración de integraciones en la región seleccionada, haz clic en el botón de activación Habilitar administración.
   Nota:

   • Habilita la administración para que la autenticación de la cuenta de servicio sea obligatoria en la región. Una vez que se habilite la administración, debes agregar manualmente una cuenta de servicio a todas las integraciones y versiones de integración nuevas que se creen en esta región. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Configuración de la integración en la barra de herramientas de la integración.

     Si la administración está habilitada, solo puedes publicar o probar una integración cuando tiene una cuenta de servicio adjunta.

   • Si inhabilitas la administración para la región seleccionada, todas las integraciones publicadas existentes seguirán usando sus respectivas cuentas de servicio adjuntas hasta que se cree una versión nueva de las integraciones.
6. Para habilitar o inhabilitar el acceso HTTP para las integraciones en la región seleccionada, haz clic en el botón de activación Habilitar HTTP. Cuando se habilita, se puede acceder a las integraciones de esta región a través de HTTP.
7. Para habilitar o inhabilitar las funciones potenciadas por IA para las integraciones en la región seleccionada, haz clic en el botón de activación Habilitar funciones potenciadas por IA. Cuando se habilita, puedes usar funciones potenciadas por IA, como la solución de problemas con la IA de Gemini, en la región seleccionada.
8. Para habilitar el enmascaramiento de variables, en la sección Enmascaramiento de variables, haz clic en el botón de activación Habilitar el enmascaramiento de variables en los registros.

   Para obtener información sobre el enmascaramiento, consulta Enmascara datos sensibles en registros.

9. Para habilitar la encriptación con CMEK en la región seleccionada, elige Clave de encriptación administrada por el cliente (CMEK) y haz lo siguiente:
   1. Selecciona una CMEK de la lista desplegable disponible. Las CMEK que se indican en el menú desplegable se basan en la región aprovisionada. Para crear una clave nueva, consulta Crea una CMEK nueva.
   2. Haz clic en Verificar para comprobar si tu cuenta de servicio predeterminada tiene acceso de CryptoKey a la CMEK seleccionada.
   3. Si falla la verificación de la CMEK seleccionada, haz clic en Otorgar para asignar el rol de IAM de encriptador/desencriptador de CryptoKey a la cuenta de servicio predeterminada.
10. Para habilitar la encriptación de CMEK para Integration Connectors, selecciona Usar una CMEK diferente para Integration Connectors y haz lo siguiente:
    1. Selecciona una CMEK de la lista desplegable disponible. Las CMEK que se indican en el menú desplegable se basan en la región aprovisionada. Para crear una clave nueva, consulta Crea una CMEK nueva.
    2. Haz clic en Verificar para terminar de configurar la CMEK de Integration Connectors.
11. Haz clic en Listo para terminar de editar la región.