Configurar acceso privado a Google

De forma predeterminada, cuando una VM de Compute Engine no tiene una dirección IP externa asignada a su interfaz de red, solo puede enviar paquetes a otros destinos con direcciones IP internas. Puedes permitir que estas VM se conecten al conjunto de direcciones IP externas que las API y los servicios de Google usan si habilitas el Acceso privado a Google en la subred que usa la interfaz de red de la VM.

El Acceso privado a Google también permite el acceso a las direcciones IP externas que usa App Engine, incluidos los servicios de terceros basados en App Engine.

Para ver las API y los servicios aptos que puedes usar con el Acceso privado a Google, visita Servicios compatibles en la descripción general del Acceso privado a Google.

Consulta Opciones de acceso privado a los servicios para obtener información general sobre el Acceso privado a Google y otras opciones de conectividad privada que ofrece Google Cloud.

Especificaciones

Una interfaz de VM puede enviar paquetes a las direcciones IP externas de los servicios y las API de Google mediante el Acceso privado a Google, si se cumplen todas estas condiciones:

  • La interfaz de VM está conectada a una subred en la que el Acceso privado a Google está habilitado.

  • La red de VPC que contiene la subred cumple con los requisitos de red para las API y los servicios de Google.

  • La interfaz de VM no tiene asignada una dirección IP externa.

  • La dirección IP de origen de los paquetes que se envían desde la VM coincide con una de las siguientes direcciones IP.

    Si envías paquetes a los dominios predeterminados, haz lo siguiente:

    • La dirección IPv4 interna principal de la interfaz de VM
    • La dirección IPv6 interna de la interfaz de VM
    • Una dirección IPv4 interna de un rango de alias de IP

    Si envías paquetes a los dominios private.googleapis.com o restricted.googleapis.com, usa este comando:

    • La dirección IPv4 interna principal de la interfaz de VM
    • Una dirección IPv4 interna de un rango de alias de IP

Una VM con una dirección IPv4 o IPv6 externa asignada a su interfaz de red no necesita Acceso privado a Google para conectarse a los servicios y las API de Google. Sin embargo, la red de VPC debe cumplir con los requisitos para acceder a las API y los servicios de Google.

Puedes anular la asignación de una dirección IPv4 externa de una instancia de VM existente, incluso mientras se ejecuta. Para obtener más información, consulta Anula la asignación de una dirección IP externa estática.

Puedes anular la asignación de una dirección IPv6 externa de una instancia de VM existente, incluso mientras se ejecuta. Para obtener más información, consulta Cambia el tipo de pila de una VM.

Requisitos de red

El Acceso privado a Google tiene los siguientes requisitos:

  • Debido a que el Acceso privado a Google se habilita por subred, debes usar una red de VPC. Las redes heredadas no son compatibles porque no admiten subredes.

  • El Acceso privado a Google no habilita de forma automática ninguna API. Debes habilitar las API de Google por separado mediante la página de API y servicios en Google Cloud Console.

  • Si deseas conectarte a los servicios y las API de Google mediante IPv6, debes cumplir con estos requisitos:

  • Si usas los nombres de dominio private.googleapis.com o restricted.googleapis.com, tendrás que crear registros DNS para dirigir el tráfico a las direcciones IP asociadas con esos dominios. Para obtener más información, consulta Configuración de red. Estos nombres de dominio solo ofrecen conectividad IPv4.

  • La red debe tener rutas adecuadas para los rangos de IP de destino que usan las API y los servicios de Google. Estas rutas deben usar el siguiente salto de puerta de enlace de Internet predeterminado. Si usas los nombres de dominio private.googleapis.com o restricted.googleapis.com, solo necesitas una ruta (por dominio). De lo contrario, deberás crear varias rutas. Consulta Opciones de enrutamiento para obtener más detalles.

  • Los firewalls de salida deben permitir el tráfico a los rangos de direcciones IP que usan las API y los servicios de Google. La regla de firewall de permiso de salida implícita satisface este requisito. Para conocer otras formas de cumplir con el requisito de firewall, consulta la Configuración de firewall.

Permisos

Los propietarios del proyecto, los editores y los principales de IAM con la función de administrador de red pueden crear o actualizar las subredes y asignar direcciones IP.

Consulta la documentación sobre las funciones de IAM para obtener más información.

Logging

Cloud Logging captura todas las solicitudes a la API que se realizan desde las instancias de VM en las subredes que tienen el Acceso privado a Google habilitado. Las entradas de registro identifican el origen de la solicitud a la API como una dirección IP interna de la instancia que realiza la llamada.

Puedes configurar el uso diario y los informes mensuales acumulativos para que se envíen a un bucket de Cloud Storage. Consulta la página Visualiza informes de uso para obtener detalles.

Configuración de red

En esta sección, se describen los requisitos de red básicos que debes cumplir para que una VM en tu red de VPC acceda a las API y los servicios de Google.

Opciones de dominio

Primero debes elegir el dominio para acceder a las API y a los servicios de Google.

Las VIP private.googleapis.com y restricted.googleapis.com solo admiten protocolos basados en HTTP en TCP (HTTP, HTTPS y HTTP/2). No se admite ningún otro protocolo, incluidos ICMP y MQTT.

Rangos de direcciones IP y dominio Servicios compatibles Ejemplo de uso
Dominios predeterminados

Todos los nombres de dominio para las API y los servicios de Google, excepto private.googleapis.com y restricted.googleapis.com.

Varios rangos de direcciones IP: puedes determinar un conjunto de rangos de IP que contenga las direcciones posibles que usan los dominios predeterminados si haces referencia a las direcciones IP para dominios predeterminados.
Habilita el acceso a la mayoría de los servicios y las API de Google, sin importar si son compatibles con los Controles del servicio de VPC. Incluye el acceso a la API para Google Maps, Google Ads y Google Cloud. Incluye Google Workspace y otras aplicaciones web. Los dominios predeterminados se usan cuando no configuras los registros DNS para private.googleapis.com y restricted.googleapis.com.
private.googleapis.com

199.36.153.8/30
Habilita el acceso a la mayoría de los servicios y las API de Google, sin importar si son compatibles con los Controles del servicio de VPC. Incluye acceso a la API de Maps, Google Ads, Google Cloud y la mayoría de las demás API de Google, incluidas las listas que aparecen a continuación. Es incompatible con las aplicaciones web de Google Workspace. No es compatible con ningún sitio web interactivo.

Nombres de dominio que coinciden:
  • accounts.google.com (solo las rutas de acceso necesarias para la autenticación OAuth)
  • appengine.google.com
  • *.appspot.com
  • *.cloudfunctions.net
  • *.cloudproxy.app
  • *.composer.cloud.google.com
  • *.composer.googleusercontent.com
  • *.datafusion.cloud.google.com
  • *.datafusion.googleusercontent.com
  • dl.google.com
  • gcr.io o *.gcr.io
  • *.googleadapis.com
  • *.googleapis.com
  • *.gstatic.com
  • *.ltsapis.goog
  • *.notebooks.cloud.google.com
  • *.notebooks.googleusercontent.com
  • packages.cloud.google.com
  • pkg.dev o *.pkg.dev
  • pki.goog o *.pki.goog
  • *.run.app
  • source.developers.google.com

Usa private.googleapis.com para acceder a las API y a los servicios de Google mediante un conjunto de direcciones IP que solo se pueden enrutar desde Google Cloud.

Elige private.googleapis.com en estas circunstancias:

  • Si no usas los Controles del servicio de VPC.
  • Debes usar los Controles del servicio de VPC, así como acceder a los servicios y las API de Google que no son compatibles con estos controles.

restricted.googleapis.com

199.36.153.4/30
Habilita el acceso a la API a los servicios y las API de Google que son compatibles con los Controles del servicio de VPC.

Bloquea el acceso a los servicios y a las API de Google que son incompatibles con los Controles del servicio de VPC. Es incompatible con las aplicaciones web de Google Workspace y con las API de Google Workspace.

Usa restricted.googleapis.com para acceder a las API y a los servicios de Google mediante un conjunto de direcciones IP que solo se pueden enrutar desde Google Cloud.

Elige restricted.googleapis.com solo cuando necesites acceso a los servicios y las API de Google que son compatibles con los Controles del servicio de VPC. restricted.googleapis.com no permite el acceso a los servicios ni las API de Google que no son compatibles con los Controles del servicio de VPC.

Configuración de DNS

Para la conectividad IPv4 a los servicios y las API de Google, puedes elegir enviar paquetes a las direcciones IP asociadas con private.googleapis.com o restricted.googleapis.com. Para ello, debes configurar el DNS de modo que las VM de la red de VPC resuelvan las solicitudes en *.googleapis.com y cualquier otro dominio al que necesites acceder. Por ejemplo, si usas Google Kubernetes Engine (GKE), también debes configurar *.gcr.io y *.pkg.dev.

  1. Crea una zona de DNS privada para googleapis.com. Se recomienda crear una zona privada de Cloud DNS para este propósito.
  2. En la zona googleapis.com, crea uno de los siguientes registros A, según el dominio elegido:

    • Un registro A para private.googleapis.com que apunte a las siguientes direcciones IP: 199.36.153.8199.36.153.9199.36.153.10199.36.153.11
    • Un registro A para restricted.googleapis.com que apunte a las siguientes direcciones IP: 199.36.153.4199.36.153.5199.36.153.6199.36.153.7

    Si usas Cloud DNS, agrega los registros a la zona privada googleapis.com.

  3. En la zona googleapis.com, crea un registro CNAME para *.googleapis.com que apunte a cualquier registro A que creaste en el paso anterior.

Algunos servicios y API de Google se proporcionan a través de nombres de dominio adicionales, incluidos *.gcr.io, *.gstatic.com, *.pkg.devy pki.goog. Consulta la tabla de rangos de direcciones IP y dominios en Opciones de dominio para determinar si se puede acceder a los servicios del dominio adicional mediante private.googleapis.com o restricted.googleapis.com. Luego, para cada uno de los dominios adicionales, sigue estos pasos:

  1. Crea una zona de DNS para el dominio adicional (por ejemplo, gcr.io). Si usas Cloud DNS, asegúrate de que esta zona se encuentre en el mismo proyecto que la zona privada googleapis.com.
  2. En esta zona de DNS, haz lo siguiente:
    • Crea un registro A para el nombre de dominio (zona); por ejemplo, gcr.io. Haz que este registro A apunte a las mismas cuatro direcciones IP para el nombre de dominio personalizado que elegiste (private.googleapis.com o restricted.googleapis.com).
    • Crea un registro CNAME para todos los nombres de host posibles del dominio adicional; para ello, usa un asterisco y un punto seguidos del nombre de dominio (zona). Por ejemplo, *.gcr.io. Haz que este registro CNAME apunte al registro A en la misma zona. Por ejemplo, haz que *.gcr.io apunte hacia gcr.io.

Opciones de enrutamiento

La red de VPC debe tener rutas adecuadas cuyo siguiente salto sea la puerta de enlace de Internet predeterminada. Google Cloud no admite el enrutamiento del tráfico a las API y a los servicios de Google a través de otras instancias de VM o siguientes saltos personalizados. A pesar de que se denominan puerta de enlace de Internet predeterminada, los paquetes enviados desde las VM de la red de VPC hacia las API y los servicios de Google permanecen dentro de la red de Google.

  • Si seleccionas los dominios predeterminados, las instancias de VM se conectarán a las API y a los servicios de Google mediante un subconjunto de direcciones IP externas de Google. Estas direcciones IP se pueden enrutar de forma pública, pero la ruta desde una VM en una red de VPC hacia esas direcciones permanece dentro de la red de Google.

  • Google no publica las rutas en Internet de ninguna de las direcciones IP que usan los dominios private.googleapis.com o restricted.googleapis.com. En consecuencia, solo las VM en una red de VPC o en sistemas locales conectados a una red de VPC pueden acceder a estos dominios.

Si la red de VPC contiene una ruta predeterminada cuyo siguiente salto es la puerta de enlace de Internet predeterminada, puedes usar esa ruta a fin de acceder a los servicios y a las API de Google, sin necesidad de crear rutas personalizadas. Consulta Enruta con una ruta predeterminada para obtener más detalles.

Si reemplazaste una ruta predeterminada IPv4 (destino 0.0.0.0/0) por una ruta personalizada cuyo siguiente salto no es la puerta de enlace de Internet predeterminada, puedes cumplir con los requisitos de enrutamiento de Google para las API y los servicios usando el enrutamiento personalizado en su lugar.

Si reemplazaste una ruta IPv6 predeterminada (destino ::/0) por una ruta personalizada cuyo siguiente salto no es la puerta de enlace de Internet predeterminada o si la red de VPC no tiene una ruta IPv6 predeterminada, no tendrás conectividad IPv6 a los servicios ni a las API de Google, a menos que reemplaces la ruta predeterminada IPv6.

Enrutamiento con una ruta predeterminada

Cada red de VPC contiene una ruta predeterminada de IPv4 (0.0.0.0/0) cuando se crea. Si habilitas direcciones IPv6 externas en una subred, se agregará una ruta IPv6 predeterminada (::/0) generada por el sistema a esa red de VPC.

La ruta predeterminada IPv4 proporciona una ruta de acceso a las direcciones IPv4 de los dominios predeterminados, el destino 199.36.153.8/30 para private.googleapis.com y el destino 199.36.153.4/30 para restricted.googleapis.com.

La ruta predeterminada IPv6 solo proporciona una ruta de acceso a las direcciones IPv6 para los dominios predeterminados. No se puede acceder a los dominios private.googleapis.com ni restricted.googleapis.com con la conectividad IPv6.

Para verificar la configuración de una ruta predeterminada en una red determinada, sigue estas instrucciones.

Console

  1. Ve a la página Rutas en Google Cloud Console.
    Ir a la página Rutas
  2. Filtra la lista de rutas para ver solo las rutas de la red que debes inspeccionar.
  3. Busca una ruta cuyo destino sea 0.0.0.0/0 para el tráfico de IPv4 o ::/0 para el tráfico de IPv6 y cuyo siguiente salto sea la puerta de enlace de Internet predeterminada.

gcloud

Usa el siguiente comando de gcloud y reemplaza NETWORK_NAME por el nombre de la red que quieres inspeccionar:

gcloud compute routes list \
    --filter="default-internet-gateway NETWORK_NAME"

Si necesitas crear una ruta IPv4 de reemplazo predeterminada, consulta Agrega una ruta estática.

Si necesitas crear una ruta IPv6 predeterminada de reemplazo, consulta Agrega una ruta predeterminada IPv6.

Enrutamiento personalizado

Como alternativa a una ruta predeterminada para el tráfico IPv4, puedes usar rutas estáticas personalizadas; cada una debe tener un destino más específico y usar el siguiente salto de puerta de enlace de Internet predeterminada. La cantidad de rutas que necesitas y sus direcciones IP de destino dependen del dominio que elijas.

A fin de verificar la configuración de las rutas personalizadas para las API y los servicios de Google en una red determinada, sigue estas instrucciones.

Console

  1. Ve a la página Rutas en Google Cloud Console.
    Ir a la página Rutas
  2. Usa el campo de texto Tabla de filtros para filtrar la lista de rutas con los siguientes criterios y reemplaza NETWORK_NAME por el nombre de tu red de VPC.
    • Red: NETWORK_NAME
    • Tipo de salto siguiente: default internet gateway
  3. Observa la columna Rango de IP de destino para cada ruta. Si seleccionaste los dominios predeterminados, busca varias rutas estáticas personalizadas, una para cada rango de direcciones IP que usa el dominio predeterminado. Si eliges private.googleapis.com o restricted.googleapis.com, busca el rango de IP de ese dominio.

gcloud

Usa el siguiente comando de gcloud y reemplaza NETWORK_NAME por el nombre de la red que quieres inspeccionar:

gcloud compute routes list \
    --filter="default-internet-gateway NETWORK_NAME"

Las rutas se enumeran en formato de tabla, a menos que personalices el comando con la marca --format. Busca en la columna DEST_RANGE el destino de cada ruta. Si seleccionaste los dominios predeterminados, busca varias rutas estáticas personalizadas, una para cada rango de direcciones IP que usa el dominio predeterminado. Si eliges private.googleapis.com o restricted.googleapis.com, busca el rango de IP de ese dominio.

Si necesitas crear rutas, consulta Agrega una ruta estática.

Configuración de firewall

La configuración de firewall de la red de VPC debe permitir el acceso de las VM a las direcciones IP que usan las API y los servicios de Google. La regla implícita allow egress cumple con este requisito.

En algunas opciones de configuración de firewall, debes crear reglas de permiso de salida específicas. Por ejemplo, supongamos que creaste una regla de denegación de salida que bloquea el tráfico a todos los destinos (0.0.0.0 para IPv4 o ::/0 para IPv6). En ese caso, debes crear una regla de firewall de permiso de salida cuya prioridad sea superior a la regla de denegación de salida para cada rango de direcciones IP que usa el dominio elegido para las API y los servicios de Google.

Para crear reglas de firewall, consulta Crea reglas de firewall. Puedes limitar las VM a las que se aplican las reglas de firewall cuando defines el destino de cada regla de permiso de salida.

Direcciones IP para dominios predeterminados

Sigue estos pasos para determinar los rangos de direcciones IP que usan los dominios predeterminados, como *.googleapis.com y *.gcr.io.

  • Google publica la lista completa de rangos de IP que pone a disposición de los usuarios en Internet, en goog.json.

  • Google también publica una lista de los rangos de direcciones IP externas internacionales y regionales disponibles para los recursos de Google Cloud del cliente en cloud.json.

Las direcciones IP que usan los dominios predeterminados para las API y los servicios de Google se ajustan a la lista de rangos calculados mediante la eliminación de todos los rangos en cloud.json de los que están en goog.json. En el siguiente ejemplo, se muestra cómo obtener este rango con Python.

Puedes usar la siguiente secuencia de comandos de Python a fin de crear una lista de rangos de direcciones IP que incluyan los que usan los dominios predeterminados para las API y los servicios de Google.

Para obtener información sobre cómo ejecutar esta secuencia de comandos, consulta Cómo ejecutar.

from __future__ import print_function

import json

try:
    from urllib import urlopen
except ImportError:
    from urllib.request import urlopen
    from urllib.error import HTTPError

import netaddr

IPRANGE_URLS = {
    "goog": "https://www.gstatic.com/ipranges/goog.json",
    "cloud": "https://www.gstatic.com/ipranges/cloud.json",
}

def read_url(url):
    try:
        return json.loads(urlopen(url).read())
    except (IOError, HTTPError):
        print("ERROR: Invalid HTTP response from %s" % url)
    except json.decoder.JSONDecodeError:
        print("ERROR: Could not parse HTTP response from %s" % url)

def get_data(link):
    data = read_url(link)
    if data:
        print("{} published: {}".format(link, data.get("creationTime")))
        cidrs = netaddr.IPSet()
        for e in data["prefixes"]:
            if "ipv4Prefix" in e:
                cidrs.add(e.get("ipv4Prefix"))
            if "ipv6Prefix" in e:
                cidrs.add(e.get("ipv6Prefix"))
        return cidrs

def main():
    cidrs = {group: get_data(link) for group, link in IPRANGE_URLS.items()}
    if len(cidrs) != 2:
        raise ValueError("ERROR: Could process data from Google")
    print("IP ranges for Google APIs and services default domains:")
    for ip in (cidrs["goog"] - cidrs["cloud"]).iter_cidrs():
        print(ip)

if __name__ == "__main__":
    main()

Configuración del Acceso privado a Google

Puedes habilitar el Acceso privado a Google después de cumplir con los requisitos de red en tu red de VPC.

Habilita el Acceso privado a Google

Sigue estos pasos para habilitar el acceso privado a Google:

Console

  1. Ve a la página Redes de VPC en Google Cloud Console.
    Ir a la página Redes de VPC
  2. Haz clic en el nombre de la red que contiene la subred en la que necesitas habilitar el Acceso privado a Google.
  3. Para una subred existente, sigue estos pasos:
    1. Haz clic en el nombre de la subred. Se mostrará la página Detalles de la subred.
    2. Haz clic en Editar.
    3. En la sección Acceso privado a Google selecciona Habilitar.
    4. Haz clic en Guardar.
  4. Para una subred nueva:

    1. Haz clic en Agregar subred.
    2. Ingresa un Nombre.
    3. Selecciona una Región.
    4. En Tipo de pila IP, selecciona Solo IPv4 (pila única) o IPv4 y IPv6 (pila doble).
    5. Ingresa un rango de IPv4. Este es el rango de IPv4 principal de la subred.

      Si seleccionas un rango que no es una dirección RFC 1918, confirma que el rango no entre en conflicto con una configuración existente. Para obtener más información, consulta Rangos de subredes IPv4.

    6. Si creas una subred de doble pila, selecciona un tipo de acceso IPv6: Interno o Externo.

      Si deseas establecer el tipo de acceso como Interno, pero la opción Interno no está disponible, comprueba que se haya asignado un rango de IPv6 interno en la red.

    7. Realiza otras selecciones en la subred nueva para satisfacer tus necesidades. Por ejemplo, es posible que debas crear rangos de IP de subredes secundarios o habilitar los registros de flujo de VPC.

    8. Selecciona Habilitar en la sección Acceso privado a Google.

    9. Haz clic en Agregar.

gcloud

Para una subred existente:

  1. Determina el nombre y la región de la subred. Para ver una lista de las subredes de una red en particular, usa el siguiente comando:

    gcloud compute networks subnets list --filter=NETWORK_NAME
    
  2. Ejecuta el siguiente comando para habilitar el Acceso privado a Google:

    gcloud compute networks subnets update SUBNET_NAME \
    --region=REGION \
    --enable-private-ip-google-access
    
  3. Verifica que el Acceso privado a Google esté habilitado mediante la ejecución del siguiente comando:

    gcloud compute networks subnets describe SUBNET_NAME \
    --region=REGION \
    --format="get(privateIpGoogleAccess)"
    

En todos los comandos anteriores, reemplaza los siguientes por valores válidos:

  • SUBNET_NAME: El nombre de la subred
  • REGION: La región de la subred
  • NETWORK_NAME: El nombre de la red de VPC que contiene la subred

Cuando crees una subred nueva, usa la marca --enable-private-ip-google-access para habilitar el Acceso privado a Google:

gcloud compute networks subnets create SUBNET_NAME \
    --region=REGION \
    --network=NETWORK_NAME \
    --range=PRIMARY_IP_RANGE \
    [ --stack-type=STACK_TYPE ] \
    [ --ipv6-access-type=IPv6_ACCESS_TYPE ] \
    --enable-private-ip-google-access

Reemplaza los siguientes elementos por valores válidos:

  • SUBNET_NAME: El nombre de la subred
  • REGION: La región de la subred
  • NETWORK_NAME: El nombre de la red de VPC que contiene la subred
  • PRIMARY_IP_RANGE: El rango de direcciones IP principal de la subred
  • STACK_TYPE es el tipo de pila para la subred: IPV4_ONLY o IPV4_IPV6.
  • IPv6_ACCESS_TYPE es el tipo de acceso IPv6: EXTERNAL o INTERNAL. Especifica el tipo de acceso IPv6 solo si también especificaste --stack-type=IPV4_IPV6.

Inhabilita el Acceso privado a Google

Sigue estos pasos para inhabilitar el acceso privado a Google en una subred existente:

Console

  1. Ve a la página Redes de VPC en Google Cloud Console.
    Ir a la página Redes de VPC
  2. Haz clic en el nombre de la red que contiene la subred en la que necesitas inhabilitar el Acceso privado a Google.
  3. Haz clic en el nombre de una subred existente. Se mostrará la página Detalles de la subred.
  4. Haz clic en Editar.
  5. En la sección Acceso privado a Google selecciona Inhabilitar.
  6. Haz clic en Guardar.

gcloud

  1. Determina el nombre y la región de la subred. Para ver una lista de las subredes de una red en particular, usa el siguiente comando:

    gcloud compute networks subnets list \
        --filter=NETWORK_NAME
    
  2. Ejecuta el siguiente comando para inhabilitar el Acceso privado a Google:

    gcloud compute networks subnets update SUBNET_NAME \
        --region=REGION \
        --no-enable-private-ip-google-access
    
  3. Ejecuta el siguiente comando para verificar que el Acceso privado a Google esté inhabilitado:

    gcloud compute networks subnets describe SUBNET_NAME \
        --region=REGION \
        --format="get(privateIpGoogleAccess)"
    

En todos los comandos anteriores, reemplaza los siguientes por valores válidos:

  • SUBNET_NAME: El nombre de la subred
  • REGION: La región de la subred
  • NETWORK_NAME: El nombre de la red de VPC que contiene la subred

Próximos pasos