Utilisez les secrets en toute sécurité avec les agents de codage AI

Lorsque les agents de codage AI ont accès au shell ou à l'AWS API, ils peuvent appeler get-secret-value et recevoir des secrets en texte brut dans leur fenêtre contextuelle. Cela crée de multiples risques : des valeurs secrètes peuvent être divulguées dans l'historique des conversations, les journaux ou les appels aux outils en aval.

Pour éviter cela, utilisez la compétence de sécurité secrète du kit d'outils des agents pour AWS. Cette compétence enseigne aux agents d'intelligence artificielle à utiliser des références dynamiques résolues lors de l'exécution, de sorte que l'agent orchestre l'utilisation du secret sans jamais voir la valeur en texte clair.

Comment ça marche

La compétence de sécurité secrète fournit deux niveaux de protection :

Conditions préalables

Installer le plug-in

Installez le aws-core plugin pour votre plateforme d'agents. La compétence de sécurité secrète et le crochet s'activent automatiquement.

Pour Claude Code :

claude plugin add ./plugins/aws-core

Pour OpenAI Codex :

codex plugin add ./plugins/aws-core

Pour les autres plateformes prises en charge, consultez le kit d'outils de l'agent pour AWS README.

Le {{resolve :...}} syntaxe

Lorsque l'agent doit transmettre un secret à une commande, il utilise une référence dynamique au lieu d'appeler get-secret-value :

{{resolve:secretsmanager:<secret-id>:<field-type>:<json-key>:<version-stage>}}

Utilisez asm-exec pour exécuter des commandes avec des secrets

asm-execest un script wrapper qui résout les {{resolve:...}} références dans les arguments de commande, puis exécute la commande cible. La valeur secrète n'existe que dans le processus enfant.

asm-exec -- <command> [arguments with {{resolve:...}} references]

asm-execrésout les références via le premier backend disponible :

asm-exec -- psql \
  "host=mydb.example.com \
  user={{resolve:secretsmanager:prod/db-creds:SecretString:username}} \
  password={{resolve:secretsmanager:prod/db-creds:SecretString:password}}" \
  -c "SELECT * FROM users LIMIT 10"

asm-exec -- curl -H "Authorization: Bearer {{resolve:secretsmanager:prod/api-token}}" \
  https://api.example.com/data

asm-exec -- mysql \
  -h {{resolve:secretsmanager:prod/mysql:SecretString:host}} \
  -u {{resolve:secretsmanager:prod/mysql:SecretString:username}} \
  -p{{resolve:secretsmanager:prod/mysql:SecretString:password}} \
  -e "SHOW TABLES"

asm-exec -- docker run \
  -e "DB_PASSWORD={{resolve:secretsmanager:prod/db:SecretString:password}}" \
  myapp:latest

Cross-region secrets

Pour les secrets stockés dans une région différente de votre région par défaut, utilisez l'ARN complet (qui inclut la région) ou définissez la variable d'AWS_REGIONenvironnement.

# Using full ARN (region is extracted automatically)
asm-exec -- curl -H "X-Api-Key: {{resolve:secretsmanager:arn:aws:secretsmanager:eu-west-1:123456789012:secret:prod/key-a1b2c3}}" \
  https://eu.api.example.com/data

# Using AWS_REGION
export AWS_REGION=eu-west-1
asm-exec -- curl -H "X-Api-Key: {{resolve:secretsmanager:prod/key}}" \
  https://eu.api.example.com/data

Considérations sur la sécurité

Comment le crochet bloque l'accès secret direct

Lorsque le aws-core plugin est activé, un PreToolUse hook intercepte les appels à l'outil avant son exécution. Il bloque :

Lorsqu'un appel est bloqué, l'agent reçoit un message de refus lui demandant d'utiliser des {{resolve:...}} références à la asm-exec place.

Résolution des problèmes

Erreurs « Secret introuvable »

Vérifiez que le secret existe et que votre rôle IAM est secretsmanager:GetSecretValue autorisé. Les noms secrets distinguent les majuscules et minuscules.

AWS Informations d'identification de charge de travail : connexion du fournisseur

Le fournisseur d'informations d'identification de AWS charge de travail n'est peut-être pas en cours d'exécution. Cela n'est pas fatal : cela asm-exec se répercute sur le paramètre SigV4-signed MCP. Assurez-vous que les AWS informations d'identification sont disponibles afin que le backend puisse s'authentifier.

Erreurs « Impossible de résoudre »

Les deux backends étaient inaccessibles. Vérifiez que le fournisseur d'informations d'identification de AWS charge de travail est AWS actif ou que les informations d'identification sont valides (aws sts get-caller-identity), que la région du secret est correcte et que votre identité secretsmanager:GetSecretValue figure sur le secret.

La résolution produit une chaîne vide

La clé JSON n'existe peut-être pas dans la valeur secrète. Vérifiez la structure secrète dans la AWS console ou demandez au propriétaire du secret de confirmer les clés disponibles.

Hook ne bloque pas un appel

Les hooks se chargent au début de la session de l'agent. Si vous avez installé le plugin en cours de session, redémarrez la session de l'agent pour que le hook soit activé.