文档中心

智能体身份和权限管理平台

快速入门

出站授权：Agent 代表用户访问火山引擎资源

如果你的 Agent 需要访问火山引擎的云资源，可以通过智能体身份和权限管理平台为其配置一个专属的 IAM 角色，以实现对相关服务的安全调用授权。

前提条件

你已开通智能体身份和权限管理平台服务并完成授权。详情请参见开通智能体身份和权限管理平台并完成授权。

Agent Identity 配置

你需要在智能体身份和权限管理平台控制台完成用户池、客户端和用户的创建。

步骤一创建用户池

用户池是存放用户账号的容器。你的所有用户数据（用户名、密码、手机号等）都将存储在这里。

登录火山引擎智能体身份和权限管理平台。

在左侧导航栏，选择用户池。

单击右上角的新建用户池。

配置用户池参数。

用户池名称：输入易于识别的名称，例如 my-web-app-pool。

其他参数可保持默认。

单击确定。

步骤二创建客户端

为了让你的应用能够“连接”到刚才创建的用户池，你需要注册一个客户端。

在返回的页面单击新建客户端。

配置客户端基础信息。

客户端名称：my-webapp-client。

客户端类型：选择 Web 应用。

授权回调 URL：关键配置。这是用户登录成功后，Agent Identity 将用户送回你应用的地址。

本地调试示例：http://localhost:8000/callback

生产环境示例：https://agent.com/auth/callback

注意

此处配置的 URL 必须与你代码中配置的 Redirect URI 完全一致（包括末尾的斜杠），否则会产生 redirect_uri_mismatch 错误。

步骤三创建用户

创建一个测试账号，用于登录应用，验证流程。

在返回的页面单击新建用户。

配置用户信息。

用户名：testuser。

手机号：+86173********。

临时密码：设置一个符合以下要求的密码。

说明

密码必须包含数字、特殊字符、大小写字母。

长度至少为 8 位。

附加属性：设置一个附加属性（例如姓、名）。

点击确定。

访问控制配置

访问控制主要涉及子账号创建和角色创建。

步骤一创建火山引擎子账号并完成授权

登录火山引擎IAM控制台。

在页面左侧，选择身份管理>用户。

单击新建用户，选择通过用户名创建。

配置用户基本信息。

在信息填写栏填写用户名，其他信息为选填。

在登录设置栏勾选编程访问，并设置允许用户管理自己的 API 密钥。

单击下一步，选择直接添加权限，并勾选AdministratorAccess。

单击下一步，确认并保存配置。

在用户列表选择创建的用户，单击管理。

选择密钥，并开启Secret Access Key。

单击对应内容即可复制 Access Key ID 和 Secret Access Key。

步骤二配置 IAM 角色

为了让 Agent 能够安全地访问其他云资源，我们需要创建一个 IAM 角色并授予其适当的权限。

登录火山引擎IAM控制台。

在页面左侧，选择角色管理。

单击添加角色，参考以下配置。

选择信任身份：账号。

选择身份：当前账号。

单击下一步，设置角色名。

单击下一步，搜索策略IDReadOnlyAccess并勾选，作用范围设置为全局。

单击提交。

在角色列表单击创建的角色名称，查看详情。

复制角色 TRN 信息。

集成配置

在 Agent Identity 控制台或访问控制控制台获取以下信息，并将它们映射到你的环境配置文件中：

环境变量	说明	获取方式
OAUTH2_AUTHORIZATION_URL	OAuth 2.0 授权地址，形如https://auth.id.cn-beijing.volces.com/userpool/<user-pool-id>/autorize	Agent Identity 控制台 > 用户池详情页
OAUTH2_TOKEN_URL	OAuth 2.0 令牌地址，形如https://auth.id.cn-beijing.volces.com/userpool/<user-pool-id>/oauth/token
OAUTH2_USERINFO_URL	OAuth 2.0 用户信息地址,形如https://auth.id.cn-beijing.volces.com/userpool/<user-pool-id>/userinfo
OAUTH2_CLIENT_ID	客户端 ID	Agent Identity 控制台 > 用户池 > 客户端详情页
OAUTH2_CLIENT_SECRET	客户端密钥	Agent Identity 控制台 > 用户池 > 客户端详情页
AGENT_ROLE_TRN	Agent使用的 IAM 角色 TRN	IAM 控制台 > 角色详情页
VOLCENGINE_ACCESS_KEY	火山引擎 Access Key	IAM 控制台 > 用户详情页
VOLCENGINE_SECRET_KEY	火山引擎 Secret Key	IAM 控制台 > 用户详情页

应用相关配置并启动你的 Agent。

验证配置效果

当 Agent 需要调用火山引擎的 API 时，它向智能体身份和权限管理平台请求一个访问凭据。

首次调用：智能体身份和权限管理平台检测到没有该用户的有效授权，会返回一个重定向 URL。Agent 的前端需将用户重定向到此 URL，用户将在页面上登录并授权。授权成功后，智能体身份和权限管理平台会安全地保存 Refresh Token。

后续调用：Agent 再次请求访问凭据时，智能体身份和权限管理平台会利用已保存的 Refresh Token，在后台静默地为用户获取一个新的 Access Token，并返回给 Agent。Agent 即可用此令牌去调用火山引擎资源。

最近更新时间：2026.03.25 11:22:27

这个页面对您有帮助吗？

有用

无用