快速体验

最近更新时间:2018-12-05 17:06:42

简介

这里所有工具和 Demo 都存放在 Github 仓库

本文档将依次介绍用户服务端和用户客户端两个部分:

搭建用户服务端

在本示例中,用户服务端仅仅提供临时密钥的功能。cos_signer_lite 是一个基于 flask 服务框架的临时密钥服务,该项目采用 python3 编写,您可以在自己的机器或者虚拟机上运行该 Python 项目,为您的 COS 终端(Android/iOS)SDK 提供临时密钥服务。

注意:

该项目仅用于示例,不可直接用于生产环境,生产环境中您可以使用 COS 服务端 SDK 的临时密钥接口。

配置环境

cossign 目前只支持 Python3,它可以给您提供临时密钥服务,您可以直接使用 pip 命令进行安装。

pip3 install cossign

启动服务

安装完成后,您可以执行如下命令启动临时密钥服务。

cossign --secret_id your_secret_id --secret_key your_secret_key --port 5000

说明:

端口默认为5000,在执行命令时您可以不指定端口号。
密钥信息可以在 云 API 密钥控制台 查询。

测试服务

您可以通过浏览器访问 http://your_server_ip:5000/sign 链接,或者执行如下命令进行测试。

curl http://your_server_ip:5000/sign

如果返回如下信息,则说明服务已经成功运行。

{
 "code":0,
 "message":"",
 "codeDesc":"Success",
 "data":{
  "credentials":{
   "sessionToken":"634aa09dccc3274045ba413ec081c1df64007f0a30001",
   "tmpSecretId":"AKIDwxHZGTUvXAfcbLaOedJUQuwBXWUXG4m3",
   "tmpSecretKey":"kriDdZsOuuF9zrZPlSAVVG0Sg4RXZu6M"},
  "expiredTime":1530515889}
 }

排错指南

搭建临时密钥的过程中若出现错误,请参考以下指南进行排查。

  1. 问题:运行安装命令pip3 install flask提示comment not found pip3
    分析:因为没有安装 Python 3,或安装了 Python 3 但 path 没有设置正确。
    解决方案:可根据系统对应寻找 Python3 安装方式进行安装,或检查 path 设置。

  2. 问题:服务运行起来以后,获取临时密钥时提示URLError: urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed错误。
    解决方案:该问题常见于 MAC OS X 系统,安装 certifi 模块即可,具体操作方式可参考 Stack Overflow FAQ

搭建用户客户端

配置客户端

修改 QCloudCOSXMLDemo/QCloudCOSXMLDemo/TestCommonDefine.h 文件,填入 APPID 以及前面部署好的可以获取临时密钥的地址,然后执行如下命令。

pod install

执行命令之后,打开 QCloudCOSXMLDemo.xcworkspace 即可进入 Demo 体验。

运行示例 Demo

查询 Bucket 列表并创建 Bucket

1、启动示例 App 后,会展示目前所有可用的 Region,如下图所示。
choose region

2、选择对应某个 Region 进入以后会显示当前账号在该 Region 下面的所有 Bucket ,如下图所示。
bucket

您也可以在该界面单击右上角的创建 Bucket 按钮来在当前 Region 下面创建一个 Bucket,如下图所示。

上传文件

您可以依次单击最下面的按钮【相册】>【上传】>【暂停】>【续传】> 【取消】来进行上传测试,如下图所示。

下载文件

进入下载界面后,显示出当前 Bucket 内的所有文件,单击 【下载】进行下载测试,如下图所示。