Amazon Bedrock AgentCore Identity支持私有CA,可连接自托管身份提供商
AWS称,使用Keycloak、PingFederate等私有网络内身份提供商的团队,可将PEM格式CA证书存入Secrets Manager或S3,由AgentCore Identity校验IdP的发现、JWKS和令牌端点证书;该功能仅适用于配置了privateEndpoint的私有IdP,且依赖VPC Lattice。
AI解读:这条消息解决的具体问题是:自托管在私有网络里的IdP通常出示由私有CA签发的TLS服务器证书,此前AgentCore Identity无法信任这类证书。现在它接受把CA公钥证书(PEM,不含私钥)存入AWS Secrets Manager或S3,并在凭据提供商中引用。
适用范围有限制:凭据提供商或授权器必须配置privateEndpoint,否则请求会失败并提示该功能只能用于私有IdP;私有CA支持依赖VPC Lattice,只在AgentCore Identity支持私有IdP的Region提供。PEM文件不超过 16 KB,只能含有效期内的根或中间CA证书。
证书读取发生在创建或更新凭据提供商时,使用调用方的IAM权限,因此调用方需要对Secrets Manager密钥或S3对象有读权限;若用客户管理的KMS密钥加密,还需要kms:Decrypt。修改了存储内容后,必须调用UpdateOauth2CredentialProvider才会重新读取。
AWS说明AgentCore Identity不检查CRL,也不使用OCSP。若IdP服务器证书私钥泄露,它仍会信任该证书,直到证书过期或停止信任签发该证书的CA。轮换时可在同一PEM中同时放入新旧CA,更新后再替换服务器证书,最后只保留新CA。
AWS于 2025 年 11 月 10 日发布文章称,Amazon Bedrock AgentCore的AgentCore Identity能力现已支持私有证书颁发机构(CA),使AI代理能够连接使用私有CA证书的自托管身份提供商(IdP),例如Keycloak或PingFederate。
按文章描述,用户把PEM编码的CA证书存入AWS Secrets Manager或Amazon S3,并在凭据提供商中引用;该证书只含公钥,不含私钥,AgentCore Identity用它校验IdP的发现、JWKS和令牌端点所出示的服务器证书。该说法来自AWS官方博客。
适用条件与配置限制
AWS列出多项前提:凭据提供商或授权器必须设置privateEndpoint,否则请求会返回“私有证书颁发机构功能只能用于私有IdP”的错误;私有CA支持依赖Amazon VPC Lattice,且只在AgentCore Identity支持私有IdP的AWS Region提供。文章中的示例使用AWS Private CA签发证书、Keycloak作为IdP,并通过VPC Lattice的资源网关接入VPC。
- CA证书须为PEM编码、不超过 16 KB,且只包含有效期内的根或中间CA证书;上传服务器叶子证书会触发“Leaf certificates are not allowed”错误。
- 每个凭据提供商只引用一个Secrets Manager密钥或一个S3对象;需要信任多个CA时,把它们放进同一个PEM文件。
- Secrets Manager密钥须与凭据提供商在同一账号和同一Region;S3对象可跨账号,但需提供bucketOwnerAccountId,且桶策略授予访问权限。
- AgentCore Identity在创建或更新凭据提供商时读取证书,读取使用调用方的IAM权限:需要secretsmanager:GetSecretValue或s3:GetObject;若用客户管理的KMS密钥加密,还需kms:Decrypt。
- 新凭据提供商初始状态为CREATING,就绪后为READY;失败时failureReason字段会说明原因。
轮换、监控与信任边界
AWS建议监控CA证书到期时间并提前轮换,因为CA证书过期后,向IdP发起的令牌请求会停止工作。AgentCore Identity会在AWS/Bedrock-AgentCore命名空间向CloudWatch发布EarliestCertificateDaysToExpiry指标,表示PEM文件中最早到期的证书还剩多少天,并带有ProviderName、ProviderArn和TokenVault三个维度。
- 修改密钥或S3对象内容后,必须调用UpdateOauth2CredentialProvider并包含certificateConfigurations,否则凭据提供商将不再信任该私有CA。
- 轮换可先把当前和新CA证书合并进同一PEM并更新,待状态回到READY,再换用新CA签发的IdP服务器证书,最后上传仅含新CA的文件并再次更新。
- AWS明确说明AgentCore Identity不检查证书吊销列表(CRL),也不使用OCSP;若IdP服务器证书私钥被未授权方获取,它仍会继续信任该证书,直到证书过期或停止信任签发它的CA。
- AWS建议把写入权限限制给运维IdP的团队或流水线,读取权限给调用创建或更新凭据提供商的主体,并建议开启S3版本控制和CloudTrail数据事件。