View a markdown version of this page

Ajouter une clé API - Base rocheuse de l'Amazonie AgentCore

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajouter une clé API

Les clés API fournissent une authentification basée sur des clés pour les services qui nécessitent un accès direct par clé avec des fonctionnalités de stockage sécurisées. Une clé API est un identifiant unique utilisé pour authentifier et autoriser l'accès à une ressource, permettant à votre agent d'accéder à des services externes sans intégrer d'informations d'identification sensibles directement dans le code de votre application.

Pour ajouter une clé API

  1. Ouvrez la console AgentCore Identity.

  2. Dans la section Authentification sortante, choisissez Ajouter un client OAuth ou une clé API, puis choisissez Ajouter une clé API.

  3. Pour Nom, vous pouvez utiliser le nom généré automatiquement ou saisir votre propre nom descriptif pour vous aider à identifier cette clé API dans votre compte. Utilisez uniquement des caractères alphanumériques, des traits d'union et des traits de soulignement, avec une longueur maximale de 50 caractères.

  4. Pour la méthode de sélection de la clé API, choisissez l'une des options suivantes :

    1. Fournissez la clé API — Entrez directement la valeur de la clé API.

      1. Pour la clé API, entrez la valeur de clé fournie par votre service externe. AgentCore Identity stocke cette valeur en toute sécurité et la met à la disposition de votre agent au moment de l'exécution.

    2. Fournissez une clé API via Secrets Manager  : faites référence à un secret stocké dans AWS Secrets Manager au lieu de saisir directement la valeur.

      1. Pour Secrets Manager, entrez ou sélectionnez l'ARN du secret Secrets Manager qui contient votre clé API.

      2. Pour la clé JSON, entrez la clé JSON dans votre secret Secrets Manager qui contient la valeur de la clé API.

  5. Choisissez Ajouter.

Après avoir créé la clé API, AgentCore Identity fournit un ARN que vous pouvez référencer dans le code de votre agent pour accéder à la clé stockée sans exposer d'informations sensibles dans votre application. Vous pouvez trouver cet ARN dans la page des propriétés de la clé API (choisissez le nom de la clé API dans la section Outbound Auth).