通过阿里云SDK(Java)使用KMS_密钥管理服务(KMS)-阿里云帮助中心

本文介绍如何安装阿里云SDK（Java）。

重要

阿里云SDK不仅支持通过调用OpenAPI执行创建实例、创建密钥等管控类操作，还支持执行加密解密、获取凭据值等业务类操作。其中管控类操作仅可通过共享网关访问，而业务类操作既支持通过共享网关也能通过专属网关访问。

在使用阿里云SDK前，请先详细了解其使用流程、网关差异、支持的API接口等，以便顺利将业务接入KMS。详细信息，请参见阿里云SDK。

前提条件

已购买和启用KMS实例。具体操作，请参见购买和启用KMS实例。
已完成密钥和凭据的创建。具体操作，请参见密钥管理快速入门、密钥管理快速入门、创建凭据。
说明
如果您的业务不涉及凭据，则无需创建凭据。
如果业务部署在非阿里云VPC，请开启公网开关，通过共享网关执行业务类操作。具体操作，请参见通过公网访问KMS实例中的密钥。
如果仅通过共享网关执行管控类操作，则无需开启公网开关。
如果业务部署在阿里云VPC，请通过专属网关执行业务类操作，并确保您的业务应用可以访问KMS实例VPC地址<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com。
- 业务应用和KMS实例在同一个地域，且属于同一个VPC：默认应用程序运行环境和KMS实例间网络互通。
- 业务应用和KMS实例在同一个地域，但属于不同VPC：您需要将该VPC配置到KMS实例中。具体操作，请参见同地域多VPC访问KMS实例。

已下载并安装Java 8或以上版本。

打开终端，输入java -version，查看Java（JDK）版本。

在项目中添加Maven依赖，从Maven仓库中自动下载Java安装包。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>kms20160120</artifactId>
  <version>1.2.3</version>
</dependency>

重要

建议您使用最新版本，访问kms-20160120了解更多版本和源代码信息。