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.
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:DeleteVpcConnectionetq:DiscoverVpc. - Votre identité de console possède l'autorisation
iam:PassRolepour 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/16ou169.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égion | ID 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 |
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.
{ "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.
{ "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::<PROFILE_ACCOUNT_ID>:role/KiroVpcConnection-*", "Condition": { "StringEquals": { "iam:PassedToService": "q.amazonaws.com" } } }
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.
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.
{ "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.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::<PROFILE_ACCOUNT_ID>:role/<SERVICE_ROLE_NAME>" }, "Action": "sts:AssumeRole" } ] }
- En tant qu'administrateur Enterprise d'un profil IAM Identity Center, ouvrez Paramètres dans la console Kiro.
- Dans Connectivité VPC, choisissez Gérer les connexions VPC.
- Choisissez Connecter un VPC.
- Saisissez un nom de connexion. Choisissez Créer un rôle de service ou Utiliser un rôle existant.
- Choisissez Ce compte ou Un autre compte. Pour un autre compte, saisissez l'ARN du rôle VPC, puis choisissez Tester la connexion.
- Sélectionnez le VPC, un à 20 sous-réseaux disponibles et un à cinq groupes de sécurité autres que celui par défaut.
- Vérifiez les paramètres, puis choisissez Créer une connexion.
- Dans Connexions VPC, choisissez Modifier la valeur par défaut dans Contrôles.
- Dans Network and web, définissez Connexion VPC par défaut sur la nouvelle connexion.
- 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é.
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.
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 :
- Créez une connexion de remplacement.
- Définissez la connexion de remplacement comme Connexion VPC par défaut dans Contrôles.
- Publiez la modification apportée à Controls.
- 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.
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.
| Ressource | Limite |
|---|---|
| Connexions VPC par profil | 100 |
| Sous-réseaux par connexion | 1–20 |
| Groupes de sécurité par connexion | 1–5 |
| Nom de la connexion | 1–32 caractères, unique dans le compte |
| VPC par bac à sable | 1 |
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.
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.
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.
La connexion VPC de cette session a été supprimée. Démarrez une nouvelle session cloud avec la connexion par défaut actuelle.
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.
- Sessions cloud - exécuter des sessions Kiro dans des bacs à sable cloud gérés
- Points de terminaison d'interface Kiro - connecter de façon privée les ressources de votre VPC aux API Kiro
- Sandbox - configurer l'accès réseau et les paramètres d'environnement du bac à sable
Connecter des sessions cloud à votre VPC