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.
Générer une clé d'API Amazon Bedrock
Vous pouvez générer une clé d'API Amazon Bedrock à l'aide de l'API AWS Management Console ou de l' AWS API. Nous vous recommandons d'utiliser le AWS Management Console pour générer facilement une clé d'API Amazon Bedrock en quelques étapes.
Rubriques
Générez une clé d'API Amazon Bedrock à l'aide de la console
Pour générer une clé d'API Amazon Bedrock à l'aide de la console, procédez comme suit :
-
Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à https://console.aws.amazon.com/bedrock/
l'adresse. -
Dans le volet de navigation de gauche, sélectionnez les clés d'API.
-
Générez l'un des types de clés suivants :
-
Clé d'API à court terme : dans l'onglet Clés d'API à court terme, choisissez Générer des clés d'API à court terme. La clé expire à l'expiration de votre session de console (et pas plus de 12 heures) et vous permet de passer des appels vers la console à partir de Région AWS laquelle vous l'avez générée. Vous pouvez modifier la région directement dans la clé générée.
-
Clé d'API à long terme : dans l'onglet Clés d'API à long terme, choisissez Générer des clés d'API à long terme.
-
Dans la section Expiration de la clé API, choisissez un délai après lequel la clé expirera.
-
(Facultatif) Par défaut, la politique AmazonBedrockLimitedAccess AWS gérée, qui donne accès aux principales opérations de l'API Amazon Bedrock, est attachée à l'utilisateur IAM associé à la clé. Pour sélectionner d'autres politiques à associer à l'utilisateur, développez la section Autorisations avancées et sélectionnez les politiques que vous souhaitez ajouter.
-
Sélectionnez Generate (Générer).
Avertissement
Nous recommandons vivement de restreindre l'utilisation de clés à long terme pour explorer Amazon Bedrock. Lorsque vous serez prêt à intégrer Amazon Bedrock dans des applications présentant des exigences de sécurité plus strictes, vous devriez consulter la documentation suivante :
-
Pour en savoir plus sur les alternatives préférables aux clés à long terme, consultez la section Alternatives aux clés d'accès à long terme dans le guide de l'utilisateur IAM.
-
Pour savoir comment surveiller les clés à long terme afin de prévenir les failles de sécurité, consultez la section Gérer les clés d'accès pour les utilisateurs IAM dans le guide de l'utilisateur IAM.
-
-
Générez une clé d'API Amazon Bedrock à l'aide de l'API
Nous vous recommandons d'utiliser le AWS Management Console pour générer des clés d'API Amazon Bedrock afin de faciliter l'expérience. Cependant, vous pouvez également générer des clés via l'API. Développez la section correspondant à votre cas d'utilisation.
Les étapes générales pour créer une clé d'API Amazon Bedrock à long terme dans l'API sont les suivantes :
-
Créez un utilisateur IAM en envoyant une CreateUserdemande avec un point de terminaison IAM.
-
Attachez-le AmazonBedrockLimitedAccessà l'utilisateur IAM en envoyant une AttachUserPolicydemande avec un point de terminaison IAM. Vous pouvez répéter cette étape pour associer d'autres politiques gérées ou personnalisées selon les besoins à l'utilisateur.
Note
Pour des raisons de sécurité optimales, nous vous recommandons vivement d'associer des politiques IAM à l'utilisateur IAM afin de restreindre l'utilisation des clés d'API Amazon Bedrock. Pour des exemples de politiques limitées dans le temps et de restriction des adresses IP autorisées à utiliser la clé, voir Contrôler l'utilisation des clés d'accès en attachant une politique intégrée à un utilisateur IAM.
-
Générez la clé d'API Amazon Bedrock à long terme en envoyant une CreateServiceSpecificCredentialdemande avec un point de terminaison IAM et en spécifiant
bedrock.amazonaws.com
comme.ServiceName
-
La
ServiceApiKeyValue
réponse renvoie votre clé API Amazon Bedrock à long terme. -
Les
ServiceSpecificCredentialId
informations renvoyées dans la réponse peuvent être utilisées pour effectuer des opérations d'API liées à la clé.
-
Pour savoir comment générer une clé d'API Amazon Bedrock à long terme, choisissez l'onglet correspondant à votre méthode préférée, puis suivez les étapes suivantes :
Vous pouvez générer une clé d'API Amazon Bedrock à court terme qui dure aussi longtemps que la session utilisée pour la générer (et pas plus de 12 heures).
Prérequis
-
Assurez-vous que votre configuration permet à Python de reconnaître automatiquement vos AWS informations d'identification. Pour en savoir plus, consultez Configuration des paramètres pour AWS CLI.
-
Ouvrez un terminal et téléchargez le générateur de jetons Amazon Bedrock à l'aide de la commande correspondant au SDK que vous utilisez :
-
Python
python3 -m pip install aws-bedrock-token-generator
-
JavaScript
npm install @aws/bedrock-token-generator
-
-
Assurez-vous que l'identité IAM que vous utilisez pour effectuer des appels d'API dispose au minimum des autorisations nécessaires pour assumer un rôle et créer une session de rôle :
-
L'identité IAM doit disposer des autorisations nécessaires pour assumer le rôle. Si l'identité possède des autorisations restreintes, vous pouvez associer la politique d'identité suivante à l'identité (remplacez-la
${arn:aws:iam::111122223333:role/SessionRole}
par l'ARN réel du rôle pour la session) :{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "
${arn:aws:iam::111122223333:role/SessionRole}
" } ] }Pour plus d'informations sur l'octroi à une identité des autorisations lui permettant d'assumer un rôle, voir Accorder à un utilisateur l'autorisation de changer de rôle.
-
Le rôle IAM doit disposer d'une politique de confiance permettant à l'identité IAM de l'assumer. Vous pouvez associer la politique de confiance suivante à un rôle IAM pour permettre au principal spécifié dans le
Principal
champ d'assumer le rôle de création de la clé. Cet exemple indique qu'un utilisateur IAM est le principal. Remplacez-le par l'ARN réel de l'utilisateur.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "
${arn:aws:iam::111122223333:user/UserId}
" }, "Action": "sts:AssumeRole" } ] }Pour plus d'informations sur les principes, voir Éléments de politique AWS JSON : Principal. Pour savoir comment mettre à jour une politique de confiance pour un rôle, voir Mettre à jour une politique de confiance de rôle.
-
Choisissez l'onglet correspondant au SDK que vous utilisez et exécutez le script pour générer une clé d'API Amazon Bedrock à court terme à partir des informations d'identification de votre session :
Note
Les autorisations associées à la clé à court terme se situeront à l'intersection des autorisations suivantes :
-
Les autorisations associées à la session utilisées pour générer la clé.
-
Les autorisations accordées par le AmazonBedrockLimitedAccess.