# PKI云服务 Java SDK

# 下载 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增加云证书吊销

下载该版本sdk

TIP

开发者直接使用我们提供的sdk,可以省略请求的封装，签名加密，响应解释等，提高开发效率。

← 识蛛云服务 Java SDK Android 活体SDK →