ufile-sdk-auth-server

说明

• 该项目用于Ufile SDK接入远端签名时使用
• 您需要clone对应语言的源码，在项目中配置public key和private key，避免了部分平台的SDK（特别是android和iOS平台）会将private key放在本地的不安全性。

接口说明

请求对象操作的API签名

• URL: http://your_domain/applyAuth

• http method: POST

• Content-Type: application/json

• Request Body:

  {
      /**
       * Required
       * 你请求的Ufile API的Http Method
       */
      "method":"PUT",
      /**
       * Required
       * 你想操作的Bucket名称
       */
      "bucket":"bucketName",
      /**
       * Optional
       * 你想操作的云端对象的名称
       */
      "key":"object's key name"
      /**
       * Optional
       * 你请求Ufile API时的Content-Type
       */
      "content_type":"application/octet-stream",
       /**
       * Optional
       * 你在请求上传类Ufile API时的数据的MD5
       */
      "content_md5":"",
       /**
       * Optional
       * 你请求的时间字符串，格式：yyyyMMddHHmmss
       */
      "date":"yyyyMMddHHmmss"
       /**
       * Optional
       * 签名服务额外可选参数，你可以将你部署的签名服务API的鉴权数据放在该字段，部分语言版本的Ufile SDK可配置签名额外参数。
       * 格式：Json字符串，注意Json中引号需要转义
       */
      "optional":"{\"your optional data json\":\"This is your data value\"}"
  }
  

• Response Body: 签名结果字符串

请求私有Bucket的对象下载链接签名

• URL: http://your_domain/applyPrivateUrlAuth

• http method: POST

• Content-Type: application/json

• Request Body:

  {
      /**
       * Required
       * 你请求的Ufile API的Http Method
       */
      "method":"GET",
      /**
       * Required
       * 你想操作的Bucket名称
       */
      "bucket":"bucketName",
      /**
       * Required
       * 你想操作的云端对象的名称
       */
      "key":"object's key name"
      /**
       * Required
       * 私有Bucket的Object的下载链接的失效时间
       * 失效时间: 当前时间加上一个有效时间, 单位：Unix time second
       */
      "expires":123456789,
      /**
       * Optional
       * 签名服务额外可选参数，你可以将你部署的签名服务API的鉴权数据放在该字段，部分语言版本的Ufile SDK可配置签名额外参数。
       * 格式：Json字符串，注意Json中引号需要转义
       */
      "optional":"{\"your optional data json\":\"This is your data value\"}"
  }
  

• Response Body: 签名结果字符串

PHP版本

该项目用于为UFile移动端SDK提供签名服务，具体原因在上面已经提及。此处对PHP版本加以说明。

目录说明

目录	说明
root/ufile-auth-server-php/FileOperateSign	文件操作签名接口
root/ufile-auth-server-php/FileAddressSign	获取私有bucket下文件url签名接口
root/ufile-auth-server-php/Auth_Config	配置bucket操作的公私钥

使用方法

只需把此签名服务部署到你的服务器，然后在移动端(此处以ios为例)使用服务端签名(我们不推荐在移动端使用本地签名，如果使用本地签名方式则无需用到此项目)，具体配置如下：

UFConfig *ufConfig = [UFConfig instanceConfigWithPrivateToken:nil publicToken:@"bucket公钥" bucket:@"bucket名称" fileOperateEncryptServer:@"http://your_php_server/FileOperateSign.php" fileAddressEncryptServer:@"http://your_php_server/FileAddressSign.php" proxySuffix:@"域名后缀"];
UFFileClient *fileClient =  [UFFileClient instanceFileClientWithConfig:ufConfig];