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 la dirección IP interna principal de la interfaz de VM o con una dirección IP interna de un rango de IP de alias.
Una VM con una dirección IP 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.
Requisitos de red
El Acceso privado a Google tiene los siguientes 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. Consulta Configuración de red para obtener información.
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.
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 18.104.22.168/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:


Usa Elige


restricted.googleapis.com 22.214.171.124/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 Elige |
Configuración de DNS
Si eliges private.googleapis.com
o restricted.googleapis.com
, debes configurar el DNS de modo que las VM de la red de VPC resuelvan las solicitudes a *.googleapis.com
.
En las siguientes instrucciones, se crean zonas de DNS privado para googleapis.com
y cualquier otro dominio al que necesites acceder, por ejemplo, gcr.io
.
- Crea una zona de DNS privada para
googleapis.com
. Se recomienda crear una zona privada de Cloud DNS para este propósito. En la zona
googleapis.com
, crea uno de los siguientes registrosA
, según el dominio elegido:- Un registro
A
paraprivate.googleapis.com
que apunte a las siguientes direcciones IP:126.96.36.199
,188.8.131.52
,184.108.40.206
y220.127.116.11
- Un registro
A
pararestricted.googleapis.com
que apunte a las siguientes direcciones IP:18.104.22.168
,22.214.171.124
,126.96.36.199
y188.8.131.52
Si usas Cloud DNS, agrega los registros a la zona privada
googleapis.com
.- Un registro
En la zona
googleapis.com
, crea un registroCNAME
para*.googleapis.com
que apunte a cualquier registroA
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.dev
y pki.goog
. Consulta la tabla de rangos de direcciones IP y dominios en Requisitos de red 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:
- 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 privadagoogleapis.com
. - 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 registroA
apunte a las mismas cuatro direcciones IP para el nombre de dominio personalizado que elegiste (private.googleapis.com
orestricted.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 registroCNAME
apunte al registroA
en la misma zona. Por ejemplo, haz que*.gcr.io
apunte haciagcr.io
.
- Crea un registro
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
orestricted.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 en cualquier dominio, sin necesidad de crear rutas personalizadas. Consulta Enrutamiento con una ruta predeterminada para obtener más detalles.
Si reemplazaste la ruta predeterminada por una ruta estática personalizada que tiene el destino 0.0.0.0/0
y un siguiente salto que no es la puerta de enlace de Internet predeterminada, puedes cumplir con los requisitos de enrutamiento para las API y los servicios de Google mediante el enrutamiento personalizado. Se recomienda usar el enrutamiento personalizado en estos casos:
- Si tienes una ruta estática personalizada cuyo destino es
0.0.0.0/0
y el siguiente salto es un túnel de Cloud VPN, un balanceador de cargas de TCP/UDP interno o cualquier otra instancia de VM. - Si usas Cloud Router para aceptar una ruta dinámica personalizada con un destino
0.0.0.0/0
.
Enrutamiento con una ruta predeterminada
Cada red de VPC contiene una ruta predeterminada cuando se crea.
El siguiente salto de esta ruta es la puerta de enlace de Internet predeterminada y proporciona una ruta de acceso a los dominios predeterminados, private.googleapis.com
y restricted.googleapis.com
.
Para verificar la configuración de una ruta predeterminada en una red determinada, sigue estas instrucciones.
Console
- Ve a la página Rutas en Google Cloud Console.
Ir a la página Rutas - Filtra la lista de rutas para ver solo las rutas de la red que debes inspeccionar.
- Busca una ruta cuyo destino sea
0.0.0.0/0
y cuyo salto siguiente 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 de reemplazo predeterminada, consulta Agrega una ruta estática.
Enrutamiento personalizado
Como alternativa a una ruta predeterminada, 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
- Ve a la página Rutas en Google Cloud Console.
Ir a la página Rutas - 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
- Red:
- 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
orestricted.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
). 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 de cada rango de direcciones IP que usa el dominio elegido para las API y los servicios de Google.
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.
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 macOS, esta secuencia de comandos requiere un entorno de ejecución de Python 3 configurado de la siguiente manera:
- Instala el entorno de ejecución de Python 3 en la versión actual para macOS.
- Ejecuta el
Install Certificates.command
incluido desde la carpeta de Python en tu carpeta de aplicaciones para instalar una lista de certificados raíz de confianza (cert.pem
) que usarás en el entorno de ejecución de Python. ReemplazaVERSION
por la versión de Python que instalaste (como3.8
):sudo "/Applications/Python
VERSION
/Install Certificates.command" - Para instalar el módulo
netaddr
, ejecuta el siguiente comando:sudo pip3 install netaddr
#!/usr/bin/env python3 import json import netaddr import urllib.request goog_url="https://www.gstatic.com/ipranges/goog.json" cloud_url="https://www.gstatic.com/ipranges/cloud.json" def read_url(url): try: s = urllib.request.urlopen(url).read() return json.loads(s) except urllib.error.HTTPError: print("Invalid HTTP response from %s" % url) return {} except json.decoder.JSONDecodeError: print("Could not parse HTTP response from %s" % url) return {} def main(): goog_json=read_url(goog_url) cloud_json=read_url(cloud_url) if goog_json and cloud_json: print("{} published: {}".format(goog_url,goog_json.get('creationTime'))) print("{} published: {}".format(cloud_url,cloud_json.get('creationTime'))) goog_cidrs = netaddr.IPSet() for e in goog_json['prefixes']: if e.get('ipv4Prefix'): goog_cidrs.add(e.get('ipv4Prefix')) cloud_cidrs = netaddr.IPSet() for e in cloud_json['prefixes']: if e.get('ipv4Prefix'): cloud_cidrs.add(e.get('ipv4Prefix')) print("IP ranges for Google APIs and services default domains:") for i in goog_cidrs.difference(cloud_cidrs).iter_cidrs(): print(i) 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
- Ve a la página de Redes de VPC en Google Cloud Console.
Ir a la página Redes de VPC - Haz clic en el nombre de la red que contiene la subred en la que necesitas habilitar el Acceso privado a Google.
- Para una subred existente, sigue estos pasos:
- Haz clic en el nombre de la subred. Se mostrará la página Detalles de la subred.
- Haz clic en Editar.
- En la sección Acceso privado a Google selecciona Habilitar.
- Haz clic en Guardar.
- Para una subred nueva, haz lo siguiente:
- Haz clic en Agregar subred.
- Especifica el Nombre y la Región de la subred nueva.
- Especifica el Rango de direcciones IP de la subred. Este rango no puede superponerse con ninguna subred de la red de VPC actual ni con ninguna red conectada mediante intercambio de tráfico entre redes de VPC o VPN.
- 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.
- Selecciona Habilitar en la sección Acceso privado a Google.
- Haz clic en Agregar.
gcloud
Para una subred existente:
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
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
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 subredREGION
: La región de la subredNETWORK_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 \ --enable-private-ip-google-access
Reemplaza los siguientes elementos por valores válidos:
SUBNET_NAME
: El nombre de la subredREGION
: La región de la subredNETWORK_NAME
: El nombre de la red de VPC que contiene la subredPRIMARY_IP_RANGE
: El rango de direcciones IP principal de la subred
Inhabilita el Acceso privado a Google
Sigue estos pasos para inhabilitar el acceso privado a Google en una subred existente:
Console
- Ve a la página de Redes de VPC en Google Cloud Console.
Ir a la página Redes de VPC - Haz clic en el nombre de la red que contiene la subred en la que necesitas inhabilitar el Acceso privado a Google.
- Haz clic en el nombre de una subred existente. Se mostrará la página Detalles de la subred.
- Haz clic en Editar.
- En la sección Acceso privado a Google selecciona Inhabilitar.
- Haz clic en Guardar.
gcloud
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
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
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 subredREGION
: La región de la subredNETWORK_NAME
: El nombre de la red de VPC que contiene la subred
Próximos pasos
- Si deseas configurar el Acceso privado a Google en hosts locales, consulta Configura el Acceso privado a Google para hosts locales.