View a markdown version of this page

API キーを追加する - Amazon Bedrock AgentCore

API キーを追加する

API キーは、安全なストレージ機能を使用した直接キーアクセスを必要とするサービスのキーベースの認証を提供します。API キーは、リソースへのアクセスを認証および認可するために使用される一意の識別子です。これにより、エージェントはアプリケーションコードに直接機密情報を埋め込むことなく外部サービスにアクセスできます。

API キーを追加するには

  1. AgentCore Identity コンソールを開きます。

  2. アウトバウンド認証セクションで、OAuth クライアント/API キーの追加を選択し、API キーの追加を選択します。

  3. Name には、自動生成された名前を使用するか、独自のわかりやすい名前を入力して、アカウントでこの API キーを識別するのに役立ちます。英数字、ハイフン、アンダースコアのみを使用し、最大長は 50 文字です。

  4. API キーの選択方法では、次のいずれかのオプションを選択します。

    1. API キーを指定する – API キー値を直接入力します。

      1. API キーには、外部サービスによって提供されるキー値を入力します。AgentCore Identity は、この値を安全に保存し、実行時にエージェントに使用できるようにします。

    2. Secrets Manager 経由で API キーを提供する – 値を直接入力するのではなく、Secrets Manager に保存されているシー AWS クレットを参照します。

      1. Secrets Manager で、API キーを含む Secrets Manager シークレットの ARN を入力または選択します。

      2. JSON キーの場合は、API キー値を含む Secrets Manager シークレットに JSON キーを入力します。

  5. [Add] (追加) を選択します。

API キーを作成した後、AgentCore Identity はエージェントコードで参照できる ARN を提供し、アプリケーションで機密情報を公開することなく、保存されたキーにアクセスできます。この ARN は、API キーのプロパティページにあります (アウトバウンド認証セクションで API キー名を選択します）。