# PKI云服务 Java SDK
# 下载 SDK
下载地址
点击立即下载PKI Java SDK# 添加到本地仓库
如果是非maven形式项目,直接将jar包放入Dependencies依赖目录
如果是maven项目,可在终端窗口执行以下命令安装到本地仓库:
Linux & Mac:
mvn install:install-file -Dfile=jar文件绝对路径 \
-DgroupId=cn.unitid.matrix \
-DartifactId=matrix-pki-java-sdk \
-Dversion=版本号 \
-Dpackaging=jar
Windows:
mvn install:install-file -Dfile=jar文件绝对路径 -DgroupId=cn.unitid.matrix -DartifactId=matrix-pki-java-sdk -Dversion=版本号 -Dpackaging=jar
然后在Maven项目pom文件中添加依赖:
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>${commons-codec.version}</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>${commons-logging.version}</version>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk15on</artifactId>
<version>1.69</version>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcmail-jdk15on</artifactId>
<version>1.69</version>
</dependency>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcpkix-jdk15on</artifactId>
<version>1.69</version>
</dependency>
<dependency>
<groupId>cn.unitid.easypki</groupId>
<artifactId>jce</artifactId>
<version>${easypki-jce.version}</version>
</dependency>
<dependency>
<groupId>cn.unitid.matrix</groupId>
<artifactId>matrix-pki-java-sdk</artifactId>
<version>${matrix.pki.sdk.version}</version>
</dependency>
# 公共参数说明
在使用SDK提供的服务时,需要构建客户端(PkiClient),该客户端需要服务端URL、appKey、appSecret,URL为 服务器地址,用户需要提供准确且存在的appKey以及appSecret,该参数的作用是对当前请求进行签名,若无法通过 签名验证,该请求会被直接拦截,服务不提供后续请求服务。
# 开启关闭sdk错误日志
//开启日志
ApiLogger.setNeedEnableLogger(true);
//关闭日志
ApiLogger.setNeedEnableLogger(false);
# okhttp配置初始化
@Configuration
public class OkHttpConfig {
@Bean
public PkiClient pkiClient() {
// 提供的URL
String url = "https://api.spiderid.cn";
// 您的appKey
String appKey = "xxx";
// 您的appSecret
String appSecret = "xxxxxxxxxxxxxxxx";
PkiClient pkiClient = new PkiOkhttpClient(url,appKey,appSecret);
return pkiClient;
}
}
# SDK 版本变动记录
# 2023-12-07(3.4.10)
- kms增加云证书吊销
TIP
开发者直接使用我们提供的sdk,可以省略请求的封装,签名加密,响应解释等,提高开发效率。