JAVA-SDK

相关参考 Reference

  • 文档有奖反馈活动
  • 文档有奖反馈2
  • 功能发布记录
  • 捉虫活动获奖名单
  • 鉴权认证机制
    • 常见签名认证错误排查
    • 简介
    • 在URL中包含认证字符串
    • 在Header中包含认证字符串
    • 签名流程
    • Sample-Code
    • 生成V2认证字符串
    • 错误码
    • 生成认证字符串
  • SDK入门指南
    • Python-SDK帮助指南
    • PHP-SDK入门指南
    • Java-SDK入门指南
  • 区域选择说明
    • 区域
    • 可用区
  • API SDK
    • Java-SDK
  • 证书管理
    • 多用户访问控制
    • 管理证书
    • 格式转换
    • 简介
    • Python-SDK
    • GO-SDK
    • 上传证书
    • 证书和私钥
    • API参考
    • 常见问题
    • 第三方机构创建证书
    • 证书替换
    • JAVA-SDK
  • 企业组织
    • 退出组织
    • 账户联合认证(SSO)
    • 权限策略管理
    • 子账户管理
    • 产品介绍
    • 财务管理
    • 常见问题
    • 企业组织vs多用户访问控制
    • 权限评估逻辑
    • 创建企业组织
    • 系统限制
    • 组织单元
    • API参考
      • 通用说明
      • 企业组织管理接口
      • 邀请管理接口
      • 策略管理接口
      • 简介
      • 单元管理接口
      • 账户管理接口
      • 数据类型
  • API Key
    • 操作手册
    • 简介
    • API参考
  • 获取AKSK
    • 简介
    • 如何获取AKSK
  • 术语表
    • B
    • Z
    • F
    • G
    • C
    • H
    • P
    • L
    • T
    • M
    • I
    • Q
    • N
    • V
    • J
    • R
    • K
    • S
    • O
    • W
    • D
    • X
    • A
    • Y
    • E
所有文档
menu
没有找到结果,请重新输入

相关参考 Reference

  • 文档有奖反馈活动
  • 文档有奖反馈2
  • 功能发布记录
  • 捉虫活动获奖名单
  • 鉴权认证机制
    • 常见签名认证错误排查
    • 简介
    • 在URL中包含认证字符串
    • 在Header中包含认证字符串
    • 签名流程
    • Sample-Code
    • 生成V2认证字符串
    • 错误码
    • 生成认证字符串
  • SDK入门指南
    • Python-SDK帮助指南
    • PHP-SDK入门指南
    • Java-SDK入门指南
  • 区域选择说明
    • 区域
    • 可用区
  • API SDK
    • Java-SDK
  • 证书管理
    • 多用户访问控制
    • 管理证书
    • 格式转换
    • 简介
    • Python-SDK
    • GO-SDK
    • 上传证书
    • 证书和私钥
    • API参考
    • 常见问题
    • 第三方机构创建证书
    • 证书替换
    • JAVA-SDK
  • 企业组织
    • 退出组织
    • 账户联合认证(SSO)
    • 权限策略管理
    • 子账户管理
    • 产品介绍
    • 财务管理
    • 常见问题
    • 企业组织vs多用户访问控制
    • 权限评估逻辑
    • 创建企业组织
    • 系统限制
    • 组织单元
    • API参考
      • 通用说明
      • 企业组织管理接口
      • 邀请管理接口
      • 策略管理接口
      • 简介
      • 单元管理接口
      • 账户管理接口
      • 数据类型
  • API Key
    • 操作手册
    • 简介
    • API参考
  • 获取AKSK
    • 简介
    • 如何获取AKSK
  • 术语表
    • B
    • Z
    • F
    • G
    • C
    • H
    • P
    • L
    • T
    • M
    • I
    • Q
    • N
    • V
    • J
    • R
    • K
    • S
    • O
    • W
    • D
    • X
    • A
    • Y
    • E
  • 文档中心
  • arrow
  • 相关参考Reference
  • arrow
  • 证书管理
  • arrow
  • JAVA-SDK
本页目录
  • 概述
  • 安装SDK工具包
  • 创建CertClient(必做)
  • 方法列表
  • 1.创建证书
  • 2.获取证书列表
  • 3.获取单个证书的信息(不包含证书公钥私钥信息)
  • 4.重命名证书
  • 5.删除证书
  • 6.替换证书(证书id不变)
  • 版本说明
  • v1.0.0

JAVA-SDK

更新时间:2025-08-22

概述

本文档主要介绍证书管理模块Java SDK的安装和使用。

安装SDK工具包

运行环境

Java SDK工具包可在jdk1.8以上的环境下运行。

方式一:使用Maven安装

在Maven的pom.xml文件中添加bce-java-sdk的依赖:

Plain Text
1<dependency>
2<groupId>com.baidubce</groupId>
3<artifactId>bce-java-sdk</artifactId>
4<version>{version}</version>
5</dependency>

其中,{version}为版本号,可以在SDK下载页面找到。

方式二:直接使用JAR包安装

  1. 在官方网站下载Java SDK压缩工具包。
  2. 将下载的bce-java-sdk-version.zip解压后,复制到工程文件夹中。
  3. 在Eclipse右键“工程 -> Properties -> Java Build Path -> Add JARs”。
  4. 添加SDK工具包lib/bce-java-sdk-{version}.jar和第三方依赖工具包third-party/*.jar。 其中,version为版本号。

SDK目录结构

Plain Text
1com.baidubce
2├── auth                                        //BCE签名相关类
3├── http                                        //BCE的Http通信相关类
4├── internal                                    //SDK内部类
5├── model                                       //BCE公用model类
6├── services
7│       └── cert                                //证书管理服务相关类
8│           ├── model                           //证书管理服务内部model,如Request或Response
9│           └── CertClient.class                //证书管理服务客户端入口类
10├── util                                        //BCE公用工具类
11├── BceClientConfiguration.class                //对BCE的HttpClient的配置
12├── BceClientException.class                    //BCE客户端的异常类
13├── BceServiceException.class                   //与BCE服务端交互后的异常类
14├── ErrorCode.class                             //BCE通用的错误码
15└── Region.class                                //BCE提供服务的区域

创建CertClient(必做)

用户可以参考如下代码新建一个CertClient,需要传入aksk和endpoint(证书服务的url)

Plain Text
1String endpoint = "https://certificate.baidubce.com";                              // 服务url
2String accessKey = "your-access-key-id";                                           // 用户ak
3String secretKey = "your-secret-access-key";                                       // 用户sk
4CertClient certClient = CertClient.createCertClient(accessKey, secretKey, endpoint);

方法列表

1.创建证书

请求参数

参数名称 参数类型 是否必须 说明
certName String 必须 证书的名称。长度限制为1-65个字符,以字母开头,只允许包含字母、数字、’-‘、’/’、’.’、’’,Java正则表达式 ^[a-zA-Z]a-zA-Z0-9\-/\.]{2,64}$
certServerData String 必须 服务器证书的数据内容 (Base64编码)
certPrivateData String 可须 证书的私钥数据内容 (Base64编码),证书类型为1时必填
certLinkData String 可选 证书链数据内容 (Base64编码)
certType Integer 可选 证书类型,1表示服务端证书,2表示客户端证书,默认为1

返回值:CertCreateResponse

属性名 属性类型 说明
certId String 证书id
certName String 证书名

参考代码

Plain Text
1// 准备参数
2String certName = "Your-certificate-name"; 
3String certServerData = "Your-certificate-server-data";
4String certPrivateData = "Your-certificate-private-data";
5String certLinkData = "Your-certificate ";
6
7// 构造请求
8CertCreateRequest request = new CertCreateRequest();
9request.setCertName(certName);
10request.setCertPrivateData(certPrivateData);
11request.setCertServerData(certServerData);
12request.setCertLinkData(certLinkData);
13
14// 发出请求,获取结果
15CertCreateResponse createResponse = certClient.createCert(request);

可能异常

异常code 说明
CertExceedLimit (409) 超过用户最大证书数
UnmatchedPairParameterInvalidException (400) 证书有效时间不包含当前时间
PrivateKeyParameterInvalid (400) 私钥解析异常
CertificateParameterInvalid (400) 证书解析异常
CertChainParameterInvalid (400) 证书链解析异常
UnmatchedPairParameterInvalid (400) 公钥私钥不匹配

2.获取证书列表

请求参数:无

返回值:CertCreateResponse

属性名 属性类型 说明
certs List<CertificateMeta> 证书信息的列表

CertificateMeta

属性名 属性类型 说明
certId String 证书ID
certName String 证书名称
certCommonName String 证书通用名称
certStartTime DateTime 证书生效时间
certStopTime DateTime 证书到期时间
certCreateTime DateTime 证书创建时间
certUpdateTime DateTime 证书更新时间

参考代码

Plain Text
1// 发出请求,获取结果
2CertListResponse listResponse = certClient.listUserCerts();

3.获取单个证书的信息(不包含证书公钥私钥信息)

请求参数

参数名称 参数类型 是否必须 说明
certId String 必须 证书id

返回值:CertificateMeta

属性名 属性类型 说明
certId String 证书ID
certName String 证书名称
certCommonName String 证书通用名称
certStartTime DateTime 证书生效时间
certStopTime DateTime 证书到期时间
certCreateTime DateTime 证书创建时间
certUpdateTime DateTime 证书更新时间

参考代码

Plain Text
1// 准备参数
2String certId = "Your-cert-id";
3
4// 发出请求,获取结果
5CertificateMeta certificateMeta = certClient.getCertInfo(certId);

4.重命名证书

请求参数

参数名称 参数类型 是否必须 说明
certName String 必须 证书的名称。长度限制为1-65个字符,以字母开头,只允许包含字母、数字、’-‘、’/’、’.’、’’,Java正则表达式 ^[a-zA-Z]a-zA-Z0-9\-/\.]{2,64}$
certId String 必须 证书id

返回值:CertInServiceListResponse

属性名 属性类型 说明
certId String 证书id
certName String 证书名

参考代码

Plain Text
1// 准备参数
2String certId = "Your-cert-id";
3String newName = "Cert-new-name";
4
5// 发出请求
6certClient.updateCertName(certId, newName);

可能异常

异常code 说明
AccessDeniedException(403) 无权限访问
ResourceNotFoundException(404) 证书不存在

5.删除证书

请求参数

参数名称 参数类型 是否必须 说明
certId String 必须 证书id

返回值:无

参考代码

Plain Text
1// 准备参数
2String certId = "Your-cert-id";
3
4// 发出请求
5certClient.delete(certId);

可能异常

异常code 说明
OperationNotAllowedException(409) 证书使用中
AccessDeniedException(403) 无权限访问
ResourceNotFoundException(404) 证书不存在

6.替换证书(证书id不变)

请求参数

参数名称 参数类型 是否必须 说明
certId String 必须 证书id
certName String 必须 证书的名称。长度限制为1-65个字符,以字母开头,只允许包含字母、数字、’-‘、’/’、’.’、’’,Java正则表达式 ^[a-zA-Z]a-zA-Z0-9\-/\.]{2,64}$
certServerData String 必须 服务器证书的数据内容 (Base64编码)
certPrivateData String 可须 证书的私钥数据内容 (Base64编码),证书类型为1时必填
certLinkData String 可选 证书链数据内容 (Base64编码)
certType Integer 可选 证书类型,1表示服务端证书,2表示客户端证书,默认为1

返回值:无

参考代码

Plain Text
1// 准备参数  
2String certId = "Your-certificate-id";
3String certName = "Your-certificate-name"; 
4String certServerData = "Your-certificate-server-data";
5String certPrivateData = "Your-certificate-private-data";
6String certLinkData = "Your-certificate ";
7
8// 构造请求
9CertCreateRequest request = new CertCreateRequest();
10request.setCertName(certName);
11request.setCertPrivateData(certPrivateData);
12request.setCertServerData(certServerData);
13request.setCertLinkData(certLinkData);
14
15// 发出请求
16certClient.replaceCertData(certId, request);

可能异常

异常code 说明
OperationNotAllowedException(409) 证书使用中
AccessDeniedException(403) 无权限访问
ResourceNotFoundException(404) 证书不存在
UnmatchedPairParameterInvalidException (400) 证书有效时间不包含当前时间
PrivateKeyParameterInvalid (400) 私钥解析异常
CertificateParameterInvalid (400) 证书解析异常
CertChainParameterInvalid (400) 证书链解析异常
UnmatchedPairParameterInvalid (400) 公钥私钥不匹配

版本说明

v1.0.0

首次发布。

上一篇
证书替换
下一篇
企业组织