应用接入专属KMS标准版实例后,专属KMS标准版将使用租户独享的密码资源池(密码机集群),实现资源隔离和密码学隔离,为您的业务数据提供可靠、安全、合规的数据加密保护能力。本文介绍如何启用专属KMS标准版实例、如何创建密钥、以及如何让应用接入实例。

前提条件

操作流程

步骤一:启用专属KMS标准版实例

  1. 登录密钥管理服务控制台
  2. 专属KMS页面,找到目标专属KMS标准版实例,在操作列单击启用
  3. 连接密码机对话框,指定密码机集群。
    说明 一个专属KMS标准版实例只能绑定一个密码机集群。
  4. 配置访问凭据。
    专属KMS标准版实例与密码机连接时采用双向TLS认证,需要配置客户端证书(带保护口令的PKCS12格式证书)和安全域证书(为密码机集群签发TLS服务端证书的CA证书,PEM格式)。
    • 客户端保护口令:您在生成客户端证书client.p12时设置的保护口令。如果是使用证书文件生成工具(hsm_certificate_generate)生成,默认为12345678。
    • 客户端证书:PKCS12格式证书。单击选择文件,选择为密码机实例创建双向TLS认证中生成的client.p12文件进行上传。
    • 安全域证书:PEM格式CA证书。单击选择文件,选择为密码机实例创建双向TLS认证中生成的rootca.pem文件进行上传。
  5. 单击连接密码机
    请等待几分钟,然后刷新页面,当状态变更为已启用时,专属KMS标准版实例启用成功。

步骤二:为专属KMS标准版实例创建密钥

  1. 专属KMS页面,找到目标专属KMS标准版实例,单击操作列的管理
  2. 用户主密钥区域,单击创建密钥,在创建密钥对话框,配置以下参数后单击确定
    参数名称 说明
    密钥类型 密钥的类型。取值:
    • 对称密钥的类型:
      • Aliyun_AES_256
      • Aliyun_AES_128
      • Aliyun_AES_192
      • Aliyun_SM4
    • 非对称密钥的类型:
      • RSA_2048
      • RSA_3072
      • RSA_4096
      • EC_SM2
      • EC_P256
      • EC_P256KHMAC_SHA512
    密钥用途 密钥的用途。取值:
    • Encrypt/Decrypt:数据加密和解密。
    • Sign/Verify:产生和验证数字签名。
    别名 用户主密钥的标识符。支持英文字母、数字、下划线(_)、短划线(-)和正斜线(/)。
    描述 密钥的说明信息。
    高级选项
    • 密钥材料来源
      • 阿里云KMS:密钥材料将由专属KMS生成。
      • 外部:专属KMS将不会生成密钥材料,您需要将自己的密钥材料导入专属KMS。更多信息,请参见导入对称密钥材料
        说明 请仔细阅读并选中我了解使用外部密钥材料的方法和意义
    • 附加密钥用途:当密钥类型为非对称密钥时,支持设置附加密钥用途,让一个密钥具有多个用途。

步骤三:为专属KMS标准版实例创建凭据

如果您需要使用凭据管家的功能并在购买实例时设置了凭据数量,需要执行本步骤,否则跳过本步骤。

  1. 专属KMS页面,单击目标实例的实例ID后,单击凭据页签。
  2. 单击创建凭据,在创建凭据对话框中设置凭据名称、凭据值、初始版本号、描述信息和加密主密钥,单击下一步按照指引完成凭据创建。
    说明
    • 目前仅支持创建通用凭据。关于通用凭据的详细内容,请参见通用凭据概述
    • 凭据创建成功后,您可以构建定时轮转任务对通用凭据进行轮转。具体操作,请参见轮转通用凭据

步骤四:应用接入专属KMS标准版实例

  1. 创建应用接入点AAP(Application Access Point),控制应用正常访问专属KMS标准版实例。
    1. 专属KMS页面,找到目标专属KMS标准版实例,单击操作列的详情
    2. 应用接入指南区域,单击快速创建应用接入点
    3. 快速配置应用身份凭证和权限面板,设置应用接入点信息后,单击创建
      1. 输入应用接入点名称
      2. 设置访问控制策略
        • 允许访问资源:默认填写Key/*secret/*,表示允许访问当前专属KMS标准版实例的全部密钥和凭据。
        • 允许网络来源:允许访问的网络类型和IP地址。您可以设置私网IP地址或者私网网段,多个IP地址之间用半角逗号(,)分隔。
    4. 应用身份凭证对话框,获取凭证口令应用身份凭证内容(Client Key)。
      • 凭证口令:单击复制口令,获取凭证口令。
      • 应用身份凭证内容:单击下载应用身份凭证,保存应用身份凭证信息。

        应用身份凭证信息包含凭证ID(KeyId)和凭证内容(PrivateKeyData),凭证内容为PKCS12格式Base64编码。示例如下:

        {
          "KeyId": "KAAP.71be72c8-73b9-44e0-bb75-81ee51b4****",
          "PrivateKeyData": "MIIJwwIBAz****ICNXX/pOw=="
        }
        说明 KMS不会保存Client Key的凭证口令和应用身份凭证内容,您只能在创建Client Key时获取到该信息,请妥善保管。
    5. 单击关闭
  2. 获取CA证书,以便验证专属KMS标准版实例。
    应用接入指南区域,单击获取实例CA证书下方的下载,下载.pem格式的CA证书文件。

后续步骤

您可以使用专属KMS SDK,通过访问专属KMS API调用密钥管理服务。具体操作,请参见专属KMS Java SDK专属KMS PHP SDK专属KMS Go SDK专属KMS Python SDK