在URL中攜帶參數

在URL中攜帶參數時，callback為必選參數，callback-var為可選參數。如果請求中出現了callback或callback-var，則在計算簽名時，需要將callback或者callback-var參數作為CanonicalizedResource的子資源。更多信息，請參見構建CanonicalizedResource的方法。

PUT /your_object?OSSAccessKeyId=LTAI5t7h6SgiLSga****&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv****&Expires=1682484377&callback-var=eyJ4Om15X3ZhciI6ICJ2YX****==&callback=bGxiYWNrVXJsIjogImh0dHA6Ly94eHgueHh4LjIyLjE0My90ZXN0IiwKICAgICJjYWxsYmFja0hvc3QiOiAieW91ci5jYWxsYmFjay5jb20iLAogICAgImNhbGxiYWNrQm9keSI6ICJidWNrZXQ9JHtidWNrZXR9Jm9iamVjdD0ke29iamVjdH0mbXlfdmFyPSR7eDpteV92YXJ9IiwKICAgICJjYWxsYmFja0JvZHlUeXBlIjogImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5jb2RlZCIsCiAgICAiY2FsbGJhY2tTTkkiOiBmYWxzZQp9 HTTP/1.1
Host: callback-test.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 26 Apr 2023 03:46:17 GMT
Content-Length: 5
Content-Type: text/plain

在Header中攜帶參數

在Header中攜帶參數時，需要將x-oss-callback或者x-oss-callback-var作為Header帶入請求發送。在計算簽名CanonicalizedOSSHeaders時，將x-oss-callback-var和x-oss-callback計算在內。

完整示例如下：

PUT /your_object HTTP/1.1
Host: callback-test.oss-test.aliyun-inc.com
Accept-Encoding: identity
Content-Length: 5
x-oss-callback-var: eyJ4Om15X3ZhciI6ICJ2YX****==
User-Agent: aliyun-sdk-python/0.4.0 (Linux/2.6.32-220.23.2.ali1089.el5.x86_64/x86_64;2.5.4)
x-oss-callback: ewogICAg****bGxiYWNrVXJsIjogImh0dHA6Ly94eHgueHh4LjIyLjE0My90ZXN0IiwKICAgICJjYWxsYmFja0hvc3QiOiAieW91ci5jYWxsYmFjay5jb20iLAogICAgImNhbGxiYWNrQm9keSI6ICJidWNrZXQ9JHtidWNrZXR9Jm9iamVjdD0ke29iamVjdH0mbXlfdmFyPSR7eDpteV92YXJ9IiwKICAgICJjYWxsYmFja0JvZHlUeXBlIjogImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5jb2RlZCIsCiAgICAiY2FsbGJhY2tTTkkiOiBmYWxzZQp9
Host: callback-test.oss-test.aliyun-inc.com
Expect: 100-Continue
Date: Wed, 26 Apr 2023 03:46:17 GMT
Content-Type: text/plain
Authorization: OSS qn6q**************:77Dv****************
Test

在POST請求的Body中使用表單域來攜帶參數

使用PostObject接口上傳Object時，僅支持通過POST請求的Body中使用表單域來攜帶參數的方式指定回調參數。

• 如果需要在POST上傳Object時附帶回調參數，callback參數要使用獨立的表單域來附加，示例如下：

  --9431149156168
  Content-Disposition: form-data; name="callback"
  eyJjYWxsYmFja1VybCI6IjEwLj****4xN

• 如果是自定義參數，不能直接將callback-var參數直接附加到表單域中。每個自定義的參數都需要使用獨立的表單域來添加。例如，自定義參數JSON字段示例如下：

  {
  "x:var1":"value1",
  "x:var2":"value2"
  }

  則POST請求的表單域為：

  --9431149156168
  Content-Disposition: form-data; name="callback"
  eyJjYWxsYmFja1VybCI6IjEwLj****4xN
  --9431149156168
  Content-Disposition: form-data; name="x:var1"
  value1
  --9431149156168
  Content-Disposition: form-data; name="x:var2"
  value2

  同時，您還可以在policy中添加callback條件。如果不添加callback條件，則不對該參數做上傳驗證，如下所示。

  { "expiration": "2021-12-01T12:00:00.000Z",
    "conditions": [
      {"bucket": "johnsmith" },
      {"callback": "eyJjYWxsYmFja1V****4My"},
      ["starts-with", "$key", "user/eric/"],
    ]
  }

步驟一：生成簽名

• 生成簽名的方式

  采用RSA非對稱方式生成簽名。

  authorization = base64_encode(rsa_sign(private_key, url_decode(path) + query_string + '\n' + body, md5))

  說明

  其中，private_key為私鑰，path為回調請求的資源路徑，query_string為查詢字符串，body為回調的消息體。

• 生成簽名的步驟

  1. 獲取待簽名字符串：資源路徑經過URL解碼后，會附加原始的查詢字符串、一個回車符以及回調消息體。

  2. RSA簽名：使用密鑰對待簽名字符串進行簽名，簽名的哈希函數為md5。

  3. 將簽名后的結果做Base64編碼，獲取最終的簽名，然后將簽名放在回調請求的authorization頭中。

• 生成簽名的示例

  POST /index.php?id=1&index=2 HTTP/1.0
  Host: 172.16.XX.XX
  Connection: close
  Content-Length: 18
  authorization: kKQeGTRccDKyHB3H9vF+xYMSrmhMZj****/kdD1ktNVgbWEfYTQG0G2SU/RaHBovRCE8OkQDjC3uG33esH2t****
  Content-Type: application/x-www-form-urlencoded
  User-Agent: http-client/0.0.1
  x-oss-pub-key-url: aHR0cDovL2dvc3NwdWJsaWMuYWxpY2RuLmNvbS9jYWxsYmFja19wdWJfa2V5X3YxLnsr****
  bucket=examplebucket

  path為/index.php，query_string為?id=1&index=2，body為bucket=examplebucket，最終簽名結果為kKQeGTRccDKyHB3H9vF+xYMSrmhMZjzzl2/kdD1ktNVgbWEfYTQG0G2SU/RaHBovRCE8OkQDjC3uG33esH2t****。

步驟二：驗證簽名

• 驗證簽名的方式

  通過應用服務器驗證簽名示例如下：

  Result = rsa_verify(public_key, md5(url_decode(path) + query_string + ‘\n’ + body), base64_decode(authorization))

  其中，public_key為公鑰，authorization為回調頭中的簽名。

• 驗證簽名的過程

  1. 回調請求的x-oss-pub-key-url頭保存的是公鑰URL地址的base64編碼，需要對x-oss-pub-key-url執行base64解碼后獲取公鑰。

     public_key = urlopen(base64_decode(x-oss-pub-key-url頭的值))

     例如，獲取到公鑰的URL地址為aHR0cDovL2dvc3NwdWJsaWMuYWxpY2RuLmNvbS9jYWxsYmFja19wdWJfa2V5X3YxLnBlbQ==，經過base64解碼后得到http://gosspublic.alicdn.com/callback_pub_key_v1.pem。

     說明

     OSS頒發的public_key中x-oss-pub-key-url頭的值必須以http://gosspublic.alicdn.com/或者https://gosspublic.alicdn.com/開頭。由于公鑰地址的內容不變，因此推薦根據公鑰地址緩存公鑰內容，以避免因為網絡或者公鑰地址所在服務問題造成的業務異常。

  2. 獲取base64解碼后的簽名。

     signature = base64_decode(authorization頭的值)

  3. 獲取待簽名字符串，方法與簽名一致。

     sign_str = url_decode(path) + query_string + ‘\n’ + body

  4. 驗證簽名。

     result = rsa_verify(public_key, md5(sign_str), signature)

• 驗證簽名示例

  以Python為例，演示應用服務器中驗證簽名的方法，此示例需要安裝M2Crypto庫。

  import httplib
  import base64
  import md5
  import urllib2
  from BaseHTTPServer import BaseHTTPRequestHandler, HTTPServer
  from M2Crypto import RSA
  from M2Crypto import BIO
  def get_local_ip():
      try:
          csock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
          csock.connect(('8.8.8.8', 80))
          (addr, port) = csock.getsockname()
          csock.close()
          return addr
      except socket.error:
          return ""
  class MyHTTPRequestHandler(BaseHTTPRequestHandler):
      '''
      def log_message(self, format, *args):
          return
      '''
      def do_POST(self):
          #get public key
          pub_key_url = ''
          try:
              pub_key_url_base64 = self.headers['x-oss-pub-key-url']
              pub_key_url = pub_key_url_base64.decode('base64')
              if not pub_key_url.startswith("http://gosspublic.alicdn.com/") and not pub_key_url.startswith("https://gosspublic.alicdn.com/"):
                  self.send_response(400)
                  self.end_headers()
                  return
              url_reader = urllib2.urlopen(pub_key_url)
              #you can cache it,recommend caching public key content based on the public key address
              pub_key = url_reader.read() 
          except:
              print 'pub_key_url : ' + pub_key_url
              print 'Get pub key failed!'
              self.send_response(400)
              self.end_headers()
              return
          #get authorization
          authorization_base64 = self.headers['authorization']
          authorization = authorization_base64.decode('base64')
          #get callback body
          content_length = self.headers['content-length']
          callback_body = self.rfile.read(int(content_length))
          #compose authorization string
          auth_str = ''
          pos = self.path.find('?')
          if -1 == pos:
              auth_str = urllib2.unquote(self.path) + '\n' + callback_body
          else:
              auth_str = urllib2.unquote(self.path[0:pos]) + self.path[pos:] + '\n' + callback_body
          print auth_str
          #verify authorization
          auth_md5 = md5.new(auth_str).digest()
          bio = BIO.MemoryBuffer(pub_key)
          rsa_pub = RSA.load_pub_key_bio(bio)
          try:
              result = rsa_pub.verify(auth_md5, authorization, 'md5')
          except:
              result = False
          if not result:
              print 'Authorization verify failed!'
              print 'Public key : %s' % (pub_key)
              print 'Auth string : %s' % (auth_str)
              self.send_response(400)
              self.end_headers()
              return
          #do something according to callback_body
          #response to OSS
          resp_body = '{"Status":"OK"}'
          self.send_response(200)
          self.send_header('Content-Type', 'application/json')
          self.send_header('Content-Length', str(len(resp_body)))
          self.end_headers()
          self.wfile.write(resp_body)
  class MyHTTPServer(HTTPServer):
      def __init__(self, host, port):
          HTTPServer.__init__(self, (host, port), MyHTTPRequestHandler)
  if '__main__' == __name__:
      server_ip = get_local_ip()
  server_port = 23451
  server = MyHTTPServer(server_ip, server_port)
  server.serve_forever()

  其他語言的服務端代碼請參見下表。

  SDK語言	描述
  Java	下載地址：Java 運行方法：解壓包運行java -jar oss-callback-server-demo.jar 9000（9000指運行的端口，可以自行指定）。
  Python	下載地址：Python 運行方法：解壓包直接運行python callback_app_server.py，運行該程序需要安裝RSA的依賴。
  Go	下載地址：Go 運行方法：解壓后參看README.md。
  PHP	下載地址：PHP 運行方法：部署到Apache環境下，因為PHP本身語言的特點，取一些數據頭部會依賴于環境。所以可以參考例子根據所在環境修改。
  .NET	下載地址：.NET 運行方法：解壓后參看README.md。
  Node.js	下載地址：Node.js 運行方法：解壓包直接運行node example.js。
  Ruby	下載地址：Ruby 運行方法：ruby aliyun_oss_callback_server.rb