Configurer une connectivité privée aux API et services Google

Ce document explique comment configurer une connectivité privée entre les hôtes d'un réseau VPC ou d'un réseau sur site et les API et services Google compatibles avec VPC Service Controls.

Avant de lire ce document, nous vous recommandons de vous familiariser avec les concepts d'Accès privé à Google, les spécifications et la configuration du réseau. Consultez des exemples de schémas de topologie pour l'utilisation de l'accès privé à Google avec VPC Service Controls.

Avant de commencer

• Vous devez activer les API auxquelles vous souhaitez accéder via la page API et services de Google Cloud Console.
• Assurez-vous de disposer du rôle requis pour créer ou mettre à jour des sous-réseaux. Les propriétaires de projet, les collaborateurs et les entités principales IAM dotées du rôle d'administrateur réseau peuvent créer ou mettre à jour des sous-réseaux et attribuer des adresses IP. Pour en savoir plus sur les rôles, consultez la documentation sur les rôles IAM.
• Vérifiez qu'un réseau VPC est configuré pour l'accès privé à Google et l'accès privé à Google pour les hôtes sur site. Les réseaux VPC en mode automatique et en mode personnalisé sont tous les deux compatibles. Les anciens réseaux ne sont pas compatibles.
• Assurez-vous que les instances de VM d'un réseau VPC disposent d'une adresse IP privée (et non d'une adresse IP publique) et qu'elles se trouvent dans un sous-réseau sur lequel l'accès privé à Google est activé.
• Pour les hôtes sur site, assurez-vous de disposer d'un tunnel Cloud VPN existant ou d'une connexion Cloud Interconnect sur votre réseau VPC. Pour prendre en charge les hôtes sur site disposant d'adresses IPv6, consultez la section Compatibilité IPv6.

Présentation de la procédure

Pour configurer la connectivité privée, procédez comme suit :

• Configurez des routes pour les plages d'adresses IP restricted.googleapis.com. Pour en savoir plus, consultez la section Configurer des routes.
• Configurez des règles de pare-feu pour autoriser le trafic approprié à atteindre les plages d'adresses IP restricted.googleapis.com. Pour en savoir plus, consultez la section Configurer les règles de pare-feu.
• Configurez le DNS de sorte que le trafic vers les API Google pointe vers les plages d'adresses IP restricted.googleapis.com. Pour en savoir plus, consultez la section Configurer le DNS.

Prise en charge IPv6 pour restricted.googleapis.com

Vous pouvez accéder aux API Google à l'aide de la plage d'adresses IPv6 du domaine restricted.googleapis.com: 2600:2d00:0002:1000::/64.

Envisagez de configurer les adresses IPv6 si vous souhaitez utiliser le domaine restricted.googleapis.com et que vous indiquez à vos clients d'utiliser des adresses IPv6. Les clients IPv6 disposant également d'adresses IPv4 configurées peuvent accéder aux API et services Google à l'aide des adresses IPv4. Tous les services n'acceptent pas le trafic provenant de clients IPv6.

Pour permettre aux clients IPv6 de votre environnement sur site d'accéder aux API Google à l'aide de restricted.googleapis.com, vous devez configurer la connexion à votre réseau VPC afin qu'elle prenne en charge le protocole IPv6. Pour en savoir plus, consultez les pages suivantes :

• Compatibilité IPv6 avec les VPN haute disponibilité
• Compatibilité des protocoles IP avec Cloud Router

Les clients sur site peuvent envoyer des requêtes à partir de n'importe quelle adresse IPv6 GUA ou ULA, à l'exception de la plage ULA fda3:e722:ac3:cc00::/64, qui est réservée à un usage interne.

Pour en savoir plus sur l'adresse IP virtuelle restricted.googleapis.com, consultez Configurer l'accès privé à Google.

Connectivité directe aux API et services

Certaines API et certains services Google offrent une connectivité directe à partir d'instances de machines virtuelles (VM) Compute Engine, contournant ainsi les Google Front Ends (serveurs GFE). Pour autoriser ce trafic, vous devez vous assurer que vos routes et vos règles de pare-feu autorisent le trafic sortant à atteindre 34.126.0.0/18 et 2001:4860:8040::/42. Vous n'avez pas besoin de créer des enregistrements DNS pour ces adresses. Plusieurs services Google Cloud prennent en charge la connectivité directe pour améliorer les performances des API gRPC Google. Pour activer cette amélioration des performances, vous devez autoriser l'accès aux plages d'adresses IP spécifiées.

La connectivité directe n'est compatible qu'avec les ressources Google Cloud. Vous ne pouvez pas utiliser la connectivité directe à partir d'hôtes sur site.

Les services offrant une connectivité directe sont compatibles avec VPC Service Controls.

Configurer des routes vers restricted.googleapis.com

Bien que VPC Service Controls s'applique aux services compatibles et configurés, quel que soit le domaine que vous utilisez, restricted.googleapis.com offre une atténuation des risques supplémentaire pour l'exfiltration de données. restricted.googleapis.com refuse l'accès aux API et services Google qui ne sont pas compatibles avec VPC Service Controls.

Pour l'accès privé à Google et l'accès privé à Google pour les hôtes sur site, votre réseau VPC doit inclure une route pour les plages d'adresses IP restricted.googleapis.com dont le saut suivant correspond à la passerelle Internet par défaut. Même si le saut suivant est une passerelle Internet par défaut, le trafic envoyé à restricted.googleapis.com reste au sein du réseau de Google.

Si votre réseau VPC ne possède pas de route par défaut dont le saut suivant est la passerelle Internet par défaut, vous pouvez créer une route statique personnalisée dont la destination est la plage d'adresses IP restricted.googleapis.com et dont le saut suivant est la passerelle Internet par défaut. Pour empêcher l'accès à Internet, vous devez supprimer les autres routes dont le saut suivant correspond à la passerelle Internet par défaut.

Pour plus d'informations sur l'utilisation des routes VPC, consultez la page Utiliser des routes de la documentation sur les VPC.

Configurer des routes statiques personnalisées dans un réseau VPC

Ajoutez des routes statiques personnalisées pour activer l'accès aux services gérés par Google compatibles avec VPC Service Controls.

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

Remplacez les éléments suivants :

• ROUTE_NAME: nom de la route personnalisée
• NETWORK_NAME : nom de votre réseau VPC
• DESTINATION_RANGE: plage de destination de la route
  • Pour acheminer le trafic vers l'adresse IP virtuelle restricted.googleapis.com, utilisez les plages suivantes :
    • Pour le trafic IPv4: 199.36.153.4/30
    • Pour le trafic IPv6: 2600:2d00:0002:1000::/64
  • Pour acheminer le trafic vers des API qui permettent une connectivité directe, utilisez les plages suivantes :
    • Pour le trafic IPv4: 34.126.0.0/18
    • Pour le trafic IPv6: 2001:4860:8040::/42

Annoncer la route restreinte aux hôtes d'un réseau sur site

Si vous utilisez l'accès privé à Google pour les hôtes sur site, configurez les routes de sorte que le trafic des API Google transite par votre connexion Cloud VPN ou Cloud Interconnect. Pour annoncer les plages d'adresses IP VIP restreintes à votre réseau sur site, utilisez le mode d'annonce personnalisée de Cloud Router. Les plages d'adresses VIP limitées ne sont accessibles qu'aux hôtes sur site qui peuvent atteindre votre réseau VPC via des adresses IP privées.

Vous pouvez ajouter cette route annoncée personnalisée à Cloud Router (pour toutes les sessions BGP sur le routeur) ou à une session BGP sélectionnée (pour un tunnel Cloud VPN ou un rattachement de VLAN).

Les routes IPv6 ne sont annoncées que dans les sessions BGP où IPv6 est activé.

Pour créer une route annoncée personnalisée pour la plage restreinte pour toutes les sessions BGP d'Cloud Router existant, procédez comme suit:

Pour créer une route annoncée personnalisée pour la plage restreinte sur une session BGP spécifique d'Cloud Router existant, procédez comme suit:

Configurer des règles de pare-feu

Pour l'accès privé à Google, les instances de VM utilisent des adresses IP internes et n'ont pas besoin d'adresses IP externes pour atteindre les ressources d'API Google protégées. Les instances de VM peuvent toutefois disposer d'adresses IP externes ou répondre aux conditions d'accès à Internet. En plus des routes annoncées personnalisées, vous pouvez restreindre le trafic de sortie provenant des instances de VM de votre réseau VPC en créant des règles de pare-feu.

Par défaut, la règle implicite d'autorisation pour le trafic sortant autorise les instances de VM à envoyer du trafic vers n'importe quelle destination s'il existe une route applicable. Vous pouvez créer une règle de refus du trafic sortant pour bloquer tout le trafic sortant, puis créer des règles d'autorisation du trafic sortant de priorité supérieure vers des destinations sélectionnées de votre réseau VPC et vers les plages d'adresses IP restricted.googleapis.com. Toutes les communications vers restricted.googleapis.com s'effectuent sur le port TCP 443.

Pour permettre au trafic Google Cloud d'atteindre les VIP restricted.googleapis.com, ajoutez des règles de pare-feu pour les destinations suivantes:

• Pour le trafic IPv4: 199.36.153.4/30
• Pour le trafic IPv6: 2600:2d00:0002:1000::/64

Pour autoriser le trafic Google Cloud à atteindre les API et les services qui permettent une connectivité directe, ajoutez des règles de pare-feu pour les destinations suivantes:

• Pour le trafic IPv4: 34.126.0.0/18
• Pour le trafic IPv6: 2001:4860:8040::/42

Pour en savoir plus sur l'utilisation des règles de pare-feu VPC, consultez la section Utiliser des règles de pare-feu VPC dans la documentation du pare-feu Cloud nouvelle génération.

Configurez vos règles de pare-feu sur site pour autoriser le trafic provenant de vos hôtes sur site à accéder aux plages d'adresses IP restricted.googleapis.com.

• Pour le trafic IPv4: 199.36.153.4/30
• Pour le trafic IPv6: 2600:2d00:0002:1000::/64

La connectivité directe aux API et services Google n'est pas prise en charge à partir des réseaux sur site.

Configurer les paramètres DNS

Vous pouvez utiliser des zones privées gérées pour vos réseaux VPC. Les zones DNS privées de Cloud DNS vous permettent d'héberger une zone DNS accessible à partir de réseaux VPC autorisés. Pour configurer le transfert à partir de certains serveurs de noms sur site, vous pouvez utiliser les plages d'adresses IP restricted.googleapis.com. Vous pouvez ensuite créer une zone privée pour googleapis.com avec un enregistrement A DNS qui mappe restricted.googleapis.com et les enregistrements CNAME appropriés pour chaque nom *.googleapis.com. Pour en savoir plus, consultez la section Gérer les zones.

Pour l'accès sur site, vous pouvez configurer une règle de transfert entrant Cloud DNS pour permettre aux serveurs de noms sur site d'interroger une zone privée gérée Cloud DNS. Vous pouvez également configurer un serveur de noms sur site, tel que BIND :

Configurer le DNS avec Cloud DNS

Pour activer la résolution DNS pour les instances de VM de votre réseau VPC, les hôtes sur un réseau sur site ou les deux, utilisez Cloud DNS. Si vous utilisez un VPC partagé, consultez la section Zones privées et VPC partagé dans la documentation de Cloud DNS. En outre, si vous utilisez un VPC partagé, nous vous recommandons d'inclure le projet hôte sur le réseau VPC partagé dans le même périmètre de service que les projets qui se connectent au réseau.

Configurer Cloud DNS à l'aide de zones privées

Vous pouvez utiliser des zones privées pour configurer Cloud DNS:

1. Créez une zone privée gérée pour votre réseau 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

   Remplacez l'élément suivant :

   • ZONE_NAME : nom de la zone que vous créez. Exemple :vpc Ce nom est utilisé dans chacune des étapes suivantes.
   • PROJECT_ID : ID du projet contenant votre réseau VPC
   • NETWORK_NAME : nom de votre réseau VPC.
   • DESCRIPTION : une description lisible et facultative de la zone gérée

2. Lancez une transaction.

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

   Remplacez ZONE_NAME par le nom de la zone que vous avez créée à la première étape.

3. Ajoutez des enregistrements DNS.

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

   Remplacez ZONE_NAME par le nom de la zone que vous avez créée à la première étape.

   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

   Remplacez ZONE_NAME par le nom de la zone que vous avez créée à la première étape.

   Si vous configurez les adresses IPv6 pour restricted.googleapis.com, créez également le jeu d'enregistrements suivant:

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

4. Exécutez la transaction.

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

   Remplacez ZONE_NAME par le nom de la zone que vous avez créée à la première étape.

5. Facultatif. Pour que les hôtes sur site atteignent la plage restreinte d'adresses IP virtuelles, effectuez les opérations suivantes :

   1. Créez une règle DNS et activez le transfert DNS entrant pour rendre les services de résolution de noms du réseau VPC accessibles en externe aux systèmes situés sur les réseaux sur site.

      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

      Remplacez l'élément suivant :

      • POLICY_NAME : nom de la zone que vous créez. Exemple :apipolicy
      • PROJECT_ID : ID du projet contenant votre réseau VPC
      • NETWORK_NAME : nom de votre réseau VPC.
      • DESCRIPTION : une description lisible et facultative de la zone gérée

   2. Sur votre réseau sur site, faites pointer le DNS sur site vers l'adresse IP du système de transfert Cloud DNS. Pour trouver l'adresse IP du système de transfert, utilisez la commande compute addresses list :

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

Configurer le DNS avec BIND

Si vous utilisez BIND pour la résolution DNS, vous pouvez le configurer pour résoudre les requêtes d'API Google vers les API Google limitées. Servez-vous de l'exemple de configuration BIND suivant, qui exploite les zones de stratégie de réponse (RPZ) pour obtenir ce comportement:

1. Ajoutez les lignes suivantes à /etc/bind/named.conf :

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

2. Ajoutez les lignes suivantes à /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. Ajoutez les lignes suivantes à /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. Ajoutez les lignes suivantes à /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.
   

Configurer le DNS dans des cas particuliers

Lorsque vous devez configurer un DNS dans certains cas particuliers, gardez à l'esprit les points suivants :

• Les configurations BIND personnalisées ne sont pas compatibles avec Dataflow. Pour personnaliser la résolution DNS lors de l'utilisation de Dataflow avec VPC Service Controls, exploitez des zones privées Cloud DNS au lieu d'utiliser des serveurs BIND personnalisés. Pour utiliser votre propre résolution DNS sur site, envisagez d'employer une méthode de transfert DNS Google Cloud.

• Vous devrez peut-être également configurer un DNS pour gcr.io si, par exemple, vous utilisez Google Kubernetes Engine (GKE). Pour en savoir plus, consultez la page Configurer Container Registry pour des clusters privés GKE.