IAM 临时凭据不是永久密钥:有效期、X-Security-Token 头与委托权限归属

举报
williamlewis 发表于 2026/11/06 15:20:40 2026/11/06
【摘要】 把 STS 临时安全凭证当永久 AK/SK 用,是客户端鉴权静默失败的高频原因。按华为云官方文档梳理三个必查点:duration_seconds 默认 15 分钟要显式设并提前刷新、securitytoken 必须走 X-Security-Token 头、AssumeAgency 切换委托时不评估原始用户权限。

给客户端下发云上访问凭证时,很多人图省事直接发一对永久访问密钥(AK/SK),客户端拿到就能一直用,代码里再一嵌,几年都不动。我现在的做法是:只要场景允许,优先走 IAM 的临时安全凭证(temporary security credentials,俗称 STS 临时凭据),把永久密钥留在服务端。这里把我实际配置时最容易踩的三个点理一遍,都有华为云官方文档依据。

先把「临时」到底临时在哪说清楚。按华为云 IAM 的用户手册,临时安全凭证的工作方式与永久访问密钥基本一致,但有几个关键差异:它是短期凭证,有效时间配置为几分钟到几小时,一旦到期,华为云将不再接受用它签名的 API 请求;它不会存储,而是动态生成,到期前只要用户仍拥有使用密钥的权限就可以再请求新的;它包含临时 AK/SK 和会话令牌 security_token,相比永久密钥,使用时除了用临时 AK/SK 对请求签名,还需要把 security_token 通过 X-Security-Token 请求头传入。这三条差异,条条对应一类线上故障。

第一点是有效期。获取临时访问密钥和 securitytoken 的接口 CreateTemporaryAccessKeyByToken,有效期由 duration_seconds 参数控制,取值范围 15 分钟到 24 小时,默认 15 分钟,响应里会给出 expires_at(UTC 时间格式,北京时间为 UTC+8 小时)。我建议显式传 duration_seconds,别依赖默认值——默认 15 分钟意味着客户端如果只在启动时取一次凭据、之后不再刷新,十几分钟后所有请求就会开始失败。稳妥的做法是在拿到凭据时解析 expires_at,提前一段时间(比如还剩几分钟时)触发刷新,而不是等报错再重取。官方对 Token 类凭证也有类似提示:使用前请确保离过期有足够时间,防止调用 API 的过程中过期导致失败。

第二点是 X-Security-Token 头。这是临时凭据和永久密钥在调用上最直接的区别,也是我见过的最高频的误配来源。如果服务端把临时 AK/SK 和 securitytoken 一起下发给客户端,客户端却按永久密钥的习惯只做签名、不把 securitytoken 塞进 X-Security-Token 头,鉴权就会失败。反过来,服务端下发时漏掉了 securitytoken 字段,客户端根本无从携带。所以我的习惯是:下发凭据的那一侧,把 access、secret、securitytoken、expires_at 四个字段当成一个整体一并交付,缺一个都不算交付完成;接收侧则确认 HTTP 客户端确实会带上这个头。

第三点是委托切换时的权限归属。华为云文档明确:使用 AssumeAgency API 生成的临时安全凭证访问华为云资源时,不会评估切换委托的原始用户的权限,即用户将临时放弃其原始权限,以支持切换委托或信任委托所分配的权限。这一点在做跨账号、跨主体的委托时尤其要留意——拿到临时凭据的主体,实际能做什么完全由委托(被委托方)的策略决定,而不是由「谁来发起这次切换」决定。所以给客户端配置权限时,要盯着委托的策略范围去收敛,而不是默认它会继承发起方的全部权限。

至于「为什么不用永久密钥」,华为云的使用访问凭证最佳实践其实给了很直接的答案:临时安全凭证相比永久访问密钥的优势包括不必随应用程序分配或嵌入永久访问密钥,以及生命周期较短、相比永久访问密钥更加安全。最佳实践里还有几条我照着做:不为华为账号创建访问密钥;不为仅需要访问控制台的 IAM 用户创建访问密钥;不将访问密钥明文嵌入代码;妥善保管、不随意分享、不记录在公开文档中。把这几条和上面的临时凭据方案放在一起看,结论是一致的——能下短时凭据就不要下永久密钥,永久密钥只留在服务端、尽量不落客户端。

最后一个我自己最容易忽略的常见误配:把临时凭据当成永久密钥做一次性下发后,就再没有任何刷新逻辑。临时安全凭证到期前,只要仍有使用密钥的权限就能请求新的;但很多客户端实现里根本没有「重新取凭据」这条路径,于是一次性拿到 15 分钟的凭据用一整天,中途整段业务静默失败。所以我在接入时会专门确认三件事:客户端知道这是临时凭据、客户端能解析 expires_at 并提前刷新、刷新失败有明确的重试与告警。这三件事补齐,临时凭据方案才算真正落地。

参考:

https://support.huaweicloud.com/api-iam/iam_04_0002.html

https://support.huaweicloud.com/intl/zh-cn/usermanual-iam5/iam_01_1236.html

https://support.huaweicloud.com/intl/en-us/usermanual-iam5/iam_01_1238.html

https://support.huaweicloud.com/topic/104871-5-M

https://support.huaweicloud.com/bestpractice-iam5/iam_05_0113.html

https://support.huaweicloud.com/api-iam/iam_03_0006.html

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。