Création d'une passerelle de point de terminaison inter-comptes

Vous pouvez créer une passerelle d'extrémité pour un service IBM Cloud® pris en charge ou un service non IBM (tiers) auquel vous souhaitez accéder au sein de votre réseau VPC privé. Pour les services IBM et non IBM, vous pouvez utiliser le CLI, l'API ou Terraform. Cependant, la création de passerelles VPE inter-comptes pour les services IBM Cloud n'est pas actuellement prise en charge par la console.

Avant de commencer

Avant de créer une passerelle de point de terminaison, assurez-vous d'avoir lu la section Planification des passerelles de point de terminaison privées virtuelles et de remplir les conditions préalables suivantes :

  • Assurez-vous que votre service cible prend en charge les VPE inter-comptes. Consultez la documentation du service pour plus de détails.

  • Un cloud privé virtuel

  • Un sous-réseau dans au moins une zone de disponibilité si vous avez l'intention de lier une adresse IP lors de la mise à disposition de la passerelle de points d'extrémité

  • Une instance du service

  • Permissions IAM appropriées pour créer une passerelle d'extrémité, créer ou lier une IP réservée, et afficher ou répertorier le service cible.

  • Assurez-vous de disposer des autorisations IAM et des politiques de restriction basée sur le contexte (CBR) nécessaires pour autoriser l'accès.

  • Vous devez obtenir le nom de ressource cloud (CRN) de l'instance de service cible.

    La console IBM Cloud n'affiche pas les instances de service qui appartiennent à d'autres comptes.

  • Pour autoriser un VPE dans votre compte Accessor à utiliser l'instance de service cible qui réside dans un autre IBM Cloud compte, vous devez créer une politique d'autorisation de service à service comme décrit dans la section suivante.

Création d'une autorisation de service pour le VPE inter-comptes dans la console

Avant de créer un VPE inter-comptes, vous devez créer une politique d'autorisation de service à service comme suit :

Lorsque vous créez une autorisation inter-comptes entre des comptes qui ne font pas partie de la même entreprise, vous devez saisir manuellement les identifiants requis.

  1. Dans la console IBM Cloud, cliquez sur Gérer > Accès (IAM ), puis sélectionnez Autorisations.

  2. Cliquez sur Créer.

  3. Sélectionnez un compte source :

    • Si vous configurez l'autorisation dans votre compte, sélectionnez Ce compte.
    • Si vous configurez l'autorisation dans le compte d'entreprise, sélectionnez Autre compte.
  4. Pour le service source, sélectionnez Services d'infrastructure VPC.

  5. Pour les ressources sources, sélectionnez Ressources spécifiques. Ensuite, sélectionnez Type de ressource comme attribut et Point de terminaison privé virtuel pour VPC comme valeur.

  6. Pour le service cible, sélectionnez le service qui héberge la ressource cible.

  7. Pour les ressources cibles, sélectionnez Toutes les instances.

  8. Pour les rôles cibles, sélectionnez le rôle Viewer afin d'accorder au service VPE un accès en lecture à la ressource cible. Ensuite, cliquez sur « Review » (Vérifier).

  9. Cliquez sur Autoriser.

Création d'une autorisation de service pour VPE inter-comptes à partir de l'interface CLI

Avant de créer un VPE inter-comptes, vous devez créer une stratégie d'autorisation de service à service entre le service Virtual Private Endpoint et le service cible dans l'autre compte.

Les exemples suivants créent une autorisation pour VPE (is.endpoint-gateway) dans le compte 1234567890 afin de lire les ressources Cloud Object Storage dans le compte 0987654321:

  ibmcloud iam authorization-policy-create is endpoint-gateway cloud-object-storage service-instance --source-account 1234567890 --target-account 0987654321 --roles Viewer

Vous pouvez également créer un fichier s2s-policy.json pour spécifier les services cible et source, puis l'utiliser avec la commande suivante :

ibmcloud iam authorization-policy-create --file ./s2s-policy.json

Créez le fichier s2s-policy.json avec le contenu suivant :

{
	"subjects": [
		{
			"attributes": [
				{
					"name": "accountId",
					"value": "<source-account-id>"
				},
				{
					"name": "serviceName",
					"value": "is"
				},
				{
					"name": "resourceType",
					"value": "endpoint-gateway"
				}
			]
		}
	],
	"type": "authorization",
	"roles": [
		{
			"role_id": "crn:v1:bluemix:public:iam::::role:Viewer"
		}
	],
	"resources": [
		{
			"attributes": [
				{
					"name": "accountId",
					"value": "<target-account-id>"
				},
				{
					"name": "serviceName",
					"value": "<service-name, such as cloud-object-storage>"
				}
			]
		}
	]
}

Où :

accountId
Identifie l'ID du compte de l'utilisateur qui crée la politique de compte.
endpoint-gateway
Identifie le type de ressource de passerelle VPE qui accédera au service cible.
serviceName
Le nom du IBM Cloud service propriétaire de la ressource cible, tel que cloud-object-storage.
resourceType
Le type de ressource au sein du service cible. Les valeurs communes comprennent service-instance.
source-account-id
L'ID du compte qui créera et détiendra la connexion VPE (le compte d'accès).
target-account-id
L'ID du compte propriétaire de la ressource cible (le compte cible).

L'exemple suivant autorise VPE (is.endpoint-gateway) dans le compte 1234567890 à lire Cloud Object Storage les ressources dans le compte 0987654321:

  ibmcloud iam authorization-policy-create \
  --file ./s2s-policy.json \
  Creating authorization policy under account target-account as example-user...
  is endpoint-gateway \
  cloud-object-storage service-instance \
  --source-account 1234567890 \
  --target-account 0987654321 \
  --roles Viewer

Exemple du fichier s2s-policy.json que vous devez créer pour permettre à VPE (is.endpoint-gateway) dans le compte 1234567890 de lire les ressources Cloud Object Storage dans le compte 0987654321:

{
	"subjects": [
		{
			"attributes": [
				{
					"name": "accountId",
					"value": "1234567890 "
				},
				{
					"name": "serviceName",
					"value": "is"
				},
				{
					"name": "resourceType",
					"value": "endpoint-gateway"
				}
			]
		}
	],
	"type": "authorization",
	"roles": [
		{
			"role_id": "crn:v1:bluemix:public:iam::::role:Viewer"
		}
	],
	"resources": [
		{
			"attributes": [
				{
					"name": "accountId",
					"value": "0987654321"
				},
				{
					"name": "serviceName",
					"value": "cloud-object-storage"
				}
			]
		}
	]
}

Création d'une autorisation de service pour VPE inter-comptes avec l'API

Pour permettre aux VPE d'un compte d'accéder aux instances de service d'un autre compte, vous devez créer une politique d'autorisation IAM de service à service ( S2S ) à l'aide de l'API IAM d' IBM Cloud.

  1. Configurez votre environnement API avec les variables requises, y compris votre jeton IAM :

    export iam_token=<your_IAM_token>
    export iam_api_endpoint="https://iam.cloud.ibm.com/v1"
    
  2. Créer la politique d'autorisation :

    curl -X POST "$iam_api_endpoint/authorization-policies" \
      -H "Authorization: Bearer $iam_token" \
      -H "Content-Type: application/json" \
      -d '{
      {
    	   "subjects": [
    		  {
    			"attributes": [
    				{
    					"name": "accountId",
    					"value": "1234567890 "
    				},
    				{
    					"name": "serviceName",
    					"value": "is"
    				},
    				{
    					"name": "resourceType",
    					"value": "endpoint-gateway"
    				}
    			]
    		  }
    	   ],
    	   "type": "authorization",
    	   "roles": [
    		   {
    			"role_id": "crn:v1:bluemix:public:iam::::role:Viewer"
    		   }
    	   ],
    	   "resources": [
    		{
    			"attributes": [
    				{
    					"name": "accountId",
    					"value": "0987654321"
    				},
    				{
    					"name": "serviceName",
    					"value": "cloud-object-storage"
    				}
    			]
    		}
    	   ]
    }
    

Création d'une autorisation de service pour la VPE inter-comptes avec Terraform

La configuration Terraform suivante montre comment créer une politique d'autorisation IAM de service à service ( S2S ) qui permet aux VPE d'un compte IBM Cloud d'accéder aux instances de service d'un autre compte.

Cette politique doit être créée avant de créer l'EPV inter-comptes. Le rôle Viewer accorde au service VPE un accès en lecture aux métadonnées de la ressource cible, ce qui permet une connectivité sécurisée entre les comptes.

provider "ibm" {
  ibmcloud_api_key = var.ibmcloud_api_key
}

# Create a cross-account IAM authorization policy
resource "ibm_iam_authorization_policy" "cross_account_vpe" {
  # The source is the VPE service in the accessor account
  source_service_name  = "is"
  source_resource_type = "endpoint-gateway"
  source_account       = var.accessor_account_id

  # The target is the service instance in another account
  target_service_name  = "cloud-object-storage"
  target_resource_type = "service-instance"
  target_account       = var.target_account_id

  # The Viewer role allows the VPE service to read target resource metadata
  roles = ["Viewer"]
}

# Optional: Output the policy ID
output "authorization_policy_id" {
  value = ibm_iam_authorization_policy.cross_account_vpe.id
}

Pour plus d'informations, voir le registre Terraform.

Création d'une passerelle de point de terminaison inter-comptes dans la console

Pour créer une passerelle de point de terminaison inter-comptes pour les services non IBM (tiers) dans la console IBM Cloud, procédez comme suit :

Actuellement, la création de passerelles VPE inter-comptes vers " IBM Cloud services" n'est pas prise en charge dans la console.

  1. Dans la IBM Cloud console, sélectionnez l 'icône Menu Navigation, puis cliquez sur l'icône Infrastructure VPC > Réseau > Passerelles d'extrémité privées virtuelles. La page des passerelles de points d'extrémité virtuels privés pour VPC s'affiche.

  2. Cliquez sur Créer pour accéder à la page de mise à disposition.

  3. Dans la section Détails, renseignez les zones suivantes :

    • Nom : entrez un nom unique pour votre passerelle de points d'extrémité.
    • Groupe de ressources : sélectionnez un groupe de ressources pour la passerelle de points d'extrémité. Vous pouvez utiliser le groupe par défaut pour cette passerelle de points d'extrémité ou en choisir un dans la liste. Pour plus d'informations, voir Meilleures pratiques pour l'organisation des ressources dans un groupe de ressources.
    • Tags- En option, ajoutez des tags pour organiser, suivre les coûts d'utilisation ou gérer l'accès à vos ressources.
    • Balises de gestion des accès- Vous pouvez également ajouter des balises de gestion des accès aux ressources afin de faciliter l'organisation des relations de contrôle d'accès. key:value est le seul format pris en charge pour les étiquettes de gestion des accès. Pour plus d'informations, voir Contrôle de l'accès aux ressources à l'aide d'étiquettes.
    • Cloud privé virtuel- Sélectionnez le VPC où vous avez besoin de l'adresse IP VPE. En fonction de la région du VPC que vous avez sélectionnée, le système vous fournit une liste de IBM services auxquels vous pouvez accéder pour les associer à la passerelle de point de terminaison. Si le service cible n'est pas proposé dans la région du VPC que vous avez sélectionnée, vous pouvez modifier la région afin de sélectionner le service dans une autre région.

    Si le service ou l'instance de service prévu ne s'affiche pas, validez à nouveau vos droits IAM. Vous avez également la possibilité d'allouer une adresse IP réservée à associer à la passerelle ou de spécifier un sous-réseau VPC afin d'allouer une adresse IP réservée à associer à la passerelle.

  4. Dans la section Groupes de sécurité, cochez les cases des groupes de sécurité à attacher à partir du tableau des groupes de sécurité. Vous pouvez ensuite gérer ces groupes de sécurité et renforcer leurs règles de sécurité pour le trafic entrant vers vos passerelles de points d'extrémité.

    Lorsque vous créez une passerelle de point de terminaison sans spécifier de groupe de sécurité, le groupe de sécurité par défaut VPC est connecté à la passerelle de point de terminaison. Pour plus d'informations, voir Configuration des listes de contrôle d'accès et des groupes de sécurité à utiliser avec les passerelles de point de terminaison.

  5. Dans la section Demande de connexion à un service, sélectionnez un service non IBM Cloud auquel vous souhaitez accéder en utilisant cette passerelle. Saisissez ensuite le nom de la ressource en nuage (CRN) du service Private Path (obtenu auprès de votre fournisseur de services).

    Il n'est actuellement pas possible de créer des EPV inter-comptes pour IBM Cloud services. Vous devez utiliser le CLI et fournir l'instance de service CRN.

    Une fois que vous avez créé votre demande de connexion, celle-ci est envoyée au fournisseur de services pour examen. La vérification peut être automatisée en fonction de la politique choisie par le fournisseur, ou elle peut prendre plusieurs jours si le fournisseur a choisi de vérifier manuellement les demandes. Si votre demande est acceptée, vous recevez une notification et pouvez alors accéder au service. Si votre demande est refusée, contactez le fournisseur de services.

  6. Dans la section Partager DNS, sélectionnez l'un des modes de liaison de résolution DNS suivants :

    • Primary permet aux points d'extrémité de service de la passerelle VPE dans le VPC partagé DNS d'être partagés avec le VPC concentrateur DNS pour la résolution de noms.
    • L'option « Désactivé » empêche le partage des points de terminaison de service de la passerelle VPE pour la résolution de noms.

    Lorsque le VPC est un hub DNS, le partage DNS est toujours défini sur Primaire et le mode ne peut pas être modifié.

  7. Dans la section IP réservées, sélectionnez les adresses IP réservées. Les options possibles sont les suivantes :

    • Select one for me- Entrez un préfixe de nom pour les adresses IP, ou un préfixe est choisi pour vous. Sélectionnez un ou plusieurs sous-réseaux (un sous-réseau par zone est recommandé) et activez le bouton Auto-release (Libération automatique) si vous souhaitez que cette adresse IP réservée soit automatiquement supprimée en cas de suppression de la passerelle de terminaison.

    • Sélectionner parmi les adresses IP existantes- Choisir dans la liste des adresses IP existantes. Si aucune adresse IP n'existe, cliquez sur Réserver une adresse IP pour en réserver une.

      Une seule IP réservée peut être liée à une passerelle VPE par AZ dans un VPC. Assurez-vous qu'il n'existe aucune autre liaison dans la même zone de disponibilité (AZ) sur l'ensemble des sous-réseaux au sein du VPC.

    • Sélectionner ultérieurement: sélectionnez les adresses IP à un moment donné après la création de la passerelle de point de terminaison.

  8. Vérifiez le récapitulatif de la commande, puis cliquez sur Créer une passerelle de point de terminaison privé virtuel. La passerelle de point de terminaison est demandée pour utilisation.

Création d'une passerelle de points de terminaison inter-comptes à partir de l'interface de ligne de commande

Avant de commencer, configurez votre environnement CLI.

Pour créer une passerelle de point de terminaison inter-comptes à partir de l'interface de ligne de commande, procédez comme suit :

  1. Répertoriez les instances de service IBM Cloud pouvant être définies en tant que cibles de passerelle de points d'extrémité :

    ibmcloud is endpoint-gateway-targets
    
  2. Créez une passerelle de point de terminaison inter-comptes en exécutant la commande suivante :

    ibmcloud is endpoint-gateway-create --target TARGET [--target-type private_path_service_gateway | provider_cloud_service | provider_infrastructure_service] [--vpc VPC] [--name NAME] [--rip RIP --subnet SUBNET | (--new-reserved-ip NEW_RESERVED_IP1 --new-reserved-ip NEW_RESERVED_IP2 ...)] [--allow-dns-resolution-binding false | true] [--sg SG] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]
    

    Où :

    --target-type:
    Indique le type de cible pour cette passerelle de point de terminaison et peut prendre l'une des valeurs suivantes : private_path_service_gateway, provider_cloud_service, ou provider_infrastructure_service.
    --vpc:
    Indique l'ID ou le nom du VPC.
    --target:
    Indique le nom du service d'infrastructure du fournisseur ou le CRN pour une instance de service cloud du fournisseur. Vous pouvez entrer la commande ibmcloud is endpoint-gateway-targets pour dresser la liste des services d'infrastructure et de nuage du fournisseur qui sont qualifiés pour être définis en tant que cible de la passerelle de point d'extrémité.
    --name:
    Indique le nouveau nom de la passerelle d'extrémité.
    --rip:
    Indique l'ID de l'IP réservée à lier à la passerelle d'extrémité.
    --subnet:
    ID ou nom du sous-réseau. Ce nom est requis uniquement si l'adresse IP réservée fournie est au format de nom.
    --new-reserved-ip:
    Indique la nouvelle configuration IP réservée au format JSON ou dans un fichier JSON. RESERVED_IP_JSON|@RESERVED_IP_JSON_FILE
    --sg:
    Indique l'ID du groupe de sécurité.

    Si vous ne spécifiez pas -sg, le groupe de sécurité par défaut du VPC est lié à la passerelle d'extrémité.

    --resource-group-id:
    Indique l'ID du groupe de ressources. Cette option est mutuellement exclusive avec --resource-group-name.
    --resource-group-name:
    Indique le nom du groupe de ressources. Cette option est mutuellement exclusive avec --resource-group-id.
    --output:
    Indique le format de sortie. Seul JSON est pris en charge.
    -q, --quiet:
    Supprime les sorties détaillées.

    Pour plus d'informations et des exemples de commandes, consultez la référence VPC CLI.

Créer une passerelle de point de terminaison inter-comptes avec l'API

Pour créer une passerelle de points de terminaison inter-comptes avec l'API, procédez comme suit :

  1. Configurez votre environnement d'API.

  2. Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :

    • ResourceGroupId- Tout d'abord, obtenez votre groupe de ressources, puis remplissez la variable :

      export ResourceGroupId=<your_resourcegroup_id>
      
    • VpcId- Utilisez la commande list vpc (avec les variables précédentes), puis renseignez la variable en fonction de l'identifiant fourni :

      export VpcId=<your_VPC_id>
      
    • TargetCrn- Le nom, ou CRN, de l'instance du service IBM Cloud où vous souhaitez définir la passerelle de point d'extrémité.

    Vous pouvez utiliser la commande ibmcloud is endpoint-gateway-targets pour répertorier les instances de service IBM Cloud qui peuvent être définies comme cibles de la passerelle de points d'extrémité.

    export TargetCrn=<CRN of a target service>
    
    • SubnetID (facultatif) : ID sous-réseau.

      export SubnetID=<your_subnet_id>
      
  3. Lorsque toutes les variables sont lancées, sélectionnez l'une des actions suivantes :

    • Créez une passerelle de points d'extrémité pour le VPC spécifique :

      curl -X POST -sH "Authorization:${iam_token}" \
      "$vpc_api_endpoint/v1/endpoint_gateways?version=$api_version&generation=2" \
      -d '{
        "name": endpoint-gateway-1",
        "vpc": {"id":"'$VpcId'"},
        "target": {
            "crn": "$TargetCrn",
            "resource_type": "provider_cloud_service"
        },
        "security_groups": [
           {"id": "'$sg'"}
        ]
      }'
      

      Lorsque vous créez une passerelle de point de terminaison pour vous connecter à un service Private Path, assurez-vous que le « type de ressource » correspond à « private_path_service_gateway ».

      Une fois que vous avez créé une passerelle de points d'extrémité pour votre instance de service et affecté une adresse IP réservée, vous devez lier les adresses IP de votre réseau VPC à la passerelle de points d'extrémité. Pour plus d'informations, consultez la section Liaison et déliaison d'une adresse IP réservée. Ces adresses IP liées deviennent l'EPV pour accéder au service qui est mappé à la passerelle d'extrémité.

    • Créer une passerelle d'extrémité avec une adresse IP réservée associée :

      curl -X POST -sH "Authorization:${iam_token}" \
      "$vpc_api_endpoint/v1/endpoint_gateways?version=$api_version&generation=2" \
      -d '{
      "name": endpoint-gateway-1",
      "vpc": {"id":"'$VpcId'"},
      "target": {
      "crn": "$TargetCrn",
      "resource_type": "provider_cloud_service"
      },
      "security_groups": [
      {"id": "'$sg'"}
      ],
      "ips": [
      {"subnet": { "id": "$SubnetId" } }
      ]
      }'
      

      Lorsque vous créez une passerelle de point de terminaison pour vous connecter à un service Private Path, assurez-vous que le « type de ressource » est défini sur private_path_service_gateway.

Une fois qu'une passerelle de points d'extrémité est créée pour un service IBM Cloud, elle présente les points d'extrémité qui lui sont associés. Vous pouvez modifier la passerelle de point de terminaison de différentes manières, par exemple en associant ou en dissociant des adresses IP, en modifiant le groupe de ressources et en mettant à jour les balises. Si vous devez modifier les points de terminaison du service pour une raison quelconque, vous devez supprimer et recréer la passerelle de points de terminaison.

Créer une passerelle de point de terminaison inter-comptes avec Terraform

Vous pouvez utiliser Terraform pour créer une passerelle de point de terminaison inter-comptes.

Pour utiliser Terraform, téléchargez l'interface CLI Terraform et configurez le IBM Cloud plug-in Provider. Pour plus d'informations, consultez la section Démarrer avec Terraform.

L'exemple suivant crée une passerelle VPE :

resource "ibm_is_virtual_endpoint_gateway" "example" {

  name = "example-endpoint-gateway"
  target {
    name          = "ibm-ntp-server"
    resource_type = "provider_infrastructure_service"
  }
  vpc            = ibm_is_vpc.example.id
  resource_group = data.ibm_resource_group.example.id
  security_groups = [ibm_is_security_group.example.id]
}

resource "ibm_is_virtual_endpoint_gateway" "example1" {
  name = "example-endpoint-gateway-1"
  target {
    name          = "ibm-ntp-server"
    resource_type = "provider_infrastructure_service"
  }
  vpc = ibm_is_vpc.example.id
  ips {
    subnet = ibm_is_subnet.example.id
    name   = "example-reserved-ip"
  }
  resource_group = data.ibm_resource_group.example.id
  security_groups = [ibm_is_security_group.example.id]
}

resource "ibm_is_virtual_endpoint_gateway" "example3" {
  name = "example-endpoint-gateway-2"
  target {
    name          = "ibm-ntp-server"
    resource_type = "provider_infrastructure_service"
  }
  vpc = ibm_is_vpc.example.id
  ips {
    subnet = ibm_is_subnet.example.id
    name   = "example-reserved-ip"
  }
  resource_group = data.ibm_resource_group.example.id
  security_groups = [ibm_is_security_group.example.id]
}

resource "ibm_is_virtual_endpoint_gateway" "example4" {
  name = "example-endpoint-gateway-3"
  target {
    crn           = "crn:v1:bluemix:public:cloud-object-storage:global:::endpoint:s3.direct.mil01.cloud-object-storage.appdomain.cloud"
    resource_type = "provider_cloud_service"
  }
  vpc            = ibm_is_vpc.example.id
  resource_group = data.ibm_resource_group.example.id
  security_groups = [ibm_is_security_group.example.id]
}

Étapes suivantes après la création d'une passerelle VPE

Si vous revenez à la page Passerelles de point de terminaison privé virtuel pour VPC, votre passerelle de point de terminaison s'affiche dans le tableau.

  • Pour IBM Cloud les services, le statut de votre passerelle d'extrémité passe de Updating à Stable. Vous pouvez cliquer sur le menu Actions Actions pour renommer, réserver ou lier une adresse IP, dissocier une adresse IP ou supprimer une passerelle de point de terminaison.
  • Pour les services non IBM Cloud (tiers), le statut de votre passerelle d'extrémité est Pending jusqu'à ce que le fournisseur de services autorise ou refuse votre demande de connexion. Le statut passe à Stable lorsque la connexion est établie. Vous pouvez cliquer sur Suivre ou développer la ligne du tableau correspondant à la passerelle d'extrémité pour afficher la progression de votre demande.
  • Vous pouvez éventuellement activer ou désactiver le partage DNS pour cette passerelle de point de terminaison à l'aide du commutateur de liaison de résolution DNS qui se trouve dans la ligne du tableau de la passerelle VPE. Pour plus d'informations, consultez la section À propos du partage DNS pour les passerelles VPE.