Object Storage Service:Include a V1 signature in a URL

URL 形式

V1 署名付き URL は次の構造を持ちます。

https://<bucket>.oss-<region>.aliyuncs.com/<object>?OSSAccessKeyId=<key-id>&Expires=<unix-timestamp>&Signature=<encoded-signature>

STS からの一時アクセス認証情報を使用するには、security-token パラメーターを追加します。

https://<bucket>.oss-<region>.aliyuncs.com/<object>?OSSAccessKeyId=<key-id>&Expires=<unix-timestamp>&Signature=<encoded-signature>&security-token=<sts-token>

IP アドレスまたは virtual private cloud (VPC) によるアクセスを制限するには、対応するアクセス制御パラメーターを含めます。

https://<bucket>.oss-<region>.aliyuncs.com/<object>?OSSAccessKeyId=<key-id>&Expires=<unix-timestamp>&Signature=<encoded-signature>&x-oss-ac-subnet-mask=32

URL パラメーター

署名式

Signature パラメーターは、Authorization ヘッダーと同じアルゴリズムを使用しますが、1 つの違いがあります。署名文字列では、Date ヘッダーを Expires に置き換えます。Date をリクエストに含めることはできますが、署名文字列には含めないでください。

Signature = urlencode(base64(hmac-sha1(AccessKeySecret,
              VERB + "\n"
              + CONTENT-MD5 + "\n"
              + CONTENT-TYPE + "\n"
              + EXPIRES + "\n"
              + CanonicalizedOSSHeaders
              + CanonicalizedResource)))

CONTENT-MD5、CONTENT-TYPE、および CanonicalizedOSSHeaders については、「署名 V1」と同じルールに従ってください。

URL に Signature、Expires、または OSSAccessKeyId が複数回出現する場合、OSS は最初の値を使用します。OSS はリクエストを受信すると、最初に Expires をチェックし、次に Signature を検証します。

Python の例

次の例は、必須パラメーターのみを使用して GET リクエストの V1 署名を計算します。

import base64
import hmac
import hashlib
from urllib.parse import quote

access_key_secret = "yourAccessKeySecret"
string_to_sign = "GET\n\n\n1141889120\n/examplebucket/oss-api.pdf"

h = hmac.new(
    access_key_secret.encode('utf-8'),
    string_to_sign.encode('utf-8'),
    hashlib.sha1
)

signature = quote(base64.b64encode(h.digest()).decode('utf-8'))
print(signature)

プレースホルダー値を置き換えます。