Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Generar una clave de API de Amazon Bedrock
Puede generar una clave de API de Amazon Bedrock mediante la AWS Management Console o la AWS API. Le recomendamos que utilice la AWS Management Console para generar fácilmente una clave de API de Amazon Bedrock en unos pocos pasos.
Temas
Genere una clave de API de Amazon Bedrock mediante la consola
Para generar una clave de API de Amazon Bedrock mediante la consola, haga lo siguiente:
-
Inicie sesión AWS Management Console con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola Amazon Bedrock en https://console.aws.amazon.com/bedrock/
. -
En el panel de navegación izquierdo, selecciona Claves de API.
-
Genera uno de los siguientes tipos de claves:
-
Clave de API a corto plazo: en la pestaña Claves de API a corto plazo, selecciona Generar claves de API a corto plazo. La clave caduca cuando caduca la sesión de la consola (y no más de 12 horas) y te permite realizar llamadas a la fuente desde la Región de AWS que la generaste. Puede modificar la región directamente en la clave generada.
-
Clave de API a largo plazo: en la pestaña Claves de API a largo plazo, selecciona Generar claves de API a largo plazo.
-
En la sección de caducidad de la clave de API, elige una hora a partir de la cual caducará la clave.
-
(Opcional) De forma predeterminada, la política AmazonBedrockLimitedAccess AWS gestionada, que concede acceso a las operaciones principales de la API de Amazon Bedrock, se adjunta al usuario de IAM asociado a la clave. Para seleccionar más políticas para adjuntarlas al usuario, amplíe la sección de permisos avanzados y seleccione las políticas que desee añadir.
-
Seleccione Generar.
aviso
Recomendamos encarecidamente restringir el uso de claves de larga duración para la exploración de Amazon Bedrock. Cuando esté preparado para incorporar Amazon Bedrock en aplicaciones con mayores requisitos de seguridad, consulte la siguiente documentación:
-
Para obtener más información sobre las alternativas preferidas a las claves de largo plazo, consulte Alternativas a las claves de acceso a largo plazo en la Guía del usuario de IAM.
-
Para obtener información sobre cómo supervisar las claves de larga duración para evitar brechas de seguridad, consulte Administrar las claves de acceso para los usuarios de IAM en la Guía del usuario de IAM.
-
-
Genere una clave de API de Amazon Bedrock mediante la API
Le recomendamos que lo utilice AWS Management Console para generar las claves de API de Amazon Bedrock para una experiencia sencilla. Sin embargo, también puede generar claves a través de la API. Amplía la sección que corresponda a tu caso de uso.
Los pasos generales para crear una clave de API de Amazon Bedrock a largo plazo en la API son los siguientes:
-
Cree un usuario de IAM enviando una CreateUsersolicitud con un punto de enlace de IAM.
-
Adjunte el AmazonBedrockLimitedAccessnombre al usuario de IAM enviando una AttachUserPolicysolicitud con un punto final de IAM. Puede repetir este paso para adjuntar al usuario otras políticas administradas o personalizadas, según sea necesario.
nota
Como práctica recomendada de seguridad, le recomendamos encarecidamente que adjunte políticas de IAM al usuario de IAM para restringir el uso de las claves de API de Amazon Bedrock. Para ver ejemplos de políticas con plazos determinados y restringir las direcciones IP que pueden utilizar la clave, consulte Controlar el uso de las claves de acceso adjuntando una política en línea a un usuario de IAM.
-
Genere la clave de API de Amazon Bedrock a largo plazo enviando una CreateServiceSpecificCredentialsolicitud con un punto de enlace de IAM y especificándola
bedrock.amazonaws.com
como.ServiceName
-
La que se
ServiceApiKeyValue
devuelve en la respuesta es la clave de API de Amazon Bedrock a largo plazo. -
La
ServiceSpecificCredentialId
información devuelta en la respuesta se puede utilizar para realizar operaciones de API relacionadas con la clave.
-
Para obtener información sobre cómo generar una clave de API de Amazon Bedrock a largo plazo, elija la pestaña del método que prefiera y, a continuación, siga los pasos:
Puede generar una clave de API de Amazon Bedrock de corta duración que dure tanto como la sesión utilizada para generarla (y no más de 12 horas).
Requisitos previos
-
Asegúrese de que su configuración permita que Python reconozca automáticamente sus AWS credenciales. Para obtener más información, consulte Configurar los ajustes para AWS CLI.
-
Abre una terminal y descarga el generador de fichas de Amazon Bedrock con el comando que corresponda al SDK que estés utilizando:
-
Python
python3 -m pip install aws-bedrock-token-generator
-
Javascript
npm install @aws/bedrock-token-generator
-
-
Asegúrese de que la identidad de IAM que está utilizando para realizar llamadas a la API tenga permisos mínimos para asumir un rol y crear una sesión de rol:
-
La identidad de IAM debe tener permisos para asumir la función. Si la identidad tiene permisos restringidos, puede adjuntar la siguiente política basada en la identidad a la identidad (
${arn:aws:iam::111122223333:role/SessionRole}
sustituirla por el ARN real del rol de la sesión):{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "
${arn:aws:iam::111122223333:role/SessionRole}
" } ] }Para obtener más información sobre cómo conceder permisos de identidad para asumir un rol, consulte Otorgar permisos a un usuario para cambiar de rol.
-
El rol de IAM debe tener una política de confianza que permita que la identidad de IAM lo asuma. Puede adjuntar la siguiente política de confianza a una función de IAM para permitir que el director especificado en el
Principal
campo asuma la función de crear la clave. En este ejemplo, se especifica un usuario de IAM como principal. Sustitúyalo por el ARN real del usuario.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "
${arn:aws:iam::111122223333:user/UserId}
" }, "Action": "sts:AssumeRole" } ] }Para obtener más información sobre los principios, consulte Elementos de la política de AWS JSON: Principal. Para obtener información sobre cómo actualizar la política de confianza de un rol, consulta Actualizar la política de confianza de un rol.
-
Elija la pestaña que corresponda al SDK que esté utilizando y ejecute el script para generar una clave de API de Amazon Bedrock a corto plazo a partir de sus credenciales de sesión:
nota
Los permisos de la clave de corto plazo serán la intersección de los siguientes:
-
Los permisos adjuntos a la sesión utilizados para generar la clave.
-
Los permisos otorgados por AmazonBedrockLimitedAccess.