上传凭证

将上传凭证放置在请求表单中，参数名为：token。

构建上传凭证的三个基本数据源如下：

• 上传策略数据 (putPolicy)
  上传策略数据是在资源上传过程中提供的一组配置设置。通过这组配置信息，CDNetworks对象存储能够理解用户的上传需求：用户将上传哪些资源，上传到哪个存储空间，上传结果是回调通知还是使用重定向，反馈信息的内容是否需要设置，以及授权上传的有效期等。
• 安全密钥 (SecretKey)
  请从对象存储平台的密钥管理员获取SK。
• 访问密钥 (AccessKey)
  请从对象存储平台的密钥管理员获取AK。

上传凭证 uploadToken 是基于这三个基本数据源进行复杂签名计算的结果。通过验证上传凭证，我们可以确保阻止非法上传请求并防止非法入侵。

上传策略数据

数据格式

     {
      "scope": "<bucket string>",
      "deadline": "<deadline string>",
      "saveKey": "<saveKey string>",
      "returnUrl": "<returnUrl string>",
      "returnBody": "<returnBody string>",
      "overwrite": "<overwrite int>",
      "fsizeLimit": "<fsizeLimit long>",
      "callbackUrl": "<callbackUrl string>",
      "callbackBody": "<callbackBody string>",
      "persistentOps": "<persistentOps string>",
      "persistentNotifyUrl": "<persistentNotifyUrl string>",
      "contentDetect": "<contentDetect string>",
      "detectNotifyURL": "<detectNotifyURL string>",
      "detectNotifyRule": "<detectNotifyRule>",
      "separate": "<separate int>"
    }

格式说明

注意：

1. 在设置persistentOps字段时，请完成persistentNotifyUrl字段的设置。平台将通过调用persistentNotifyUrl字段中设置的URL来通知您指令处理的结果。详情请参阅通知数据内容说明。
2. 使用上传处理机制。设置persistentOps字段时，指令参数saveas是必需的，并且key可能与原始文件不同。否则，将返回401，并提示“The Persistent File Already Exists”。
3. 文件命名优先级如下：Scope中的key > saveKey > 表单key > 原始文件名。

上传凭证生成算法

1. 构建上传策略
使用JSON格式封装上传文件的信息putPolicy

     {
      "scope": "<bucket string>",
      "deadline": "<deadline string>",
      "returnBody": "<returnBody string>",
      "overwrite": "<overwrite int>",
      "fsizeLimit": "<fsizeLimit long>",
      "returnUrl": "<returnUrl string>"
    }

2. 上传策略的URL安全Base64编码

为putPolicy执行URL安全的Base64编码以获得encodePutPolicy

encodePutPolicy = urlsafe_base64_encode(putPolicy)

3. HMAC-SHA1 签名生成
使用SecretKey为encodePutPolicy提供HMAC-SHA1签名以获得Sign

Sign = hmac_sha1(encodePutPolicy, "<SecretKey>")

4. 签名数据的URL安全Base64编码
为签名数据Sign进行URL安全的Base64编码以获得encodedSign

encodeSign = urlsafe_base64_encode(Sign)

5. 生成上传凭证
使用 : 连接AccessKey, encodedSign和encodeputPolicy以获得上传凭证uploadToken

uploadToken = AccessKey:encodedSign:encodePutPolicy