文档中心

AgentKit

请输入

凭据管理

凭据概述

当 Agent 需要以客户端身份调用外部服务或下游 API 时，通常需要携带对应的身份凭据，例如 API Key、OAuth Client 信息或云资源访问角色。为避免在代码、镜像、配置文件或运行参数中硬编码敏感信息，AgentKit 提供身份凭据托管能力，用于统一保存和管理 Agent 出站访问所需的凭据。

通过身份凭据托管功能，您可以将 Agent 调用外部系统时使用的出站（Outbound）凭据安全托管在平台。Agent 运行时可按需引用并获取对应凭据，由平台完成凭据读取、注入和权限边界控制，从而降低密钥泄露、误用和分散维护的风险。

支持的凭据类型

当前支持托管以下 3 类凭据：

API Key

适用于第三方服务提供的固定密钥。Agent 可通过凭据名称引用该密钥，并在出站请求中按需注入。了解更多

OAuth Client

适用于需要通过 OAuth2 授权访问外部服务的场景，例如代表用户或 Agent 获取短期访问令牌。了解更多

火山云角色

适用于 Agent 访问 TOS、方舟等火山引擎云资源的场景。平台可基于 Agent 身份换取 STS 临时凭证，避免使用长期固定密钥。了解更多

与密钥管理服务（KMS）的关系

为保障凭据安全，托管在身份凭据模块中的敏感信息不会以明文形式存储在智能体身份和权限管理平台中。对于 API Key、Client Secret 等敏感凭据，系统会通过火山引擎密钥管理服务（KMS）进行安全加密与存储，平台侧仅保存凭据引用及必要的元数据信息。

在 Agent 运行时，平台会根据凭据引用按需获取并使用对应凭据，确保敏感信息不直接暴露在业务代码和配置中。您也可以结合业务安全要求，在 KMS 中对凭据进行定期轮换，以降低长期密钥暴露风险，并满足审计、合规和密钥生命周期管理要求。

最近更新时间：2026.10.12 17:21:40

这个页面对您有帮助吗？

有用

无用