Configura la connettività privata alle API e ai servizi Google

Questo documento descrive come configurare la connettività privata dagli host di una rete VPC o on-premise alle API e ai servizi Google supportati dai Controlli di servizio VPC.

Prima di leggere questo documento, ti consigliamo di acquisire familiarità con i concetti di base, le specifiche e la configurazione di rete relativi all'accesso privato Google. Consulta i diagrammi di topologia di esempio sull'utilizzo dell'accesso privato Google con i Controlli di servizio VPC.

Prima di iniziare

• Abilita le API a cui vuoi accedere tramite la pagina API e servizi nella console Google Cloud.
• Assicurati di disporre del ruolo richiesto per creare o aggiornare le subnet. I proprietari, gli editor e le entità IAM del progetto con il ruolo Amministratore rete possono creare o aggiornare le subnet e assegnare indirizzi IP. Per ulteriori informazioni sui ruoli, consulta la documentazione relativa ai ruoli IAM.
• Verifica che sia configurata una rete VPC per l'accesso privato Google e l'accesso privato Google per gli host on-premise. Sono supportate sia le reti VPC in modalità automatica sia quelle in modalità personalizzata. Le reti legacy non sono supportate.
• Assicurati che le istanze VM in una rete VPC abbiano un indirizzo IP privato (nessun indirizzo IP pubblico) e si trovino in una subnet con l'accesso privato Google abilitato.
• Per gli host on-premise, assicurati di disporre di un tunnel Cloud VPN o di una connessione Cloud Interconnect esistente alla tua rete VPC. Per supportare gli host on-premise che hanno indirizzi IPv6, consulta il supporto IPv6.

Panoramica della procedura

Per configurare la connettività privata, completa le seguenti attività:

• Configura route per gli intervalli di indirizzi IP restricted.googleapis.com. Per ulteriori informazioni, consulta Configurare le route.
• Configura le regole del firewall per consentire al traffico appropriato di raggiungere gli intervalli di indirizzi IP restricted.googleapis.com. Per maggiori informazioni, consulta Configurare le regole firewall.
• Configura il DNS in modo che il traffico verso le API di Google venga risolto negli intervalli di indirizzi IP restricted.googleapis.com. Per ulteriori informazioni, consulta la sezione Configurare il DNS.

Supporto IPv6 per restricted.googleapis.com

Puoi accedere alle API di Google utilizzando l'intervallo di indirizzi IPv6 per il dominio restricted.googleapis.com: 2600:2d00:0002:1000::/64.

Valuta la possibilità di configurare gli indirizzi IPv6 se vuoi utilizzare il dominio restricted.googleapis.com e hai client che utilizzano indirizzi IPv6. I client IPv6 che hanno anche indirizzi IPv4 configurati possono raggiungere le API e i servizi Google utilizzando gli indirizzi IPv4. Non tutti i servizi accettano traffico dai client IPv6.

Per consentire ai client IPv6 nel tuo ambiente on-premise di accedere alle API di Google utilizzando restricted.googleapis.com, devi configurare la connessione alla rete VPC in modo da supportare IPv6. Per ulteriori informazioni, consulta le seguenti pagine:

• Supporto IPv6 per VPN ad alta disponibilità
• Supporto IPv6 per il router Cloud

I client on-premise possono inviare richieste da qualsiasi indirizzo IPv6 GUA o ULA, ad eccezione dell'intervallo ULA fda3:e722:ac3:cc00::/64, che è riservato per uso interno.

Per ulteriori informazioni sul VIP restricted.googleapis.com, consulta Configurare l'accesso privato Google.

Connettività diretta ad API e servizi

Alcune API e alcuni servizi Google offrono connettività diretta dalle istanze di macchine virtuali (VM) Compute Engine, bypassando i Google Front End (GFE). Per consentire questo traffico, devi assicurarti che le route e le regole firewall consentano al traffico in uscita di raggiungere 34.126.0.0/18 e 2001:4860:8040::/42. Non è necessario creare record DNS per questi indirizzi.

La connettività diretta è supportata solo dalle risorse Google Cloud. Non puoi utilizzare la connettività diretta dagli host on-premise.

I servizi che offrono connettività diretta supportano i Controlli di servizio VPC.

Configura route per restricted.googleapis.com

Sebbene i Controlli di servizio VPC vengano applicati per i servizi compatibili e configurati, indipendentemente dal dominio utilizzato, restricted.googleapis.com offre un'ulteriore mitigazione del rischio per l'esfiltrazione di dati. restricted.googleapis.com nega l'accesso alle API e ai servizi Google non supportati dai Controlli di servizio VPC.

Sia per l'accesso privato Google sia per l'accesso privato Google per gli host on-premise, la rete VPC deve includere una route per gli intervalli di indirizzi IP restricted.googleapis.com il cui hop successivo è il gateway internet predefinito. Anche se l'hop successivo è un gateway internet predefinito, il traffico inviato a restricted.googleapis.com rimane all'interno della rete Google.

Se la tua rete VPC non dispone di una route predefinita il cui hop successivo è il gateway internet predefinito, puoi creare una route statica personalizzata la cui destinazione corrisponde all'intervallo di indirizzi IP restricted.googleapis.com e il cui hop successivo è il gateway internet predefinito. Per impedire l'accesso a internet, devi rimuovere le altre route il cui hop successivo è il gateway internet predefinito.

Per ulteriori informazioni sull'utilizzo delle route VPC, consulta Utilizzo delle route nella documentazione dei VPC.

Configura route statiche personalizzate in una rete VPC

Aggiungi route statiche personalizzate per abilitare l'accesso ai servizi gestiti da Google supportati dai Controlli di servizio VPC.

gcloud compute routes create ROUTE_NAME \
  --network=NETWORK_NAME \
  --destination-range=DESTINATION_RANGE \
  --next-hop-gateway=default-internet-gateway

Sostituisci quanto segue:

• ROUTE_NAME: un nome per la route personalizzata
• NETWORK_NAME: il nome della tua rete VPC
• DESTINATION_RANGE: l'intervallo di destinazione per la route
  • Per instradare il traffico al VIP restricted.googleapis.com, utilizza gli intervalli seguenti:
    • Per il traffico IPv4: 199.36.153.4/30
    • Per il traffico IPv6: 2600:2d00:0002:1000::/64
  • Per instradare il traffico alle API che consentono la connettività diretta, utilizza i seguenti intervalli:
    • Per il traffico IPv4: 34.126.0.0/18
    • Per il traffico IPv6: 2001:4860:8040::/42

Annuncia la route limitata agli host in una rete on-premise

Se utilizzi l'accesso privato Google per gli host on-premise, configura le route in modo che il traffico dell'API di Google venga inoltrato tramite la tua connessione Cloud VPN o Cloud Interconnect. Per annunciare gli intervalli di indirizzi VIP limitati alla tua rete on-premise, utilizza gli annunci di route personalizzati sul router Cloud. Gli intervalli di indirizzi VIP limitati sono accessibili solo agli host on-premise che possono raggiungere la tua rete VPC tramite indirizzi IP privati.

Nota: se hai più tunnel o interconnessioni, non puoi creare route asimmetriche tra regioni che rimandano alla rete on-premise. Google Cloud non li supporta.

Puoi aggiungere questo annuncio di route personalizzata a un router Cloud (per tutte le sessioni BGP sul router) o a una sessione BGP selezionata (per un singolo tunnel Cloud VPN o collegamento VLAN).

Le route IPv6 sono annunciate solo nelle sessioni BGP in cui è abilitato IPv6.

Per creare un annuncio di route personalizzata per l'intervallo limitato per tutte le sessioni BGP su un router Cloud esistente, segui questi passaggi:

Console

1. Nella console Google Cloud, vai alla pagina Router Cloud.

   Vai ai router Cloud

2. Seleziona il router Cloud da aggiornare.

3. Nella pagina dei dettagli del router Cloud, seleziona Modifica.

4. Espandi la sezione Route annunciate.

5. Per Route, seleziona Crea route personalizzate.

6. Per continuare a pubblicizzare le subnet disponibili per il router Cloud, seleziona Pubblicizza tutte le subnet visibili al router Cloud. L'attivazione di questa opzione riproduce il comportamento predefinito del router Cloud.

7. Per aggiungere una route pubblicizzata, seleziona Aggiungi route personalizzata .

8. Configurare la annuncio di route.

   • Origine: seleziona Intervallo IP personalizzato.
   • Intervallo di indirizzi IP:
     • Per la connettività IPv4: 199.36.153.4/30
     • Per la connettività IPv6: 2600:2d00:0002:1000::/64
   • Descrizione: aggiungi una descrizione di Restricted Google APIs IPs.

9. Dopo aver aggiunto i percorsi, seleziona Salva.

gcloud

Esegui il comando update, utilizzando il flag --set-advertisement-ranges o --add-advertisement-ranges per specificare gli intervalli IP personalizzati:

• Per impostare intervalli IP personalizzati, utilizza il flag --set-advertisement-ranges. Vengono sostituiti eventuali annunci personalizzati esistenti. L'esempio seguente aggiorna il router Cloud my-router per pubblicizzare tutte le subnet e gli intervalli di indirizzi IP restricted.googleapis.com.

  gcloud compute routers update my-router \
      --advertisement-mode CUSTOM \
      --set-advertisement-groups ALL_SUBNETS \
      --set-advertisement-ranges RANGES
  

  Sostituisci RANGES con gli intervalli che vuoi utilizzare:

  • Per la connettività IPv4: 199.36.153.4/30
  • Per la connettività IPv6: 2600:2d00:0002:1000::/64
  • Per la connettività IPv4 e IPv6: 199.36.153.4/30,2600:2d00:0002:1000::/64

• Per aggiungere intervalli IP personalizzati a un annuncio esistente, utilizza il flag --add-advertisement-ranges. Tieni presente che questo flag richiede che la modalità pubblicitaria del router Cloud sia già impostata su custom. Nell'esempio seguente vengono aggiunti gli intervalli di indirizzi IP restricted.googleapis.com agli annunci del router Cloud:

  gcloud compute routers update my-router \
      --add-advertisement-ranges RANGES
  

  Sostituisci RANGES con gli intervalli che vuoi utilizzare:

  • Per la connettività IPv4: 199.36.153.4/30
  • Per la connettività IPv6: 2600:2d00:0002:1000::/64
  • Per la connettività IPv4 e IPv6: 199.36.153.4/30,2600:2d00:0002:1000::/64

Per creare un annuncio di route personalizzata per l'intervallo limitato su una sessione BGP specifica di un router Cloud esistente, segui questi passaggi:

Console

1. Nella console Google Cloud, vai alla pagina Router Cloud.

   Vai ai router Cloud

2. Seleziona il router Cloud che contiene la sessione BGP da aggiornare.

3. Nella pagina dei dettagli del router Cloud, seleziona la sessione BGP da aggiornare.

4. Nella pagina Dettagli sessione BGP, seleziona Modifica.

5. Per Route, seleziona Crea route personalizzate.

6. Seleziona Pubblicizza tutte le subnet visibili al router Cloud per continuare a pubblicizzare le subnet disponibili per il router Cloud. L'attivazione di questa opzione riproduce il comportamento predefinito del router Cloud.

7. Seleziona Aggiungi route personalizzata per aggiungere un percorso pubblicizzato.

8. Configurare la annuncio di route.

   • Origine: seleziona Intervallo IP personalizzato per specificare un intervallo IP personalizzato.
   • Intervallo di indirizzi IP:
     • Per la connettività IPv4: 199.36.153.4/30
     • Per la connettività IPv6: 2600:2d00:0002:1000::/64
   • Descrizione: aggiungi una descrizione di Restricted Google APIs IPs.

9. Dopo aver aggiunto le route, seleziona Salva.

gcloud

Esegui il comando update-bgp-peer utilizzando il flag --set-advertisement-ranges o --add-advertisement-ranges per specificare gli intervalli IP personalizzati.

• Per impostare intervalli IP personalizzati, utilizza il flag --set-advertisement-ranges. Vengono sostituiti eventuali annunci personalizzati esistenti.

  Se aggiungi intervalli personalizzati IPv6 e se il traffico IPv6 è disabilitato per la sessione BGP, puoi abilitarlo con il flag --enable-ipv6.

  L'esempio seguente aggiorna la sessione BGP my-bgp-session sul router Cloud my-router per pubblicizzare tutte le subnet e l'intervallo IP personalizzato:

  gcloud compute routers update-bgp-peer my-router \
      --peer-name my-bgp-session \
      --advertisement-mode CUSTOM \
      --set-advertisement-groups ALL_SUBNETS \
      --set-advertisement-ranges RANGES
  

  Sostituisci RANGES con gli intervalli che vuoi utilizzare:

  • Per la connettività IPv4: 199.36.153.4/30
  • Per la connettività IPv6: 2600:2d00:0002:1000::/64
  • Per la connettività IPv4 e IPv6: 199.36.153.4/30,2600:2d00:0002:1000::/64

• Per aggiungere intervalli IP personalizzati a quelli esistenti, utilizza il flag --add-advertisement-ranges. Tieni presente che questo flag richiede che la modalità pubblicitaria del router Cloud sia già impostata su custom.

  Se aggiungi intervalli personalizzati IPv6 e se il traffico IPv6 è disabilitato per la sessione BGP, puoi abilitarlo con il flag --enable-ipv6.

  Nell'esempio seguente, gli intervalli di indirizzi VIP limitati vengono aggiunti agli annunci del router Cloud:

  gcloud compute routers update-bgp-peer my-router \
      --peer-name my-bgp-session \
      --add-advertisement-ranges RANGES
  

  Sostituisci RANGES con gli intervalli che vuoi utilizzare:

  • Per la connettività IPv4: 199.36.153.4/30
  • Per la connettività IPv6: 2600:2d00:0002:1000::/64
  • Per la connettività IPv4 e IPv6: 199.36.153.4/30,2600:2d00:0002:1000::/64

  Per ulteriori informazioni sugli annunci personalizzati, consulta la pagina relativa agli annunci personalizzati per i router.

Configura le regole firewall

Per l'accesso privato Google, le istanze VM utilizzano indirizzi IP interni e non richiedono indirizzi IP esterni per raggiungere risorse dell'API di Google protette. Tuttavia, è possibile che le istanze VM possiedano indirizzi IP esterni o soddisfino in altro modo i requisiti per l'accesso a internet. Oltre alle route personalizzate, puoi limitare il traffico in uscita dalle istanze VM nella tua rete VPC creando regole firewall per negare il traffico in uscita.

Per impostazione predefinita, la regola firewall di autorizzazione in uscita implicita consente alle istanze VM di inviare traffico a qualsiasi destinazione se esiste una route applicabile. Puoi prima creare una regola di negazione in uscita per bloccare tutto il traffico in uscita. Puoi quindi creare regole in uscita a priorità più elevata che consentono il traffico verso destinazioni selezionate nella rete VPC e negli intervalli di indirizzi IP restricted.googleapis.com. Tutte le comunicazioni con restricted.googleapis.com avvengono sulla porta TCP 443.

Per consentire al traffico da Google Cloud di raggiungere i VIP restricted.googleapis.com, aggiungi regole firewall per le seguenti destinazioni:

• Per il traffico IPv4: 199.36.153.4/30
• Per il traffico IPv6: 2600:2d00:0002:1000::/64

Per consentire al traffico da Google Cloud di raggiungere API e servizi che consentono la connettività diretta, aggiungi regole firewall per le seguenti destinazioni:

• Per il traffico IPv4: 34.126.0.0/18
• Per il traffico IPv6: 2001:4860:8040::/42

Nota: prima di bloccare l'accesso a internet, valuta attentamente l'impatto sulle tue istanze VM. Il blocco dell'accesso a internet può ridurre il rischio di esfiltrazione di dati, ma può anche bloccare il traffico legittimo, compreso il traffico essenziale per gli aggiornamenti del software. Senza accesso a internet, puoi accedere alle istanze VM solo tramite una rete on-premise connessa tramite un tunnel Cloud VPN o una connessione Cloud Interconnect. Dopo aver bloccato l'accesso a internet, le istanze VM non possono chiamare API e servizi di terze parti.

Per ulteriori informazioni sull'utilizzo delle regole firewall VPC, consulta Utilizzo delle regole firewall VPC nella documentazione del firewall Cloud Next Generation.

Configura le regole firewall on-premise per consentire al traffico dai tuoi host on-premise di raggiungere gli intervalli di indirizzi IP restricted.googleapis.com.

• Per il traffico IPv4: 199.36.153.4/30
• Per il traffico IPv6: 2600:2d00:0002:1000::/64

La connettività diretta alle API e ai servizi Google non è supportata dalle reti on-premise.

Configura DNS

Puoi utilizzare le zone private gestite per le tue reti VPC. Le zone DNS private di Cloud DNS consentono di ospitare una zona DNS accessibile dalle reti VPC autorizzate. Per configurare l'inoltro da determinati server dei nomi on-premise, puoi utilizzare gli intervalli di indirizzi IP restricted.googleapis.com. Puoi quindi creare una zona privata per googleapis.com con un record A DNS che mappa restricted.googleapis.com e i record CNAME appropriati per ogni nome *.googleapis.com. Per ulteriori informazioni, consulta Gestione delle zone.

Per l'accesso on-premise, puoi configurare un criterio di forwarding in entrata di Cloud DNS per abilitare i server dei nomi on-premise a eseguire query su una zona privata gestita di Cloud DNS. Puoi anche configurare un server dei nomi on-premise, ad esempio uno utilizzando BIND:

Nota: ti consigliamo di utilizzare BIND solo per le implementazioni on-premise.

Configura il DNS con Cloud DNS

Utilizza Cloud DNS per abilitare la risoluzione DNS per le istanze VM nella tua rete VPC, per gli host in una rete on-premise o per entrambe. Se utilizzi il VPC condiviso, consulta Zone private e VPC condiviso nella documentazione di Cloud DNS. Inoltre, se utilizzi un VPC condiviso, assicurati che il progetto host di rete VPC condiviso sia incluso nello stesso perimetro di servizio dei progetti che si connettono alla rete.

Configura Cloud DNS utilizzando le zone private

Puoi utilizzare le zone private per configurare Cloud DNS:

1. Crea una zona privata gestita per la tua rete VPC.

   gcloud dns managed-zones create ZONE_NAME \
    --visibility=private \
    --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME \
    --description=DESCRIPTION \
    --dns-name=googleapis.com
   

   Sostituisci quanto segue:

   • ZONE_NAME: un nome per la zona che stai creando. Ad esempio, vpc. Questo nome verrà utilizzato in ciascuno dei passaggi seguenti.
   • PROJECT_ID: l'ID del progetto che ospita la rete VPC.
   • NETWORK_NAME: il nome della tua rete VPC.
   • DESCRIPTION: una descrizione facoltativa e leggibile della zona gestita.

2. Avvia una transazione.

   gcloud dns record-sets transaction start --zone=ZONE_NAME
   

   Sostituisci ZONE_NAME con il nome della zona che hai creato nel primo passaggio.

3. Aggiungi i record DNS.

   gcloud dns record-sets transaction add --name=*.googleapis.com. \
       --type=CNAME restricted.googleapis.com. \
       --zone=ZONE_NAME \
       --ttl=300
   

   Sostituisci ZONE_NAME con il nome della zona che hai creato nel primo passaggio.

   gcloud dns record-sets transaction add --name=restricted.googleapis.com. \
       --type=A 199.36.153.4, 199.36.153.5, 199.36.153.6, 199.36.153.7 \
       --zone=ZONE_NAME \
       --ttl=300
   

   Sostituisci ZONE_NAME con il nome della zona che hai creato nel primo passaggio.

   Se stai configurando gli indirizzi IPv6 per restricted.googleapis.com, crea anche il seguente set di record:

   gcloud dns record-sets transaction add --name=restricted.googleapis.com. \
       --type=AAAA 2600:2d00:0002:1000:: \
       --zone=ZONE_NAME \
       --ttl=300
   

4. Esegui la transazione.

   gcloud dns record-sets transaction execute --zone=ZONE_NAME
   

   Sostituisci ZONE_NAME con il nome della zona che hai creato nel primo passaggio.

5. Facoltativo. Per abilitare gli host on-premise a raggiungere il VIP con restrizioni, completa questi passaggi:

   1. Creare un criterio DNS e abilitare l'inoltro DNS in entrata per rendere i servizi di risoluzione dei nomi della rete VPC disponibili esternamente ai sistemi

      gcloud dns policies create POLICY_NAME \
       --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME \
       --enable-inbound-forwarding \
       --description=DESCRIPTION
      

      Sostituisci quanto segue:

      • POLICY_NAME: un nome per il criterio che stai creando. Ad esempio, apipolicy.
      • PROJECT_ID: l'ID del progetto che ospita la rete VPC.
      • NETWORK_NAME: il nome della rete VPC.
      • DESCRIPTION: una descrizione facoltativa e leggibile della zona gestita.

   2. Nella rete on-premise, punta il DNS on-premise verso l'indirizzo IP del server di inoltro di Cloud DNS. Per trovare l'indirizzo IP dell'inoltro, utilizza il comando compute addresses list:

      gcloud compute addresses list --filter='name ~ ^dns-forwarding.*' \
       --format='csv[no-heading](address, subnetwork)'
      

      Nota: la tua rete VPC ha un indirizzo IP del forwarding solo se hai configurato un criterio di forwarding DNS in entrata. Per ulteriori informazioni sui criteri DNS, consulta Panoramica dei criteri del server Cloud DNS e Creazione di un criterio del server in entrata.

Configura DNS con BIND

Se utilizzi BIND per la risoluzione DNS, puoi configurarlo per risolvere le richieste dell'API di Google alle API di Google limitate. Utilizza la seguente configurazione BIND di esempio, che utilizza le zone dei criteri di risposta (RPZ) per ottenere questo comportamento:

1. Aggiungi le seguenti righe a /etc/bind/named.conf:

   include "/etc/bind/named.conf.options";
   include "/etc/bind/named.conf.local";
   

2. Aggiungi le seguenti righe a /etc/bind/named.conf.options:

   options {
     directory "/var/cache/bind";
   
     dnssec-validation no;
   
     auth-nxdomain no;    # conform to RFC 1035
     listen-on-v6 { any; };
     listen-on { any; };
     response-policy { zone "googleapis.zone"; };
     allow-query { any;};
   };
   

3. Aggiungi le seguenti righe a /etc/bind/named.conf.local:

   include "/etc/bind/named.conf.default-zones";
   
   
   zone "googleapis.zone" {
     type master;
     file "/etc/bind/db.googleapis.zone";
     allow-query {none;};
   };
   

4. Aggiungi le seguenti righe a /etc/bind/db.googleapis.zone:

   $TTL 1H
   @                       SOA LOCALHOST. noreply.localhost(1 1h 15m 30d 2h)
                           NS  LOCALHOST.
   
   
   *.googleapis.com CNAME restricted.googleapis.com.
   restricted.googleapis.com CNAME rpz-passthru.
   

Configurare il DNS in casi speciali

Quando devi configurare il DNS in casi speciali, tieni presente quanto segue:

• BIND personalizzato non è supportato quando si utilizza Dataflow. Per personalizzare la risoluzione DNS quando utilizzi Dataflow con i Controlli di servizio VPC, usa le zone private di Cloud DNS anziché i server BIND personalizzati. Per utilizzare la tua risoluzione DNS on-premise, valuta l'utilizzo di un metodo di inoltro DNS di Google Cloud.

• Potresti dover configurare il DNS per gcr.io anche se, ad esempio, utilizzi Google Kubernetes Engine (GKE). Per ulteriori informazioni, consulta Configurare Container Registry per i cluster privati GKE.