Configuration de l'environnement

Vous pouvez configurer l'environnement sandbox pour qu'il corresponde aux exigences de votre projet, y compris les dépendances, les commandes de génération et les paramètres d'exécution.

L'agent Kiro Web détecte le type de votre projet et configure automatiquement le sandbox en fonction des fichiers de configuration de votre dépôt (comme package.json, requirements.txt ou des manifestes de génération). Cela garantit que l'environnement correspond aux exigences de votre projet sans configuration manuelle.

Vous pouvez personnaliser l'environnement sandbox à partir de la page Paramètres de l'agent, sous Sandbox. Les options disponibles comprennent :

• Variables d'environnement — définissez des variables et des secrets pour l'exécution des tâches
• Accès Internet — contrôlez les domaines auxquels l'agent peut accéder
• Powers et MCP — installez des Powers ou configurez des serveurs MCP personnalisés

Si l'agent ou les serveurs MCP de votre sandbox doivent appeler des API AWS — par exemple, pour déployer une infrastructure, interroger des journaux CloudWatch ou gérer des ressources dans votre compte — vous pouvez configurer un rôle IAM que Kiro Web assumera en votre nom.

Lorsqu'une tâche s'exécute, Kiro Web assume votre rôle et fournit des identifiants de courte durée au sandbox. L'agent, les outils CLI et tous les serveurs MCP exécutés dans le sandbox utilisent ces identifiants pour interagir avec vos ressources AWS.

1. Créez un rôle IAM dans votre compte AWS avec la politique de confiance ci-dessous
2. Accédez aux Paramètres et sélectionnez l'onglet Agent
3. Sous Sandbox, choisissez IAM Role
4. Entrez l'ARN du rôle IAM que vous avez créé

Kiro Web valide le rôle lorsque vous enregistrez. Si le rôle ne peut pas être assumé — par exemple, parce que la politique de confiance est manquante ou que l'ARN est incorrect — une erreur s'affichera et la configuration ne sera pas enregistrée.

Pour que Kiro Web puisse assumer votre rôle, la politique de confiance du rôle doit autoriser le principal de service q.amazonaws.com avec les autorisations sts:AssumeRole, sts:SetSourceIdentity et sts:TagSession. L'identité source est votre ID utilisateur Kiro, ce qui garantit que seul votre compte Kiro peut assumer le rôle et fournit une piste d'audit immuable dans CloudTrail.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "q.amazonaws.com"
            },
            "Action": [
                "sts:AssumeRole",
                "sts:SetSourceIdentity"
            ],
            "Condition": {
                "StringEquals": {
                    "sts:SourceIdentity": "<your-kiro-userId>"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "q.amazonaws.com"
            },
            "Action": "sts:TagSession",
            "Condition": {
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "GroupIds",
                        "KiroSessionId"
                    ]
                }
            }
        }
    ]
}

Remplacez <your-kiro-userId> par votre ID utilisateur Kiro réel. Vous pouvez trouver cette valeur dans le panneau des paramètres du rôle IAM — elle est affichée avec un bouton de copie afin que vous puissiez la coller directement dans votre politique.

La politique de confiance effectue les actions suivantes :

• sts:AssumeRole — permet à Kiro Web d'assumer le rôle
• sts:SetSourceIdentity — permet à Kiro Web de définir votre ID utilisateur comme identité source, qui apparaît dans CloudTrail pour toutes les actions effectuées avec la session
• Condition sts:SourceIdentity — garantit que seul votre ID utilisateur spécifique peut être défini comme identité source
• sts:TagSession — permet à Kiro Web de transmettre des balises de session (GroupIds, KiroSessionId) pour le contrôle d'accès basé sur les attributs
• Condition aws:TagKeys — restreint les clés de balise qui peuvent être transmises

Attachez au rôle une politique d'autorisations qui accorde uniquement ce dont l'agent a besoin. Par exemple, si vous utilisez le Power AWS Observability, votre rôle pourrait avoir besoin de :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:DescribeAlarms",
                "cloudwatch:GetMetricData",
                "cloudwatch:ListMetrics",
                "logs:DescribeLogGroups",
                "logs:StartQuery",
                "logs:GetQueryResults"
            ],
            "Resource": "*"
        }
    ]
}

Lorsque votre organisation compte plusieurs utilisateurs partageant un seul rôle IAM, vous pouvez utiliser des attributs de session pour partitionner l'accès afin que chaque utilisateur ne puisse accéder qu'à ses propres ressources. Kiro Web définit deux attributs sur chaque session que vous pouvez référencer dans les conditions de politique IAM :

• Identité source — votre ID utilisateur Kiro.
• Balise de session GroupIds — une liste séparée par des deux-points d'un maximum de 5 ID de groupes AWS Identity Center à laquelle appartient l'utilisateur. Disponible uniquement pour les utilisateurs Identity Center.
• Balise de session KiroSessionId — un identifiant unique pour la session de tâche Kiro Web en cours. Vous pouvez trouver le KiroSessionId dans l'URL de la page.

Si plusieurs utilisateurs de votre répertoire Identity Center partagent le même rôle, utilisez un caractère générique sur le préfixe du magasin d'identités dans la condition sts:SourceIdentity. Cela permet à tout utilisateur de ce répertoire d'assumer le rôle :

"Condition": {
    "StringLike": {
        "sts:SourceIdentity": "d-xxxxxxxxxx.*"
    }
}

Remplacez d-xxxxxxxxxx par l'ID de votre répertoire Identity Center. Vous pouvez trouver cette information dans la console AWS IAM Identity Center sous Settings > Identity source.

La politique suivante montre comment partitionner l'accès en utilisant à la fois l'identité source et l'appartenance à un groupe dans une seule politique :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowUserToReadAndWriteOwnPrefix",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:s3:::my-team-bucket/${aws:SourceIdentity}/*"
        },
        {
            "Sid": "AllowUserToListOwnPrefix",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::my-team-bucket",
            "Condition": {
                "StringLike": {
                    "s3:prefix": "${aws:SourceIdentity}/*"
                }
            }
        },
        {
            "Sid": "AllowGroupToReadSharedResources",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::team-bucket",
                "arn:aws:s3:::team-bucket/*"
            ],
            "Condition": {
                "StringLike": {
                    "aws:PrincipalTag/GroupIds": "*<your-identity-center-group-id>*"
                }
            }
        },
        {
            "Sid": "AllowGroupToAccessSecrets",
            "Effect": "Allow",
            "Action": "secretsmanager:GetSecretValue",
            "Resource": "arn:aws:secretsmanager:*:*:secret:teams/*",
            "Condition": {
                "StringLike": {
                    "aws:PrincipalTag/GroupIds": "*<your-identity-center-group-id>*"
                }
            }
        },
        {
            "Sid": "AllowSessionScopedScratchAccess",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:s3:::my-team-bucket/scratch/${aws:PrincipalTag/KiroSessionId}/*"
        }
    ]
}

• Déclarations d'identité source — utilisez ${aws:SourceIdentity} dans les chemins de ressources pour délimiter l'accès par utilisateur. La session de chaque utilisateur est automatiquement confinée à son propre préfixe.
• Instructions de groupe — utilisez aws:PrincipalTag/GroupIds pour accorder l'accès en fonction de l'appartenance à un groupe Identity Center.
• Instructions de session — utilisez aws:PrincipalTag/KiroSessionId pour limiter l'accès à une seule session de tâche.

Remplacez <your-identity-center-group-id> par l'ID de votre groupe Identity Center. Vous pouvez trouver les ID de groupe dans la console AWS IAM Identity Center sous Groups.

Les identifiants sont de courte durée, actualisés automatiquement pendant l'exécution de la tâche et supprimés une fois la tâche terminée.