快速入门

应用接入专属KMS基础版实例后,专属KMS将为您的业务数据和运行数据提供可靠、安全、合规的数据加密保护能力。本文为您介绍如何启用专属KMS基础版实例、如何创建密钥、以及如何让应用接入实例。

前提条件

步骤一:启用专属KMS基础版实例

购买专属KMS基础版实例后,您需要先启用专属KMS基础版实例,设置实例所在的专有网络和交换机信息,才能使用专属KMS基础版实例。

  1. 登录密钥管理服务控制台

  2. 在页面左上角的地域下拉列表,选择专属KMS基础版实例所在的地域。

  3. 在左侧导航栏,单击专属KMS

  4. 专属KMS页面,单击目标实例操作列的启用

  5. 启动专属KMS实例对话框,设置相关参数。

    • VPC ID:选择或输入专属KMS基础版实例所在地域下的专有网络ID。

    • VSwitch ID:专有网络下的交换机ID。

  6. 单击立即启用

    请等待15~30分钟,然后刷新页面,当状态变更为已启用时,专属KMS基础版实例启用成功。

  7. 如果您需要设置多VPC使用同一专属KMS实例,单击目标实例专有网络列下的加号图标,配置专有网络。

    待选专有网络中选中需要设置的专有网络,单击左箭头图标后,选择该VPC内的一个交换机,单击确定

    说明
    • 您可以单击目标实例操作列的详情,在服务规格中会显示当前实例支持关联的VPC数量。

    • 如果选择关联的VPC数量超过了关联资源限制,您可以根据控制台上的提示,单击前往购买升级专有网络数量的规格。

步骤二:为专属KMS基础版实例创建密钥

当专属KMS基础版实例处于已启用状态时,您可以为专属KMS基础版实例创建密钥,以便进行加密解密、签名验签等操作。

  1. 专属KMS页面,单击目标实例操作列的管理

  2. 用户主密钥区域,单击创建密钥

  3. 创建密钥对话框,设置以下参数,单击确定

    配置项

    说明

    密钥类型

    取值:

    • 对称密钥的类型:

      Aliyun_AES_256

    • 非对称密钥的类型:

      • RSA_2048

      • RSA_3072

      • EC_P256

      • EC_P256K

    关于密钥类型的详细内容,请参见密钥服务概述

    密钥用途

    取值:

    • Encrypt/Decrypt:数据加密和解密。

    • Sign/Verify:产生和验证数字签名。

    别名

    用户主密钥的标识符。支持英文字母、数字、下划线(_)、短划线(-)和正斜线(/)。

    描述

    密钥的说明信息。

步骤三:为专属KMS基础版实例创建凭据

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

  1. 专属KMS页面,单击目标实例的实例ID后,单击凭据页签。
  2. 单击创建凭据,在创建凭据对话框中完成凭据配置,单击下一步

    根据您的凭据类型不同,配置项不同。

    • 通用凭据

      配置项

      说明

      选择凭据类型

      选择通用凭据

      凭据名称

      输入自定义的凭据名称。

      设置凭据值

      根据您要托管的敏感数据类型,选择凭据键/值纯文本

      初始版本号

      凭据的初始版本号。默认为v1,也支持自定义版本号。

      描述信息

      输入凭据的描述信息。

      加密主密钥

      选择同实例的一个用户主密钥作为凭据的加密主密钥。

    • 托管RDS凭据

      配置项

      说明

      选择凭据类型

      选择托管RDS凭据

      凭据名称

      输入自定义的凭据名称。

      选择RDS实例

      选择阿里云账号下已有的RDS实例。

      设置凭据值

      • 双账号托管(推荐):适用于程序化访问数据库场景。托管两个相同权限的账号,保证口令重置切换的瞬间,程序访问不被中断。

        • 单击一键创建和授权页签,配置账号名、选择数据库并指定权限。

          说明

          一键创建和授权不会立即为您配置新的账号,而是在您审核确认凭据信息之后进行配置。

        • 单击导入已有账号页签,选择用户名、配置口令。

          说明

          建议您将口令配置为创建RDS实例用户账号时对应的密码。如果导入的账号和口令不匹配,您可以在凭据首次轮转之后,获取正确的账号和口令。

      • 单账号托管:适用于高权限账号或者人工运维账号托管场景。口令重置切换的瞬间,凭据的当前版本可能暂时无法使用。

        • 单击一键创建和授权页签,配置账号名、选择账号类型。

          您可以选择普通账号高权限账号两种账号类型。当您选择普通账号时,还需选择数据库并指定权限。

        • 单击导入已有账号页签,选择用户名、配置口令。

      描述信息

      输入凭据的描述信息。

      加密主密钥

      选择同实例的一个用户主密钥作为凭据的加密主密钥。

    • 托管RAM凭据

      配置项

      说明

      选择凭据类型

      选择托管RAM凭据

      选择RAM用户

      选择您要托管凭据的RAM用户,所选RAM用户需要至少有一个AccessKey。

      设置凭据值

      在AccessKey ID右侧输入对应的AccessKey Secret。

      说明

      建议您输入正确的AccessKey Secret。如果AccessKey Secret不正确,您将在RAM凭据首次轮转后获取一组新的AccessKey ID和AccessKey Secret。

      描述信息

      输入凭据的描述信息。

      加密主密钥

      选择同实例的一个用户主密钥作为凭据的加密主密钥。

    • 托管ECS凭据

      配置项

      说明

      选择凭据类型

      选择托管ECS凭据

      凭据名称

      输入自定义的凭据名称。

      托管实例

      选择阿里云账号下已有的ECS实例。

      托管用户

      填写ECS实例上已有的用户名称,例如:root(Linux系统)或Administrator(Windows系统)。

      初始凭据值

      选择口令密钥对,填入对应的初始凭据值。

      • 口令:用户登录ECS实例的密码。

      • 密钥对:用户登录ECS实例的SSH密钥对。

      说明

      建议输入正确的凭据值。如果输入的凭据值不正确,在ECS凭据首次轮转前,您从凭据管家获取到的口令或密钥对将不能正常登录ECS实例。

      描述信息

      输入凭据的描述信息。

      加密主密钥

      选择同实例的一个用户主密钥作为凭据的加密主密钥。

步骤四:应用接入专属KMS基础版实例

如果您需要使用专属KMS SDK对数据进行密钥运算,才需执行本步骤。当专属KMS基础版实例处于已启用状态时,您可以为专属KMS基础版实例快速创建应用接入点(AAP)和应用身份凭证(Client Key),以便应用程序正常访问专属KMS。您也可以获取专属KMS基础版实例CA证书,以便验证专属KMS基础版实例。

  1. 专属KMS页面,找到目标专属KMS基础版实例,在操作列单击详情

  2. 应用接入指南区域,单击快速创建应用接入点

  3. 快速配置应用身份凭证和权限面板,设置应用接入点信息。

    1. 输入应用接入点名称

    2. 设置访问控制策略

      • 允许访问资源:默认填写Key/*secret/*,表示允许访问当前专属KMS基础版实例的全部密钥和凭据。

      • 允许网络来源:允许访问的网络类型和IP地址。您可以设置私网IP地址或者私网网段,多个IP地址之间用半角逗号(,)分隔。

    3. 单击创建

  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. 单击关闭

    应用接入点创建成功后,您可以在左侧导航栏单击应用管理查看应用接入点信息,包括认证方式、权限策略、网络控制规则、Client Key等。您也可以更新应用接入点。具体操作,请参见管理应用接入点

  6. 应用接入指南区域,单击获取实例CA证书下方的下载,下载.pem格式的CA证书文件。

后续步骤

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