证书托管

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏选择“域名管理”，进入“域名管理”界面。
4. 在域名列表页，单击域名所在行区域右边“自定义域名HTTPS配置”旁边的“配置”按钮。
   图1 自定义域名HTTPS配置
   

   如果之前已配置HTTPS证书，可单击对应位置的“更改”按钮，修改证书配置。

5. 进入配置HTTPS页面，根据要求配置以下参数。

   

   表1 自定义域名的HTTPS配置

   参数分类	参数名称	参数说明
   状态	状态	选择是否启用HTTPS配置。 开关打开，表示启用HTTPS配置，实现自有域名HTTPS协议访问存储在OBS桶中的对象，提升域名访问安全性。 开关关闭，表示不启用HTTPS配置。
   证书配置	证书标准	支持国际证书、国密（SM）证书、CA证书。 国际证书：遵循国际标准的通用数字证书，由国际认可的证书颁发机构签发，主要用于验证持有者的身份，确保数据传输的安全性。 CA证书：又称客户端CA公钥证书，用于验证客户端证书的签发者，由证书颁发机构签发，用于验证身份和建立信任链，确保通信安全。在HTTPS双向认证功能时，只有当客户端能够出具指定CA签发的证书时，HTTPS连接才能成功。
   “证书标准”选择“国际证书”	证书	当“证书标准”选择“国际证书”时，支持配置该参数。 选择需要使用的SCM证书。云证书与管理服务（Cloud Certificate & Manager，简称CCM）提供的服务器数字证书。 如果您没有证书，可单击“购买证书”至CCM控制台购买证书，购买指导请参见购买SSL证书。 证书存在过期时间，请确保您选择的证书未过期。 证书到期时，请及时更换证书，否则可能对业务造成影响。
   “证书标准”选择“CA证书”	证书名称	当“证书标准”选择“CA证书”时，支持配置该参数。 不支持仅配置CA证书，请至少先配置一张国际证书。 您的证书名称。命名规则如下： 请输入中文、英文字符，下划线，中划线，英文逗号，英文句点。 长度为3~63字符。
   	证书文件	当“证书标准”选择“CA证书”时，支持配置该参数。 单击“上传”，选择上传符合格式的证书文件，或用本地文本查看工具打开证书，将证书内容复制到文本框中。 格式如下： 每行64个字符，最后一行不超过64个字符，不能有空行。 -----BEGIN CERTIFICATE----- Base64–encoded certificate -----END CERTIFICATE-----

6. 单击“确定”。

您可以使用API接口上传证书：

设置桶的自定义域名

获取桶的自定义域名

命令结构

• Windows操作系统

  obsutil custom-domain obs://bucket -method=put -cname=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统

  ./obsutil custom-domain obs://bucket -method=put -cname=xxx  [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

obsutil custom-domain obs://test-bucket -method=put -cname=www.obs-example.com 

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put customDomain configuration succeed for bucket [test-bucket], customDomain is [www.obs-example.com], requestId is [00000199765243C44018D688E9F5CFF5]

参数说明

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在桶列表中，单击待操作的桶，进入“对象”页面。
3. 选中待分享的文件，并单击右侧操作列的“分享”。
4. 在“分享文件”弹窗，设置相关参数。
   图2 分享文件
   

   表2 分享文件参数说明

   参数名称	说明
   URL有效期	文件URL的有效时间，超过有效期链接将失效。 URL有效期范围为1分钟~18小时，有效期内任何用户都可以通过URL直接访问该对象。如果要分享有效期时长更长的链接，建议使用OBS Browser+工具。 该弹窗打开时，链接信息已生效并开始计时，有效期默认为5分钟。修改URL有效期后会重新开始计时，同时链接信息会相应变化，您需要重新复制链接信息。
   用户协议	分享的链接使用的用户协议。默认为“https”。 如果您为自定义域名配置了HTTPS，建议您选择“https”。 http：适用于对安全性要求不高的场景。 https：适用于对安全性要求较高的场景。https通过SSL/TLS 协议对数据进行加密传输，保证数据的机密性和完整性；同时会基于证书验证服务器的身份，防止被攻击。
   自定义域名	选择分享链接是否使用自定义域名。此处选择为桶绑定的自定义域名，即分享的链接信息为使用自定义域名拼接成的链接。 由于内容分发网络（CDN）是实现公网的访问加速（任何用户均可访问CDN），因此如果自定义域名开启了CDN加速后，可能会造成分享链接永不超期，即任何用户在任何时间均可以访问对象。 如果自定义域名开启了CDN加速且在配置CDN节点缓存规则时，配置了忽略URL参数（CDN缓存时忽略请求URL中“?”之后的参数），将会导致分享链接无效。 说明： 分享链接信息中“?”后面的为鉴权信息，因此鉴权信息被忽略后，分享链接将会失效。

5. 分享对象。
   • 单击“打开URL”，将在新页面打开对象进行预览。
   • 单击“复制链接”，您可以将该链接分享给其他用户，用户可以在浏览器中通过此链接直接访问该对象。

1. 获取预签名URL。

   以下为常用语言的示例代码：

   • Java

     import com.obs.services.ObsClient;
     import com.obs.services.ObsConfiguration;
     import com.obs.services.model.HttpMethodEnum;
     import com.obs.services.model.TemporarySignatureRequest;
     import com.obs.services.model.TemporarySignatureResponse;
     public class GetObject001 {
         public static void main(String[] args) {
             // 您可以通过环境变量获取访问密钥AK/SK，也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
             // 您可以登录访问管理控制台获取访问密钥AK/SK
             String ak = System.getenv("ACCESS_KEY_ID");
             String sk = System.getenv("SECRET_ACCESS_KEY_ID");
             // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。
             // 您可以通过环境变量获取访问密钥AK/SK/SecurityToken，也可以使用其他外部引入方式传入。使用临时访问密钥调用接口可将下面一行的注释取消。
             // String securityToken = System.getenv("SECURITY_TOKEN");
     
             // endpoint填写桶的自定义域名,如果配置了自定义域名证书，可以修改为https。
             String endPoint = "http://example.domain";
             // 您可以通过环境变量获取endPoint，也可以使用其他外部引入方式传入。
             //String endPoint = System.getenv("ENDPOINT");
     
             ObsConfiguration obsConfiguration = new ObsConfiguration();
             obsConfiguration.setCname(true);
             obsConfiguration.setEndPoint(endPoint);
             try {
                 // 创建ObsClient实例
                 // 使用永久AK/SK初始化客户端
                 ObsClient obsClient = new ObsClient(ak, sk, obsConfiguration);
                 // 使用临时AK/SK和SecurityToken初始化客户端
                 // ObsClient obsClient = new ObsClient(ak, sk, securityToken, obsConfiguration);
     
                 // URL有效期，3600秒
                 long expireSeconds = 3600L;
                 TemporarySignatureRequest request = new TemporarySignatureRequest(HttpMethodEnum.GET, expireSeconds);
                 request.setBucketName("examplebucket");
                 request.setObjectKey("objectname");
                 TemporarySignatureResponse response = obsClient.createTemporarySignature(request);
                 System.out.println("Getting object using temporary signature url:");
                 System.out.println("SignedUrl:" + response.getSignedUrl());
             } catch (Exception e) {
                 System.out.println("create temporary signature failed");
                 e.printStackTrace();
             }
         }
     }

   • Python

     from obs import ObsClient
     import os
     import traceback
     # 推荐通过环境变量获取AKSK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险
     # 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
     ak = os.getenv("AccessKeyID")
     sk = os.getenv("SecretAccessKey")
     # 【可选】如果使用临时AKSK和SecurityToken访问OBS，则同样推荐通过环境变量获取
     # security_token = os.getenv("SecurityToken")
     # server填写桶的自定义域名,如果配置了自定义域名证书，可以修改为https。
     server = "http://example.domain"
     # 创建obsClient实例
     obsClient = ObsClient(access_key_id=ak, secret_access_key=sk, server=server, is_cname=True)
     
     # 如果使用临时AKSK和SecurityToken访问OBS，需要在创建实例时通过security_token参数指定securityToken值
     #obsClient = ObsClient(access_key_id=ak, secret_access_key=sk, security_token=security_token, server=server, is_cname=True)
     
     try:
         # 生成下载对象的带授权信息的URL
         res = obsClient.createSignedUrl(method='GET', bucketName='bucketname', objectKey='objectkey', expires=3600)
         print('signedUrl:', res.signedUrl)
     except:
         print(traceback.format_exc())

2. 使用浏览器访问预签名URL。

1. 在左侧导航栏选择“域名管理”，进入“域名管理”界面。
2. 在域名列表页，单击域名所在行区域右边“自定义域名HTTPS配置”旁边的“更改”按钮。
3. 关闭状态开关，然后单击“确定”。

您可以使用API接口上传证书：

设置桶的自定义域名

获取桶的自定义域名

命令结构

• Windows操作系统

  obsutil custom-domain obs://bucket -method=put -cname=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统

  ./obsutil custom-domain obs://bucket -method=put -cname=xxx  [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

obsutil custom-domain obs://test-bucket -method=put -cname=www.obs-example.com 

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put customDomain configuration succeed for bucket [test-bucket], customDomain is [www.obs-example.com], requestId is [00000199765243C44018D688E9F5CFF5]

参数说明