# huaweicloud-CCM-PCA-CrlManager-java
**Repository Path**: HuaweiCloudDeveloper/huaweicloud-ccm-pca-crl-manager-java
## Basic Information
- **Project Name**: huaweicloud-CCM-PCA-CrlManager-java
- **Description**: 基于华为云java/go/python SDK，对云证书管理服务（CCM）服务下私有证书管理（PCA）的证书进行生命周期管理的代码示例。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master-dev
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-12-20
- **Last Updated**: 2025-06-16
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 1.简介
本示例基于华为云SDK V3.0版本开发，华为云提供了CCM服务端SDK，您可以直接集成服务端SDK来调用CCM的相关API，从而实现对CCM的快速操作。
该示例展示如何授予CCM服务OBS访问权限，以便开启CRL功能。
## 2.开发前准备
- 已 [注册](https://id1.cloud.huawei.com/UnifiedIDMPortal/portal/userRegister/regbyphone.html?themeName=red&access_type=offline&clientID=103493351&loginChannel=88000000&loginUrl=https%3A%2F%2Fauth.huaweicloud.com%2Fauthui%2Flogin.html%23&casLoginUrl=https%3A%2F%2Fauth.huaweicloud.com%2Fauthui%2FcasLogin&service=https%3A%2F%2Fauth.huaweicloud.com%2Fauthui%2FcasLogin&countryCode=cn&scope=https%3A%2F%2Fwww.huawei.com%2Fauth%2Faccount%2Funified.profile+https%3A%2F%2Fwww.huawei.com%2Fauth%2Faccount%2Frisk.idstate&reqClientType=88&state=94fc0f9f861b4f30a85ec1f463d35609&lang=zh-cn) 华为云，并完成 [实名认证](https://account.huaweicloud.com/usercenter/?region=cn-north-4#/accountindex/realNameAuth) 。
- 已具备开发环境 ，支持Java JDK 1.8及其以上版本。
- 已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见 [访问秘钥](https://support.huaweicloud.com/usermanual-ca/zh-cn_topic_0046606340.html)
- 已获取帐号相关信息，请在华为云控制台“我的凭证 > API凭证 ”页面上查看帐号信息，如帐号id，即domainId。具体请参见 [API凭证](https://support.huaweicloud.com/usermanual-ca/ca_01_0002.html) 。
## 3.安装sdk
您可以通过Maven方式获取和安装SDK，首先需要在您的操作系统中下载并安装Maven ，安装完成后您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。
使用服务端SDK前，您需要引入“huaweicloud-sdk-ccm”依赖，具体的SDK版本号请参见 [SDK开发中心](https://sdkcenter.developer.huaweicloud.com/?language=Java) 。
```xml
com.huaweicloud.sdk
huaweicloud-sdk-ccm
3.1.26
```
## 4.开始使用
### 4.1 导入依赖模块
```java
import com.huaweicloud.sdk.ccm.v1.CcmClient;
import com.huaweicloud.sdk.ccm.v1.model.CreateCertificateAuthorityObsAgencyRequest;
import com.huaweicloud.sdk.ccm.v1.model.CreateCertificateAuthorityObsAgencyResponse;
import com.huaweicloud.sdk.ccm.v1.model.ShowCertificateAuthorityObsAgencyRequest;
import com.huaweicloud.sdk.ccm.v1.model.ShowCertificateAuthorityObsAgencyResponse;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
```
### 4.2 初始化认证信息
```java
// 1.准备访问华为云的认证信息，PCA为全局服务
/*
* 基础认证信息：
* - ak: 华为云账号Access Key
* - sk: 华为云账号Secret Access Key
* - domainId: 华为云账号ID 详情见https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html
* 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
* 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
*/
String ak = System.getenv("HUAWEICLOUD_SDK_AK");
String sk = System.getenv("HUAWEICLOUD_SDK_SK");
String domainId = "";
final GlobalCredentials auth = new GlobalCredentials()
.withAk(ak)
.withSk(sk)
.withDomainId(domainId);
```
### 4.3 初始化云证书管理服务客户端
```java
// 2.初始化SDK，传入认证信息及CCM服务的访问终端地址
final CcmClient ccmClient = CcmClient.newBuilder().withCredential(auth).withEndpoint(ccmEndpoint).build();
```
#### 4.4 示例代码
```java
package com.huawei.demo;
import com.huaweicloud.sdk.ccm.v1.CcmClient;
import com.huaweicloud.sdk.ccm.v1.model.CreateCertificateAuthorityObsAgencyRequest;
import com.huaweicloud.sdk.ccm.v1.model.CreateCertificateAuthorityObsAgencyResponse;
import com.huaweicloud.sdk.ccm.v1.model.ShowCertificateAuthorityObsAgencyRequest;
import com.huaweicloud.sdk.ccm.v1.model.ShowCertificateAuthorityObsAgencyResponse;
import com.huaweicloud.sdk.ccm.v1.region.CcmRegion;
import com.huaweicloud.sdk.core.auth.GlobalCredentials;
public class CrlManagerDemo {
public static void main(String[] args) {
/*
* 基础认证信息：
* - ak: 华为云账号Access Key
* - sk: 华为云账号Secret Access Key
* - domainId: 华为云账号ID 详情见https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html
* - ccmEndpoint: 华为云CCM服务(PCA属于CCM下的微服务)的访问终端地址
* 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
* 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
*/
String ak = System.getenv("HUAWEICLOUD_SDK_AK");
String sk = System.getenv("HUAWEICLOUD_SDK_SK");
String domainId = "";
String ccmEndpoint = "";
// 1.准备访问华为云的认证信息，PCA为全局服务
final GlobalCredentials auth = new GlobalCredentials()
.withAk(ak)
.withSk(sk)
.withDomainId(domainId);
// 2.初始化SDK，传入认证信息及CCM服务的访问终端地址
final CcmClient ccmClient = CcmClient.newBuilder()
.withCredential(auth)
.withRegion(CcmRegion.CN_NORTH_4)
.withEndpoint(ccmEndpoint).build();
// 3.查询当前帐号是否已给CCM服务授予OBS的委托
boolean isHaveAgency = checkObsAgency(ccmClient);
// 4.当前帐号未给CCM服务授予OBS的委托时，可选择创建（当前帐号需要具备安全管理员权限）
// 若已授权，发起创建授权的请求也不会重复创建授权
if(!isHaveAgency) {
String agencyId = createObsAgency(ccmClient);
System.out.println(agencyId);
}
}
private static boolean checkObsAgency(CcmClient ccmClient) {
ShowCertificateAuthorityObsAgencyResponse response;
ShowCertificateAuthorityObsAgencyRequest request = new ShowCertificateAuthorityObsAgencyRequest();
try {
response = ccmClient.showCertificateAuthorityObsAgency(request);
} catch (Exception e) {
System.out.println("error info: " + e.getMessage());
return false;
}
return "true".equalsIgnoreCase(response.getAgencyGranted());
}
private static String createObsAgency(CcmClient ccmClient) {
CreateCertificateAuthorityObsAgencyResponse response;
CreateCertificateAuthorityObsAgencyRequest request = new CreateCertificateAuthorityObsAgencyRequest();
try {
response = ccmClient.createCertificateAuthorityObsAgency(request);
} catch (Exception e) {
System.out.println("error info: " + e.getMessage());
return null;
}
return response.getAgencyId();
}
}
```
## 5.参考
更多信息请参考[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CCM&api=CreateCertificateAuthority)
## 6.修订记录
| 发布日期 | 文档版本 | 修订说明 |
| :--------: | :------: | :----------: |
| 2022-12-25 | 1.0 | 文档首次发布 |
| 2023-11-14 | 1.1 | 修改凭证获取及注释 |