Identity as a Service:IDaaS を使用したエージェント ID セキュリティ

開発環境のセットアップ

• JDK 17 以降をインストールします。

• Maven をインストールします。

プロジェクトのパッケージ化

ターミナルで次のコマンドを実行します。

cd idaas-java-agent-id-demo
mvn clean package

環境変数の設定

次の例は Linux オペレーティングシステム用です。

export IDAAS_CLIENT_SECRET={client_secret}
export ENV_PRIVATE_KEY={private_key}
export JWKS_ENDPOINT=https://xxx.aliyunidaas.com/api/v2/iauths_system/oauth2/jwks
export AGENT_AUDIENCE=https://agentserver.example.com
export AGENT_SCOPE=agent.access
export ACCESS_IDENTITY=Machine
export LLM_API_KEY_IDENTIFIER=llm_api_key
export EXTERNAL_SERVER_API_KEY_IDENTIFIER=mcp_server_api_key
export ENTERPRISE_SERVICE_SCOPE="https://mcpserver.com|mcp.access"
export EXTERNAL_SERVER_URL=https://dashscope.aliyuncs.com/api/v1/mcps/amap-maps/mcp
export ENTERPRISE_SERVICE_URL=https://xxx.{region_id}.fcapp.run

JAR ファイルの実行

ターミナルで次のコマンドを実行します。

java -Dcloud_idaas_config_path=cloud_idaas_config_for_computer.json -jar target/idaas-java-agent-id-demo-1.0.jar

エージェントサンプルコードのパッケージ化と圧縮

ターミナルで次のコマンドを実行します。

cd idaas-java-agent-id-demo
mvn clean package
cd ../
zip -r idaas-java-agent-id-demo.zip idaas-java-agent-id-demo/

実行ロールの作成

1. Resource Access Management (RAM) コンソールにログインします。

2. ナビゲーションウィンドウで、Identities > Rolesを選択します。

3. ［ロール作成］をクリックします。［Principal Type］で［クラウドサービス］を選択します。［Principal Name］でFunction Compute (FC)を選択します。

4. ロール名をsample-fc-roleに設定します。

エージェントの作成

1. Function Compute (FC) コンソールにログインします。

2. 左側のナビゲーションウィンドウで、関数インテリジェンス > AgentRunを選択します。

3. ロール承認のプロンプトが表示されたら、承認をクリックします。これは初回のみ必要です。

4. エージェントの作成をクリックし、コードから作成を選択します。

5. コードソースでコードパッケージのアップロードを選択します。ランタイムでJava 17を選択します。

6. 圧縮されたidaas-java-agent-id-demo.zipファイルをアップロードします。

7. 次の起動コマンドを入力します。

   java -Dcloud_idaas_config_path=classpath:cloud_idaas_config_for_agent_run.json -jar idaas-java-agent-id-demo/target/idaas-java-agent-id-demo-1.0.jar

8. 起動ポートに9002を入力します。

9. 環境変数を構成します。

   パラメーター	説明	ソース
   IDAAS_CLIENT_SECRET	エージェントのクライアントシークレット認証情報。クライアントシークレット認証に必須です。	「エージェント ID セキュリティ構成ガイド」で作成したエージェントノードのGeneralセクションにあります。
   ENV_PRIVATE_KEY	エージェントの秘密鍵。公開鍵/秘密鍵認証に必須です。	これは、「エージェント ID セキュリティ構成ガイド」でエージェントノードの公開鍵/秘密鍵認証情報を作成する際にアップロードした公開鍵に対応する秘密鍵です。
   JWKS_ENDPOINT	IDaaS JWKS エンドポイント。	形式はhttps://xxx.aliyunidaas.com/api/v2/iauths_system/oauth2/jwksです。 xxxは、「ステップ 2：IDaaS SDK の構成」の SDK 構成ファイルのissuerフィールドの対応する値に置き換えます。
   AGENT_AUDIENCE	エージェントのオーディエンス。	「エージェント ID セキュリティ構成ガイド」で作成したエージェントノードのGeneralセクションにあります。
   AGENT_SCOPE	エージェントのスコープ。	「エージェント ID セキュリティ構成ガイド」で作成したエージェントノードのPermission Configurationセクションにあります。
   ACCESS_IDENTITY	エージェント ID モード：Machine（マシン ID）またはHuman（ユーザー ID）。	この例ではMachine（マシン ID）を使用します。これは、エージェントが独立して動作するシナリオに適しています。ダウンストリームサービスはエージェントのマシン ID を認識します。
   LLM_API_KEY_IDENTIFIER	大規模言語モデル API キー識別子。	「エージェント ID セキュリティ構成ガイド」で作成したLarge Language Model (LLM)ノードにあります。
   EXTERNAL_SERVER_API_KEY_IDENTIFIER	サードパーティサービス API キー識別子。	「エージェント ID セキュリティ構成ガイド」で作成したExternal Serviceノードにあります。
   ENTERPRISE_SERVICE_SCOPE	エンタープライズサービスアクセススコープ（オーディエンス|スコープ）。	"オーディエンス|スコープ" 形式を使用します。二重引用符を必ず含めてください。 「エージェント ID セキュリティ構成ガイド」で作成したEnterprise ServiceノードのGeneralのオーディエンスと、Permission ConfigurationのPermission Identifierを参照してください。
   EXTERNAL_SERVER_URL	サードパーティサービスエンドポイント。	Amap MCP Server HTTP エンドポイントです。Model Studio プラットフォーム内のAmap MCP で確認できます。
   ENTERPRISE_SERVICE_URL	エンタープライズサービスエンドポイント。	「3.2 JWT 認証の構成」で説明されているように、関数の詳細タブで、関数トポロジー図内のトリガーをクリックしてインターネットエンドポイントを確認します。

10. 実行ロールとして、前に作成したsample-fc-roleを選択します。

11. デプロイの開始をクリックします。

12. デプロイが完了したら、エージェントカードの[詳細]をクリックします。左側のナビゲーションウィンドウでバージョンとグレースケールを選択し、エンドポイントの作成をクリックします。