Conectividad de red pública

En esta página, se describe cómo Integration Connectors puede conectarse a tus aplicaciones de backend de acceso público.

Estas son las dos formas de conectarte a tu aplicación de backend pública:

  • Conéctate directamente a tu aplicación de backend pública.
  • Conéctate a tu aplicación de backend pública a través de un firewall.

Cómo conectarte directamente a tu aplicación de backend pública

Si puedes conectarte públicamente a tu aplicación de backend, puedes configurar tu conexión para usar el extremo público especificando el extremo en el campo Hostname. Tus conexiones tendrán acceso directo a tu aplicación de backend.

Cómo conectarse a tu aplicación de backend pública a través de un firewall

En los casos en que desees restringir el acceso a tus extremos públicos con un firewall, puedes configurar Integration Connectors para que usen un conjunto de direcciones IP estáticas para el tráfico que proviene de las conexiones. Después de la configuración, todas las llamadas de una conexión provendrán de un conjunto de direcciones IP estáticas, que puedes incluir en la lista de entidades permitidas de tu firewall. Para permitir que una conexión se conecte a través de un firewall, debes seguir estos pasos generales:

  1. Crea un firewall y enruta el tráfico de salida a través de él.
  2. Asigna una dirección IP estática a tu conexión.
  3. Agrega a la lista de entidades permitidas la dirección IP estática asignada en el firewall.

Los pasos para crear y configurar un firewall están fuera del alcance de esta página. En esta página, solo se describe cómo puedes asignar direcciones IP estáticas a tus conexiones.

De forma predeterminada, Integration Connectors asigna direcciones IP automáticamente. Sin embargo, puedes configurar Integration Connectors para que generen direcciones IP estáticas en lugar de direcciones IP automáticas. Integration Connectors asigna las direcciones IP estáticas a nivel de la región. Por ejemplo, las direcciones IP estáticas de la región us-east1 serán diferentes de las direcciones IP estáticas de la región us-west2.

Para asignar direcciones IP estáticas a tu conexión, sigue estos pasos:

  1. Obtén la región de la conexión para la que deseas asignar la dirección IP estática. Puedes ver la región de conexión en la columna Location de la página Conexiones.

    Ve a la página Conexiones

  2. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  3. Configura los Integration Connectors para asignar una dirección IP estática a la región que obtuviste en el paso 1. Ejecuta el siguiente comando en Cloud Shell.
    curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"networkConfig": {"egressMode": "static_ip"}}' \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

    Establece el LOCATION en la región que obtuviste en el paso 1.

    Cuando ejecutas este comando, se muestra una respuesta similar a la siguiente:

    {
    "name": "projects/test-01/locations/us-central1/operations/operation-1696840994443-6074494b6d138-8215226d-516faaf8",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.connectors.v1.OperationMetadata",
      "createTime": "2023-10-09T08:43:14.467058513Z",
      "target": "projects/test-01/locations/us-central1/regionalSettings",
      "verb": "update",
      "requestedCancellation": false,
      "apiVersion": "v1"
     },
    "done": false
    }

    Este comando muestra un ID de operación y, luego, inicia una operación de larga duración (LRO), que puede tardar un tiempo en completarse. Espera a que se complete la LRO. Puedes hacer un seguimiento del progreso de la operación con el siguiente comando:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

    Si la asignación de la dirección IP estática se realiza correctamente, recibirás una respuesta similar a la siguiente:

    ...
    ...
    "response": {
      "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
      "name": "projects/test-01/locations/us-central1/regionalSettings",
      "networkConfig": {
       "egressMode": "STATIC_IP",
        "egressIps": [
          "35.193.227.203",
          "34.133.63.9",
          "35.223.253.58",
          "34.170.27.253"
        ]
      }
    }
    

    En esta respuesta de ejemplo, se asignan cuatro direcciones IP estáticas para la región us-central1 y el egressMode de la región se establece en STATIC_IP.

  4. Agrega las direcciones IP estáticas (obtenidas en el paso 4) a la lista de entidades permitidas en tus reglas de firewall.

Obtén direcciones IP estáticas de una región

Si en algún momento deseas obtener las direcciones IP estáticas asignadas a una región (ubicación), ejecuta el siguiente comando:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

Cuando ejecutas este comando, se muestra una respuesta similar a la siguiente:

  "response": {
    "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
    "name": "projects/test-01/locations/us-central1/regionalSettings",
    "networkConfig": {
     "egressMode": "STATIC_IP",
      "egressIps": [
        "35.193.227.203",
        "34.133.63.9",
        "35.223.253.58",
        "34.170.27.253"
      ]
    }
  }

Asigna direcciones IP automáticas a una región

Si deseas quitar la configuración de dirección IP estática de una región y asignar las direcciones IP automáticamente, debes ejecutar el siguiente comando en la terminal:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"networkConfig": {"egressMode": "auto_ip"}}' \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

Al igual que el comando anterior para configurar direcciones IP estáticas, este comando también muestra un ID de operación y comienza una operación de larga duración (LRO) que puede tardar un poco en completarse. Espera a que se complete la LRO.

Consideraciones

Ten en cuenta los siguientes puntos cuando asignes direcciones IP estáticas para una región:

  • El conjunto reservado de direcciones IP estáticas es diferente para cada región de un proyecto.
  • Cuando cambias el modo de salida de una región de STATIC_IP a AUTO_IP, no se retiene el conjunto original de direcciones IP estáticas y, por lo tanto, cuando vuelves a cambiar el modo de salida de AUTO_IP a STATIC_IP, se asigna un nuevo conjunto de direcciones IP estáticas.
  • Cuando cambias el modo de salida de AUTO_IP a STATIC_IP o viceversa, puedes esperar un tiempo de inactividad de unos segundos.