签发与管理临时只读凭据
本页内容
为一个指定应用签发限时只读 AccessKey,供另一个服务执行必要查询。临时凭据的权限、来源和期限不能超过原长期凭据的授权。
何时使用临时凭据
需要让另一个服务在短时间内读取一个应用,又不希望交付长期 Secret 时,使用临时只读凭据。它不用于上传、付款、下载凭证签发或提交签名。需要终端用户授权时,选择OAuth。
前提条件
使用获准签发会话的长期 AccessKey,选择一个已授权的自有应用,并确认要交付的读取动作、来源 IP、调用频率和有效期限。临时授权不能扩大原权限。
签发并安全交付
- 为本次签发保存幂等键,填写应用、名称、只读动作和必要限制。
- 调用 签发单应用只读凭据,检查首次响应中的
credentials。 - 将 AccessKey ID、Secret 和安全令牌作为一组,通过受保护的服务端通道交付。不要将响应打印到日志。
Python SDK
def create_readonly_session(client, app_id, actions, networks, write_key):
return client.create_session(
app_id, "只读查询服务", actions, 300, write_key,
networks=networks, rpm=60,
)["data"]
# 首次成功响应中的 credentials 需作为一组安全交付,不输出到日志。
def revoke_readonly_session(client, app_id, access_key_id, write_key):
return client.revoke_session(app_id, access_key_id, write_key)["data"]示例中的 300 秒和每分钟 60 次是一次申请的示例值;实际可申请范围及最终授权以接口和账号配置为准。
使用临时凭据
接收方用同一组 ID、Secret 和安全令牌初始化 SDK。签名请求需携带 X-Api-Security-Token,且令牌摘要参与 CS1 签名。不要把长期 ID 与临时令牌混用。
使用前检查到期时间。原长期授权收缩或被撤销后,临时读取也会受到限制。
查询和撤销
使用签发它的长期凭据调用 列出已签发的只读凭据查看该应用的会话。用途结束后,用返回的完整临时 AccessKey ID 调用 撤销单个只读凭据,并让接收方停止请求。
处理响应丢失
同一次签发重试沿用原请求和原幂等键,但幂等回执不会重新交付 Secret。响应丢失且拿不到完整凭据时,先查询并撤销不再可用的会话;确需重新交付时,明确发起新的签发操作。