翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Bedrock API キーを生成する
Amazon Bedrock API キーは、 AWS Management Console または AWS API を使用して生成できます。を使用して AWS Management Console 、いくつかのステップで Amazon Bedrock API キーを簡単に生成することをお勧めします。
警告
Amazon Bedrock の探索には、Amazon Bedrock API キーの使用を制限することを強くお勧めします。セキュリティ要件が高いアプリケーションに Amazon Bedrock を組み込む準備ができたら、短期認証情報に切り替える必要があります。詳細については、IAM ユーザーガイドの「長期アクセスキーの代替」を参照してください。
トピック
コンソールを使用して Amazon Bedrock API キーを生成する
コンソールを使用して Amazon Bedrock API キーを生成するには、次の手順を実行します。
-
Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS Management Console を使用して にサインインします。次に、https://console.aws.amazon.com/bedrock
で Amazon Bedrock コンソールを開きます。 -
左側のナビゲーションペインで、API キーを選択します。
-
次のいずれかのタイプのキーを生成します。
-
短期 API キー – 短期 API キータブで、短期 API キーの生成を選択します。キーは、コンソールセッションの有効期限が切れる (12 時間以内) と期限切れになり、生成 AWS リージョン 元の を呼び出すことができます。リージョンは、生成されたキーで直接変更できます。
-
長期 API キー – 長期 API キータブで、長期 API キーの生成を選択します。
-
API キーの有効期限セクションで、キーの有効期限が切れる時間を選択します。
-
(オプション) デフォルトでは、コア Amazon Bedrock API オペレーションへのアクセスを許可する AmazonBedrockLimitedAccess AWS管理ポリシーが、キーに関連付けられた IAM ユーザーにアタッチされます。ユーザーにアタッチするポリシーをさらに選択するには、高度なアクセス許可セクションを展開し、追加するポリシーを選択します。
-
[Generate] (生成) を選択します。
警告
Amazon Bedrock の探索には、Amazon Bedrock API キーの使用を制限することを強くお勧めします。セキュリティ要件が高いアプリケーションに Amazon Bedrock を組み込む準備ができたら、短期認証情報に切り替える必要があります。詳細については、IAM ユーザーガイドの「長期アクセスキーの代替」を参照してください。
-
-
API を使用して長期的な Amazon Bedrock API キーを生成する
API で長期的な Amazon Bedrock API キーを作成する一般的な手順は次のとおりです。
-
IAM エンドポイントで CreateUser リクエストを送信して、IAM ユーザーを作成します。 https://docs.aws.amazon.com/general/latest/gr/iam-service.html
-
IAM エンドポイントで AttachUserPolicy リクエストを送信して、AmazonBedrockLimitedAccess を IAM ユーザーにアタッチします。 https://docs.aws.amazon.com/general/latest/gr/iam-service.htmlこのステップを繰り返して、必要に応じて他の管理ポリシーまたはカスタムポリシーをユーザーにアタッチできます。
注記
セキュリティのベストプラクティスとして、IAM ユーザーに IAM ポリシーをアタッチして、Amazon Bedrock API キーの使用を制限することを強くお勧めします。時間制限ポリシーの例とキーを使用できる IP アドレスの制限については、「インラインポリシーを IAM ユーザーにアタッチしてアクセスキーの使用を制御する」を参照してください。
-
IAM エンドポイントで CreateServiceSpecificCredential リクエストを送信し、 を
bedrock.amazonaws.comとして指定して、長期的な Amazon Bedrock API キーを生成しますServiceName。-
レスポンスで
ServiceApiKeyValue返される は、長期的な Amazon Bedrock API キーです。 -
レスポンスで
ServiceSpecificCredentialId返された を使用して、キーに関連する API オペレーションを実行できます。
-
長期 Amazon Bedrock API キーを生成する方法については、任意の方法のタブを選択し、ステップに従います。
クライアントライブラリを使用して短期 Amazon Bedrock API キーを生成する
短期キーには次のプロパティがあります。
-
次の値のうち短い方に有効です。
-
12 時間ごと
-
キーの生成に使用される IAM プリンシパルによって生成されたセッションの期間。
-
-
キーの生成に使用されるプリンシパルにアタッチされたアクセス許可を継承します。
-
生成元の AWS リージョンでのみ使用できます。
長時間実行されるアプリケーションの場合、aws-bedrock-token-generator
前提条件
-
キーの生成に使用する IAM プリンシパルが、Amazon Bedrock を使用するための適切なアクセス許可で設定されていることを確認します。実験のために、 AWS管理の AmazonBedrockLimitedAccess ポリシーをプリンシパルにアタッチできます。認証情報の保護については、IAM のセキュリティのベストプラクティスを参照してください。
-
セットアップにより、Python が AWS 認証情報を自動的に認識できることを確認します。認証情報を取得するデフォルトの方法は、定義された階層に従います。特定の SDK またはツールの階層は、AWS SDKsおよびツールの標準化された認証情報プロバイダーで確認できます。
-
Amazon Bedrock トークンジェネレーターをインストールします。任意の方法のタブを選択し、ステップに従います。
例
トークンジェネレーターを使用して、デフォルトの認証情報を持つ短期 Amazon Bedrock API キーを異なる言語で生成する例を確認するには、任意の方法のタブを選択し、ステップに従います。
トークンの生成時のさまざまなユースケースのその他の例については、次のリンクを参照してください。
短期 Amazon Bedrock API キーの自動更新を設定する
aws-bedrock-token-generator パッケージを使用してスクリプトを作成し、現在の短期キーの有効期限が切れるたびにプログラムで新しい短期キーを再生成できます。まず、「」の前提条件を満たしていることを確認しますクライアントライブラリを使用して短期 Amazon Bedrock API キーを生成する。トークンを取得して Converse リクエストを行うスクリプトの例を表示するには、任意の方法のタブを選択し、ステップに従います。