全部产品
Search
文档中心

密钥管理服务:更换ClientKey

更新时间:Jan 09, 2024

ClientKey的有效期可设置为1年~5年,建议您对ClientKey按一年为周期定期更换。如果您的ClientKey即将到期,请您务必及时更换,否则应用将无法正常访问KMS。本文介绍如何更换ClientKey。

步骤一:创建一个新的ClientKey

  1. 登录密钥管理服务控制台,在顶部菜单栏选择地域后,在左侧导航栏单击应用接入 > 接入点

  2. 单击应用接入页签,通过实例ID或者应用接入点名称筛选,定位到目标应用接入点。

  3. 单击应用接入点名称,在详情页面单击身份凭证页签后,单击创建凭证

  4. 创建凭证对话框设置Client Key加密口令有效期

    • Client Key加密口令:8~64位,支持数字、英文大小写、特殊字符~!@#$%^&*?_-

    • 有效期:默认为5年,建议您设置为1年,以降低ClientKey被泄露的风险。

  5. 单击确定,浏览器会自动下载ClientKey。

    ClientKey包含应用身份凭证内容(ClientKeyContent)凭证口令(ClientKeyPassword)应用身份凭证内容(ClientKeyContent)文件名默认为clientKey_****.json凭证口令(ClientKeyPassword)文件名默认为clientKey_****_Password.txt

步骤二:更换自建应用中的ClientKey

KMS实例SDK for Java为例,初始化Client实例时,你需要将clientKeyPass替换为新的凭证口令clientKeyFilePathclientKey替换为新的应用身份凭证内容

步骤三:观察旧ClientKey是否仍有调用

您可以通过观察旧ClientKey是否仍有调用,判断ClientKey是否已经全部更换。确认没有调用后,对于不使用的ClientKey请及时删除。

  1. 获取旧ClientKey的Key IDimage.png

  2. 在左侧导航栏单击安全运营 > 日志服务,选择您的实例ID。

  3. 在搜索框中输入ClientKey的Key ID,查询旧ClientKey是否仍有调用。image.png

    如果仍有调用,说明ClientKey未更换完全,您可以根据client_ipuseragent等字段的信息追溯是哪些应用未替换。

步骤四:删除旧ClientKey

警告

ClientKey删除后立即生效,删除前请确保已不再使用,否则会导致应用无法访问KMS。

  1. 定位到旧ClientKey,单击操作列的删除

  2. 在弹出的删除Client Key对话框中确认无误后,单击确定

  3. 完成安全验证后,KMS会删除该ClientKey。