Passer au contenu principal
Afficher en Markdown

Connecter des sessions cloud à votre VPC

Les administrateurs peuvent connecter de nouvelles sessions cloud Kiro aux ressources d'un Amazon VPC. Créez une connexion VPC dans la console Kiro, définissez-la comme valeur par défaut du profil dans Controls, puis publiez la modification. Cette préversion est offerte avec les forfaits Enterprise pour les profils IAM Identity Center dans US East (Virginie du Nord) (us-east-1). Le profil doit utiliser Controls depuis sa création ou après une migration.

Une connexion VPC fournit à chaque nouveau bac à sable une interface réseau dans l'un de vos sous-réseaux sélectionnés. Vos groupes de sécurité, vos routes, vos pare-feu et votre configuration NAT contrôlent les ressources que le bac à sable peut atteindre.

Cette fonctionnalité diffère des points de terminaison d'interface Kiro. Les points de terminaison d'interface permettent aux ressources de votre VPC d'atteindre de façon privée les API Kiro. Une connexion VPC permet aux bacs à sable cloud Kiro d'atteindre des ressources de votre VPC.

Si votre profil utilise encore les paramètres précédents, migrez-le vers Contrôles avant de créer une connexion.

Planifier la connexion

Une connexion VPC est associée à un profil Kiro. Après avoir défini Connexion VPC par défaut dans Contrôles, elle s'applique à l'ensemble du profil. Vous ne pouvez pas attribuer une connexion à certains groupes ou utilisateurs.

Avant de créer une connexion, confirmez les éléments suivants :

  • Votre profil Kiro utilise IAM Identity Center et un forfait Enterprise. Il se trouve dans US East (Virginie du Nord) (us-east-1) et utilise Controls depuis sa création ou après une migration depuis les anciens paramètres.
  • Votre organisation utilise les nouveaux Contrôles Kiro.
  • Le VPC se trouve dans la même région que le profil.
  • Votre identité de console possède les autorisations q:CreateVpcConnection, q:GetVpcConnection, q:ListVpcConnections, q:DeleteVpcConnection et q:DiscoverVpc.
  • Votre identité de console possède l'autorisation iam:PassRole pour le rôle de service, limitée à q.amazonaws.com.
  • Les plages CIDR IPv4 du VPC ne chevauchent pas 100.124.0.0/16, 172.17.0.0/16 ou 169.254.0.0/16.
  • Vous disposez d'un à 20 sous-réseaux disponibles. Au moins un sous-réseau doit se trouver dans une zone de disponibilité prise en charge.
  • Vous disposez d'un à cinq groupes de sécurité autres que celui par défaut pour la connexion.
  • Les sous-réseaux sélectionnés disposent de suffisamment d'adresses IP. Chaque bac à sable en cours d'exécution utilise une adresse.

Utilisez des sous-réseaux privés et des groupes de sécurité dédiés aux sessions cloud Kiro. Limitez le trafic sortant aux destinations dont les sessions ont besoin. Pour l'installation de paquets, fournissez une passerelle NAT ou un miroir de paquets privé accessible depuis les sous-réseaux sélectionnés.

Utilisez les ID de zone de disponibilité lors de la sélection des sous-réseaux :

RégionID de zone de disponibilité pris en charge
US East (Virginie du Nord) (us-east-1)use1-az1, use1-az2, use1-az4, use1-az5, use1-az6

Configurer les rôles IAM

Chaque connexion nécessite un rôle de service dans le compte AWS qui possède le profil Kiro. L'assistant Connecter un VPC peut créer ce rôle ou vous pouvez choisir un rôle existant. Pour permettre à l'assistant de le créer, votre identité de console doit disposer de l'autorisation de créer des rôles IAM.

Pour un rôle existant, utilisez cette politique d'approbation. Elle permet à Kiro d'assumer le rôle uniquement pour votre profil. Remplacez chaque espace réservé par l'ID de compte, la région et l'ID de profil de votre profil.

json
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "q.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "<PROFILE_ACCOUNT_ID>", "aws:SourceArn": "arn:aws:codewhisperer:<PROFILE_REGION>:<PROFILE_ACCOUNT_ID>:profile/<PROFILE_ID>" } } } ] }

L'administrateur qui crée la connexion doit disposer de l'autorisation iam:PassRole pour le rôle de service. Limitez-la à q.amazonaws.com et aux noms de rôles de service utilisés par votre organisation.

json
{ "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::<PROFILE_ACCOUNT_ID>:role/KiroVpcConnection-*", "Condition": { "StringEquals": { "iam:PassedToService": "q.amazonaws.com" } } }

Utiliser un VPC dans le compte du profil

Attachez la politique gérée AWS KiroVpcConnectionPolicy au rôle de service. La politique permet à Kiro de lire les métadonnées du VPC. Elle limite les modifications d'interface réseau aux interfaces étiquetées ManagedByKiro.

Utiliser un VPC dans un autre compte

Créez un rôle VPC dans le compte AWS qui possède le VPC. Le rôle de service assume ce rôle. Le rôle VPC lit le VPC et gère les interfaces réseau du bac à sable.

Ajoutez une politique en ligne au rôle de service. Indiquez l'ARN exact du rôle VPC.

json
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "arn:aws:iam::<VPC_ACCOUNT_ID>:role/<VPC_ROLE_NAME>" } ] }

Dans le compte propriétaire du VPC, créez le rôle VPC. Attachez-lui KiroVpcConnectionPolicy. Accordez l'approbation uniquement au rôle de service.

json
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::<PROFILE_ACCOUNT_ID>:role/<SERVICE_ROLE_NAME>" }, "Action": "sts:AssumeRole" } ] }

Créer et appliquer une connexion

  1. En tant qu'administrateur Enterprise d'un profil IAM Identity Center, ouvrez Paramètres dans la console Kiro.
  2. Dans Connectivité VPC, choisissez Gérer les connexions VPC.
  3. Choisissez Connecter un VPC.
  4. Saisissez un nom de connexion. Choisissez Créer un rôle de service ou Utiliser un rôle existant.
  5. Choisissez Ce compte ou Un autre compte. Pour un autre compte, saisissez l'ARN du rôle VPC, puis choisissez Tester la connexion.
  6. Sélectionnez le VPC, un à 20 sous-réseaux disponibles et un à cinq groupes de sécurité autres que celui par défaut.
  7. Vérifiez les paramètres, puis choisissez Créer une connexion.
  8. Dans Connexions VPC, choisissez Modifier la valeur par défaut dans Contrôles.
  9. Dans Network and web, définissez Connexion VPC par défaut sur la nouvelle connexion.
  10. Publiez la modification apportée à Controls.

La création d'une connexion ne modifie pas votre VPC et ne connecte aucune session. Les nouvelles sessions cloud l'utilisent uniquement après la publication de la modification dans Controls.

La valeur par défaut s'applique uniquement aux nouvelles sessions cloud. Les sessions existantes conservent la connexion avec laquelle elles ont démarré.

Vérifier la connexion

Dans Connexions VPC, confirmez que la connexion porte le badge Par défaut. Démarrez une nouvelle session cloud. Dans Kiro Web, la carte Connectivité VPC affiche le nom de la connexion, l'ID du VPC et la région.

La carte Configuration réseau affiche Niveau d'accès : Accès aux dépôts uniquement et Défini par votre connexion VPC. Les développeurs ne peuvent pas choisir une autre connexion, modifier l'accès réseau ni ajouter de domaines personnalisés pendant que la session utilise la connexion.

Dans Kiro IDE 1.4.236 ou une version ultérieure, ouvrez la nouvelle session cloud dans Agent Focus. Le bouton VPC configuration à côté du compositeur affiche le nom de la connexion, l'ID du VPC, la région et l'ID de connexion. Ces détails sont en lecture seule.

Remplacer ou supprimer une connexion

Vous ne pouvez pas modifier une connexion VPC. Pour modifier son VPC, ses sous-réseaux, ses groupes de sécurité ou son rôle IAM :

  1. Créez une connexion de remplacement.
  2. Définissez la connexion de remplacement comme Connexion VPC par défaut dans Contrôles.
  3. Publiez la modification apportée à Controls.
  4. Supprimez l'ancienne connexion lorsqu'elle n'est plus la valeur par défaut.

Kiro bloque la suppression de la connexion par défaut. Les sessions en cours sur une connexion supprimée continuent jusqu'à leur arrêt. Les sessions arrêtées sur cette connexion ne peuvent pas reprendre.

Conservez le rôle de service et tout rôle VPC entre comptes jusqu'à ce que chaque session utilisant la connexion soit arrêtée. Kiro a besoin des rôles pour supprimer ses interfaces réseau.

Sécurité et confiance

Kiro crée une interface réseau étiquetée ManagedByKiro pour chaque bac à sable connecté en cours d'exécution. Kiro supprime l'interface lorsque le bac à sable s'arrête.

Kiro ne crée ni ne modifie vos groupes de sécurité, tables de routage, passerelles NAT ou autres ressources VPC. Les contrôles de votre VPC déterminent les ressources que le bac à sable peut atteindre. Autorisez l'accès depuis les groupes de sécurité de la connexion plutôt que depuis les adresses IP du bac à sable, car chaque bac à sable peut recevoir une nouvelle adresse.

Quotas

RessourceLimite
Connexions VPC par profil100
Sous-réseaux par connexion1–20
Groupes de sécurité par connexion1–5
Nom de la connexion1–32 caractères, unique dans le compte
VPC par bac à sable1

Résoudre les problèmes d'une connexion

Kiro ne peut pas assumer un rôle

Vérifiez que la politique d'approbation du rôle de service autorise q.amazonaws.com uniquement pour le compte de profil et l'ARN de profil. Pour une connexion entre comptes, vérifiez que le rôle de service indique l'ARN exact du rôle VPC. Le rôle VPC doit approuver le rôle de service.

Vérifiez que l'administrateur possède l'autorisation iam:PassRole pour le rôle de service. L'autorisation doit exiger q.amazonaws.com.

Le VPC, le sous-réseau ou le groupe de sécurité est indisponible

Confirmez que le VPC se trouve dans la région du profil. Vérifiez que ses plages CIDR ne chevauchent pas les plages réservées à Kiro. Sélectionnez des sous-réseaux disponibles, dont un dans une zone de disponibilité prise en charge. Utilisez des groupes de sécurité autres que celui par défaut.

L'installation de paquets échoue

Fournissez une passerelle NAT depuis les sous-réseaux sélectionnés. Vous pouvez aussi utiliser un miroir de paquets privé que les sous-réseaux peuvent atteindre. Vérifiez les règles de sortie du groupe de sécurité, les routes et les pare-feu.

Une session arrêtée ne peut pas reprendre

La connexion VPC de cette session a été supprimée. Démarrez une nouvelle session cloud avec la connexion par défaut actuelle.

Une session ne peut pas atteindre une ressource

Vérifiez les routes, les pare-feu et les règles des groupes de sécurité pour les sous-réseaux sélectionnés et la destination. Autorisez l'accès depuis les groupes de sécurité de la connexion plutôt que depuis une seule adresse IP de bac à sable.

Documentation connexe

Page mise à jour : 20 novembre 2026