Object Storage Service:サーバー側署名とコールバックによる直接アップロード

Linux

1. 次のコマンドを実行して、環境変数の設定を ~/.bashrc ファイルに追記します。

   echo "export OSS_ACCESS_KEY_ID='your-access-key-id'" >> ~/.bashrc
   echo "export OSS_ACCESS_KEY_SECRET='your-access-key-secret'" >> ~/.bashrc
   echo "export OSS_STS_ROLE_ARN='your-role-arn'" >> ~/.bashrc

2. 次のコマンドを実行して変更を適用します。

   source  ~/.bashrc

3. 次のコマンドを実行して、環境変数が設定されているかどうかを確認します。

   echo $OSS_ACCESS_KEY_ID
   echo $OSS_ACCESS_KEY_SECRET
   echo $OSS_STS_ROLE_ARN

macOS

1. ターミナルで次のコマンドを実行して、デフォルトのシェルタイプを確認します。

   echo $SHELL

2. デフォルトのシェルタイプに応じた手順に従ってください。

   Zsh

   1. 次のコマンドを実行して、環境変数の設定を ~/.zshrc ファイルに追記します。

      echo "export OSS_ACCESS_KEY_ID='your-access-key-id'" >> ~/.zshrc
      echo "export OSS_ACCESS_KEY_SECRET='your-access-key-secret'" >> ~/.zshrc
      echo "export OSS_STS_ROLE_ARN='your-role-arn'" >> ~/.zshrc

   2. 次のコマンドを実行して変更を適用します。

      source ~/.zshrc

   3. 次のコマンドを実行して、環境変数が設定されているかどうかを確認します。

      echo $OSS_ACCESS_KEY_ID
      echo $OSS_ACCESS_KEY_SECRET
      echo $OSS_STS_ROLE_ARN

   Bash

   1. 次のコマンドを実行して、環境変数の設定を ~/.bash_profile ファイルに追記します。

      echo "export OSS_ACCESS_KEY_ID='your-access-key-id'" >> ~/.bash_profile
      echo "export OSS_ACCESS_KEY_SECRET='your-access-key-secret'" >> ~/.bash_profile
      echo "export OSS_STS_ROLE_ARN='your-role-arn'" >> ~/.bash_profile

   2. 次のコマンドを実行して変更を適用します。

      source ~/.bash_profile

   3. 次のコマンドを実行して、環境変数が設定されているかどうかを確認します。

      echo $OSS_ACCESS_KEY_ID
      echo $OSS_ACCESS_KEY_SECRET
      echo $OSS_STS_ROLE_ARN

Windows

1. コマンド プロンプトで次のコマンドを実行します。

   setx OSS_ACCESS_KEY_ID "your-access-key-id"
   setx OSS_ACCESS_KEY_SECRET "your-access-key-secret"
   setx OSS_STS_ROLE_ARN "your-role-arn"

2. 新しいコマンド プロンプト ウィンドウを開きます。

3. 新しいコマンド プロンプト ウィンドウで、次のコマンドを実行して環境変数が設定されているかどうかを確認します。

   echo %OSS_ACCESS_KEY_ID%
   echo %OSS_ACCESS_KEY_SECRET%
   echo %OSS_STS_ROLE_ARN%

Java

Maven プロジェクトに、次の依存関係を追加します。

<!-- https://mvnrepository.com/artifact/com.aliyun/credentials-java -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.17.4</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>sts20150401</artifactId>
  <version>1.1.6</version>
</dependency>

次のサンプルコードを使用して、サーバーで一時的な認証情報を取得し、POST 署名を計算し、アップロードコールバックを設定します。

package com.aliyun.oss.web;
import com.aliyun.sts20150401.models.AssumeRoleResponse;
import com.aliyun.sts20150401.models.AssumeRoleResponseBody;
import com.aliyun.tea.TeaException;
import com.aliyun.oss.common.utils.BinaryUtil;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.commons.codec.binary.Base64;
import org.codehaus.jettison.json.JSONObject;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.*;
@Controller
public class WebController {
    // OSS の基本情報。バケット名、リージョン ID、ホストを実際の値に置き換えてください。
    String bucket = "examplebucket";
    String region = "cn-hangzhou";
    String host = "http://examplebucket.oss-cn-hangzhou.aliyuncs.com";
    // アップロードコールバックの URL。これはパブリック URL である必要があります。これは、アプリケーションサーバーと OSS 間の通信に使用されます。ファイルがアップロードされると、OSS はこの URL を介してアップロード情報をアプリケーションサーバーに送信します。
    String callbackUrl = "http://oss-demo.aliyuncs.com:23450/callback"; // コールバックリクエストを受信するサーバーの URL。例: http://oss-demo.aliyuncs.com:23450/callback。
    // OSS にアップロードされるファイルのプレフィックス。
    String upload_dir = "dir";
    // 有効期限 (秒単位)。
    Long expire_time = 3600L;
    /**
     * 指定された秒数に基づいて有効期限を生成します。
     * @param seconds 秒単位の期間。
     * @return ISO 8601 形式の時刻文字列。例: "2014-12-01T12:00:00.000Z"。
     */
    public static String generateExpiration(long seconds) {
        long now = Instant.now().getEpochSecond();
        long expirationTime = now + seconds;
        Instant instant = Instant.ofEpochSecond(expirationTime);
        ZoneId zone = ZoneOffset.UTC;
        ZonedDateTime zonedDateTime = instant.atZone(zone);
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
        String formattedDate = zonedDateTime.format(formatter);
        return formattedDate;
    }
    // STS クライアントを初期化します。
    public static com.aliyun.sts20150401.Client createStsClient() throws Exception {
        // プロジェクトコードが漏洩すると、AccessKey ペアが公開され、アカウント内のすべてのリソースのセキュリティが損なわれる可能性があります。次のサンプルコードは参照用です。
        // より安全な STS 方式を使用することを推奨します。
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // 必須。OSS_ACCESS_KEY_ID 環境変数が実行環境に設定されていることを確認してください。
                .setAccessKeyId(System.getenv("OSS_ACCESS_KEY_ID"))
                // 必須。OSS_ACCESS_KEY_SECRET 環境変数が実行環境に設定されていることを確認してください。
                .setAccessKeySecret(System.getenv("OSS_ACCESS_KEY_SECRET"));
        // エンドポイントの詳細については、https://api.aliyun.com/product/Sts をご参照ください
        config.endpoint = "sts.cn-hangzhou.aliyuncs.com";
        return new com.aliyun.sts20150401.Client(config);
    }
    // STS から一時的な認証情報を取得します。
    public static AssumeRoleResponseBody.AssumeRoleResponseBodyCredentials getCredential() throws Exception {
        com.aliyun.sts20150401.Client client = WebController.createStsClient();
        com.aliyun.sts20150401.models.AssumeRoleRequest assumeRoleRequest = new com.aliyun.sts20150401.models.AssumeRoleRequest()
                // 必須。OSS_STS_ROLE_ARN 環境変数が実行環境に設定されていることを確認してください。
                .setRoleArn(System.getenv("OSS_STS_ROLE_ARN"))
                .setRoleSessionName("yourRoleSessionName");// カスタムセッション名。
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // デバッグのため、このコードの実行時に API の戻り値を出力します。
            AssumeRoleResponse response = client.assumeRoleWithOptions(assumeRoleRequest, runtime);
            // `credentials` オブジェクトには、AccessKeyId、AccessKeySecret、およびセキュリティトークンが含まれます。
            return response.body.credentials;
        } catch (TeaException error) {
            // これはデモンストレーションのみを目的としています。例外は慎重に処理し、プロジェクトで無視しないでください。
            System.out.println(error.getMessage());
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        } 
        // null が返されるのを避けるために、デフォルトのエラーレスポンスオブジェクトを返します。
        AssumeRoleResponseBody.AssumeRoleResponseBodyCredentials defaultCredentials = new AssumeRoleResponseBody.AssumeRoleResponseBodyCredentials();
        defaultCredentials.accessKeyId = "ERROR_ACCESS_KEY_ID";
        defaultCredentials.accessKeySecret = "ERROR_ACCESS_KEY_SECRET";
        defaultCredentials.securityToken = "ERROR_SECURITY_TOKEN";
        return defaultCredentials;
    }
    @GetMapping("/get_post_signature_for_oss_upload")
    public ResponseEntity<Map<String, String>> getPostSignatureForOssUpload() throws Exception {
        AssumeRoleResponseBody.AssumeRoleResponseBodyCredentials sts_data = getCredential();
        String accesskeyid =  sts_data.accessKeyId;
        String accesskeysecret =  sts_data.accessKeySecret;
        String securitytoken =  sts_data.securityToken;
        // yyyyMMdd 形式の現在の日付を取得します。x-oss-credential フィールドで使用します。
        ZonedDateTime today = ZonedDateTime.now().withZoneSameInstant(java.time.ZoneOffset.UTC);
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyyMMdd");
        String date = today.format(formatter);
        // x-oss-date を取得します。
        ZonedDateTime now = ZonedDateTime.now().withZoneSameInstant(java.time.ZoneOffset.UTC);
        DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyyMMdd'T'HHmmss'Z'");
        String x_oss_date = now.format(formatter2);
        // ステップ 1： ポリシーを作成します。
        String x_oss_credential = accesskeyid + "/" + date + "/" + region + "/oss/aliyun_v4_request";
        ObjectMapper mapper = new ObjectMapper();
        Map<String, Object> policy = new HashMap<>();
        policy.put("expiration", generateExpiration(expire_time));
        List<Object> conditions = new ArrayList<>();
        Map<String, String> bucketCondition = new HashMap<>();
        bucketCondition.put("bucket", bucket);
        conditions.add(bucketCondition);
        conditions.add(Arrays.asList("starts-with", "$key", upload_dir));
        conditions.add(Arrays.asList("content-length-range", 1, 10240000));
        conditions.add(Arrays.asList("eq", "$success_action_status", "200"));
        Map<String, String> signatureVersionCondition = new HashMap<>();
        signatureVersionCondition.put("x-oss-signature-version", "OSS4-HMAC-SHA256");
        conditions.add(signatureVersionCondition);
        Map<String, String> credentialCondition = new HashMap<>();
        credentialCondition.put("x-oss-credential", x_oss_credential);
        conditions.add(credentialCondition);
        Map<String, String> securityTokenCondition = new HashMap<>();
        securityTokenCondition.put("x-oss-security-token", securitytoken);
        conditions.add(securityTokenCondition);
        Map<String, String> dateCondition = new HashMap<>();
        dateCondition.put("x-oss-date", x_oss_date);
        conditions.add(dateCondition);
        policy.put("conditions", conditions);
        String jsonPolicy = mapper.writeValueAsString(policy);
        // ステップ 2： 署名対象文字列を構築します。
        String stringToSign = new String(Base64.encodeBase64(jsonPolicy.getBytes()));
        // ステップ 3： 署名キーを計算します。
        byte[] dateKey = hmacsha256(("aliyun_v4" + accesskeysecret).getBytes(), date);
        byte[] dateRegionKey = hmacsha256(dateKey, region);
        byte[] dateRegionServiceKey = hmacsha256(dateRegionKey, "oss");
        byte[] signingKey = hmacsha256(dateRegionServiceKey, "aliyun_v4_request");
        // ステップ 4： 署名を計算します。
        byte[] result = hmacsha256(signingKey, stringToSign);
        String signature = BinaryUtil.toHex(result);
        // ステップ 5： コールバックを設定します。
        JSONObject jasonCallback = new JSONObject();
        jasonCallback.put("callbackUrl", callbackUrl);
        jasonCallback.put("callbackBody","filename=${object}&size=${size}&mimeType=${mimeType}&height=${imageInfo.height}&width=${imageInfo.width}");
        jasonCallback.put("callbackBodyType", "application/x-www-form-urlencoded");
        String base64CallbackBody = BinaryUtil.toBase64String(jasonCallback.toString().getBytes());
        Map<String, String> response = new HashMap<>();
        // マップにデータを追加します。
        response.put("x_oss_signature_version", "OSS4-HMAC-SHA256");
        response.put("policy", stringToSign);
        response.put("x_oss_credential", x_oss_credential);
        response.put("x_oss_date", x_oss_date);
        response.put("signature", signature);
        response.put("security_token", securitytoken);
        response.put("dir", upload_dir);
        response.put("host", host);
        response.put("callback", base64CallbackBody);
        // PostObject 操作のため、Web クライアントにステータスコード 200 (OK) の ResponseEntity を返します。
        return ResponseEntity.ok(response);
    }
    public static byte[] hmacsha256(byte[] key, String data) {
        try {
            // HMAC キー仕様を初期化し、アルゴリズムを HmacSHA256 に設定し、提供されたキーを使用します。
            SecretKeySpec secretKeySpec = new SecretKeySpec(key, "HmacSHA256");
            // Mac インスタンスを取得し、getInstance メソッドを使用して HmacSHA256 アルゴリズムを指定します。
            Mac mac = Mac.getInstance("HmacSHA256");
            // Mac オブジェクトをキーで初期化します。
            mac.init(secretKeySpec);
            // データの HMAC ハッシュを計算します。
            byte[] hmacBytes = mac.doFinal(data.getBytes());
            return hmacBytes;
        } catch (Exception e) {
            throw new RuntimeException("Failed to calculate HMAC-SHA256", e);
        }
    }
}

Python

次のコマンドを実行して依存関係をインストールします。

pip install flask
pip install alibabacloud_tea_openapi alibabacloud_sts20150401 alibabacloud_credentials

次のサンプルコードを使用して、STS から一時的な認証情報を取得し、アップロードポリシーを構築し、POST 署名を計算し、コールバックを設定します。

from flask import Flask, render_template, jsonify, request
from alibabacloud_tea_openapi.models import Config
from alibabacloud_sts20150401.client import Client as Sts20150401Client
from alibabacloud_sts20150401 import models as sts_20150401_models
import os
import json
import base64
import hmac
import datetime
import time
import hashlib
import oss2
app = Flask(__name__)
# OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、および OSS_STS_ROLE_ARN 環境変数を設定します。
access_key_id = os.environ.get('OSS_ACCESS_KEY_ID')
access_key_secret = os.environ.get('OSS_ACCESS_KEY_SECRET')
role_arn_for_oss_upload = os.environ.get('OSS_STS_ROLE_ARN')
# カスタムセッション名。
role_session_name = 'yourRoleSessionName'
# 実際のバケット名、リージョン ID、ホストに置き換えてください。
bucket = 'examplebucket'
region_id = 'cn-hangzhou'
host = 'http://examplebucket.oss-cn-hangzhou.aliyuncs.com'
# 有効期限 (秒単位)。
expire_time = 3600
# OSS にアップロードされるファイルのプレフィックス。
upload_dir = 'dir'
def hmacsha256(key, data):
    """
    HMAC-SHA256 ハッシュ値を計算する関数。
    :param key: ハッシュを計算するためのキー (バイト単位)。
    :param data: ハッシュされるデータ (文字列)。
    :return: 計算された HMAC-SHA256 ハッシュ値 (バイト単位)。
    """
    try:
        mac = hmac.new(key, data.encode(), hashlib.sha256)
        hmacBytes = mac.digest()
        return hmacBytes
    except Exception as e:
        raise RuntimeError(f"Failed to calculate HMAC-SHA256 due to {e}")
@app.route("/")
def hello_world():
    return render_template('index.html')
@app.route('/get_post_signature_for_oss_upload', methods=['GET'])
def generate_upload_params():
    # 認証情報を直接渡して設定を初期化します。
    config = Config(
        region_id=region_id,
        access_key_id=access_key_id,
        access_key_secret=access_key_secret
    )
    # STS クライアントを作成し、一時的な認証情報を取得します。
    sts_client = Sts20150401Client(config=config)
    assume_role_request = sts_20150401_models.AssumeRoleRequest(
        role_arn=role_arn_for_oss_upload,
        role_session_name=role_session_name
    )
    response = sts_client.assume_role(assume_role_request)
    token_data = response.body.credentials.to_map()
    # STS から返された一時的な認証情報を使用します。
    temp_access_key_id = token_data['AccessKeyId']
    temp_access_key_secret = token_data['AccessKeySecret']
    security_token = token_data['SecurityToken']
    now = int(time.time())
    # タイムスタンプを datetime オブジェクトに変換します。
    dt_obj = datetime.datetime.utcfromtimestamp(now)
    # リクエストの有効期限を現在時刻から 3 時間に設定します。
    dt_obj_plus_3h = dt_obj + datetime.timedelta(hours=3)
    # リクエスト時刻。
    dt_obj_1 = dt_obj.strftime('%Y%m%dT%H%M%S') + 'Z'
    # リクエスト日。
    dt_obj_2 = dt_obj.strftime('%Y%m%d')
    # リクエスト有効期限。
    expiration_time = dt_obj_plus_3h.strftime('%Y-%m-%dT%H:%M:%S.000Z')
    # コールバックパラメーターを Base64 エンコードする関数を定義します。
    def encode_callback(callback_params):
        cb_str = json.dumps(callback_params).strip()
        return oss2.compat.to_string(base64.b64encode(oss2.compat.to_bytes(cb_str)))
    # コールバック設定を構築し、Base64 エンコードします。
    callback_config = {
        "callbackUrl": "http://oss-demo.aliyuncs.com:23450/callback",  # コールバックサーバーの URL。
        "callbackBody": "bucket=${bucket}&object=${object}&etag=${etag}&size=${size}",
        "callbackBodyType": "application/x-www-form-urlencoded"
    }
    encoded_callback = encode_callback(callback_config)
    # ポリシーを構築し、署名を生成します。
    policy = {
        "expiration": expiration_time,
        "conditions": [
            {"bucket": bucket},
            ["starts-with", "$key", upload_dir],
            ["content-length-range", 1, 10240000],
            ["eq", "$success_action_status", "200"],
            {"x-oss-signature-version": "OSS4-HMAC-SHA256"},
            {"x-oss-credential": f"{temp_access_key_id}/{dt_obj_2}/cn-hangzhou/oss/aliyun_v4_request"},
            {"x-oss-security-token": security_token},
            {"x-oss-date": dt_obj_1},
        ]
    }
    policy_str = json.dumps(policy).strip()
    # ステップ 2： 署名対象文字列を構築します。
    stringToSign = base64.b64encode(policy_str.encode()).decode()
    # ステップ 3： 署名キーを計算します。
    dateKey = hmacsha256(("aliyun_v4" + temp_access_key_secret).encode(), dt_obj_2)
    dateRegionKey = hmacsha256(dateKey, "cn-hangzhou")
    dateRegionServiceKey = hmacsha256(dateRegionKey, "oss")
    signingKey = hmacsha256(dateRegionServiceKey, "aliyun_v4_request")
    # ステップ 4： 署名を計算します。
    result = hmacsha256(signingKey, stringToSign)
    signature = result.hex()
    # レスポンスデータを準備します。
    response_data = {
        'policy': stringToSign,  # フォームフィールド。
        'x_oss_signature_version': "OSS4-HMAC-SHA256",  # 署名バージョンとアルゴリズム。値は OSS4-HMAC-SHA256 に固定されています。
        'x_oss_credential': f"{temp_access_key_id}/{dt_obj_2}/cn-hangzhou/oss/aliyun_v4_request",  # 派生キーを指定するパラメーターセット。
        'x_oss_date': dt_obj_1,  # リクエスト時刻。
        'signature': signature,  # 署名情報。
        'host': host,
        'dir': upload_dir,
        'security_token': security_token,  # セキュリティトークン。
        'callback': encoded_callback   # Base64 エンコードされたコールバック設定。
    }
    return jsonify(response_data)
if __name__ == "__main__":
    app.run(host="127.0.0.1", port=8000)  # 0.0.0.0 など、他のアドレスでリッスンする必要がある場合は、サーバーに認証メカニズムを追加する必要があります。

Node.js

次のコマンドを実行して依存関係をインストールします。

npm install ali-oss
npm install @alicloud/credentials
npm install express

次のサンプルコードを使用して、STS から一時的な認証情報を取得し、アップロードポリシーを構築し、POST 署名を計算し、コールバックを設定します。

const express = require('express');
const OSS = require('ali-oss');
const { STS } = require('ali-oss');
const { getCredential } = require('ali-oss/lib/common/signUtils');
const { getStandardRegion } = require('ali-oss/lib/common/utils/getStandardRegion');
const { policy2Str } = require('ali-oss/lib/common/utils/policy2Str');
const app = express();
const PORT = process.env.PORT || 8000; // サービスポート。
// 静的ファイルディレクトリを設定します。
app.use(express.static('templates'));
const GenerateSignature = async () => {
    // STS クライアントを初期化します。
    let sts = new STS({
        accessKeyId: process.env.OSS_ACCESS_KEY_ID,  // 環境変数から RAM ユーザーの AccessKey ID を取得します。
        accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET // 環境変数から RAM ユーザーの AccessKey シークレットを取得します。
    });
    // assumeRole 操作を呼び出して、STS から一時的なアクセス認証情報を取得します。
    const result = await sts.assumeRole(process.env.OSS_STS_ROLE_ARN, '', '3600', 'yourRoleSessionName'); // 環境変数から RAM ロール ARN を取得し、一時的なアクセス認証情報の有効期間を 3,600 秒に設定し、カスタムロールセッション名を指定します。
    // 一時的なアクセス認証情報から AccessKeyId、AccessKeySecret、および SecurityToken を抽出します。
    const accessKeyId = result.credentials.AccessKeyId;
    const accessKeySecret = result.credentials.AccessKeySecret;
    const securityToken = result.credentials.SecurityToken;
    // OSS クライアントを初期化します。
    const client = new OSS({
        bucket: 'examplebucket', // 対象のバケット名に置き換えてください。
        region: 'cn-hangzhou', // 対象のバケットのリージョンに置き換えてください。
        accessKeyId,
        accessKeySecret,
        stsToken: securityToken,
        refreshSTSTokenInterval: 0,
        refreshSTSToken: async () => {
            const { accessKeyId, accessKeySecret, securityToken } = await client.getCredential();
            return { accessKeyId, accessKeySecret, stsToken: securityToken };
        },
    });
    // フォームデータマップを作成します。
    const formData = new Map();
    // 署名の有効期限を現在時刻から 10 分後に設定します。 
    const date = new Date();
    const expirationDate = new Date(date);
    expirationDate.setMinutes(date.getMinutes() + 10);
    // 日付を ISO 8601 規格に準拠した UTC 時刻文字列にフォーマットします。
    function padTo2Digits(num) {
        return num.toString().padStart(2, '0');
    }
    function formatDateToUTC(date) {
        return (
            date.getUTCFullYear() +
            padTo2Digits(date.getUTCMonth() + 1) +
            padTo2Digits(date.getUTCDate()) +
            'T' +
            padTo2Digits(date.getUTCHours()) +
            padTo2Digits(date.getUTCMinutes()) +
            padTo2Digits(date.getUTCSeconds()) +
            'Z'
        );
    }
    const formattedDate = formatDateToUTC(expirationDate);
    // アップロードコールバックの URL。これは、アプリケーションサーバーと OSS 間の通信に使用されます。ファイルがアップロードされると、OSS はこの URL を介してアップロード情報をアプリケーションサーバーに送信します。例: callbackUrl を https://oss-demo.aliyuncs.com:23450 に設定します。
    // x-oss-credential を生成し、フォームデータを設定します。
    const credential = getCredential(formattedDate.split('T')[0], getStandardRegion(client.options.region), client.options.accessKeyId);
    formData.set('x_oss_date', formattedDate);
    formData.set('x_oss_credential', credential);
    formData.set('x_oss_signature_version', 'OSS4-HMAC-SHA256');
    // ポリシーを作成します。
    // 次のポリシーには、必須フィールドが含まれています。
    const policy = {
        expiration: expirationDate.toISOString(),
        conditions: [
            { 'bucket': 'examplebucket' }, // 対象のバケット名に置き換えてください。
            ['starts-with', '$key', 'user-dir'],
            ['content-length-range', 1, 10240000],
            ['eq', '$success_action_status', '200'],
            { 'x-oss-credential': credential },
            { 'x-oss-signature-version': 'OSS4-HMAC-SHA256' },
            { 'x-oss-date': formattedDate },
        ],
    };
    // STS トークンが存在する場合は、ポリシーとフォームデータに追加します。
    if (client.options.stsToken) {
        policy.conditions.push({ 'x-oss-security-token': client.options.stsToken });
        formData.set('security_token', client.options.stsToken);
    }
    // 署名を生成し、フォームデータを設定します。
    const signature = client.signPostObjectPolicyV4(policy, date);
    formData.set('policy', Buffer.from(policy2Str(policy), 'utf8').toString('base64'));
    formData.set('signature', signature);
    const callback = {
      callbackUrl: 'http://oss-demo.aliyuncs.com:23450/callback',// コールバックリクエストを受信するサーバーの URL。例: http://oss-demo.aliyuncs.com:23450/callback。
      callbackBody:// ファイルの ETag やリソースの MIME タイプなど、コールバックの内容。
      "filename=${object}&size=${size}&mimeType=${mimeType}&height=${imageInfo.height}&width=${imageInfo.width}",
      callbackBodyType: "application/x-www-form-urlencoded",// コールバックのコンテンツタイプ。    
    };
    // フォームデータを返します。
    return {
        host: `http://${client.options.bucket}.oss-${client.options.region}.aliyuncs.com`, 
        policy: Buffer.from(policy2Str(policy), 'utf8').toString('base64'),
        x_oss_signature_version: 'OSS4-HMAC-SHA256',
        x_oss_credential: credential,
        x_oss_date: formattedDate,
        signature: signature,
        dir: 'user-dir', // OSS にアップロードされるファイルのプレフィックス。
        callback: Buffer.from(JSON.stringify(callback)).toString("base64"),// Buffer.from を使用して JSON オブジェクトを Base64 エンコードします。
        security_token: client.options.stsToken
    };
};
app.get('/get_post_signature_for_oss_upload', async (req, res) => {
    try {
        const result = await GenerateSignature();
        res.json(result); // 生成された署名データを返します。
    } catch (error) {
        console.error('Error generating signature:', error);
        res.status(500).send('Error generating signature');
    }
});
app.listen(PORT, () => {
    console.log(`Server is running on http://127.0.0.1:${PORT}`); // 0.0.0.0 など、他のアドレスでリッスンする必要がある場合は、サーバーに認証メカニズムを追加する必要があります。
});

Go

次のコマンドを実行して依存関係をインストールします。

go get -u github.com/aliyun/credentials-go
go mod tidy

次のサンプルコードを使用して、STS から一時的な認証情報を取得し、アップロードポリシーを構築し、POST 署名を計算し、コールバックを設定します。

package main
import (
	"crypto/hmac"
	"crypto/sha256"
	"encoding/base64"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"io"
    "hash"
	"log"
	"net/http"
	"os"
	"time"
	"github.com/aliyun/credentials-go/credentials"
)
// グローバル変数を定義します。
var (
	region     string
	bucketName string
	product    = "oss"
)
// PolicyToken 構造体は、生成されたフォームデータを格納します。
type PolicyToken struct {
	Policy           string `json:"policy"`
	SecurityToken    string `json:"security_token"`
	SignatureVersion string `json:"x_oss_signature_version"`
	Credential       string `json:"x_oss_credential"`
	Date             string `json:"x_oss_date"`
	Signature        string `json:"signature"`
	Host             string `json:"host"` 
	Dir              string `json:"dir"` 
    Callback         string `json:"callback"`
}
type CallbackParam struct{
    CallbackUrl string `json:"callbackUrl"`
    CallbackBody string `json:"callbackBody"`
    CallbackBodyType string `json:"callbackBodyType"`
}
func main() {
	// デフォルトの IP アドレスとポート文字列を定義します。
	strIPPort := ":8080"
	if len(os.Args) == 3 {
		strIPPort = fmt.Sprintf("%s:%s", os.Args[1], os.Args[2])
	} else if len(os.Args) != 1 {
		fmt.Println("Usage   : go run test1.go                ")
		fmt.Println("Usage   : go run test1.go ip port        ")
		fmt.Println("Example : go run test1.go 11.22.**.** 80 ")
		fmt.Println("Example : go run test1.go 0.0.0.0 8080 ")
		fmt.Println("")
		os.Exit(0)
	}
	// サーバーが実行されているアドレスとポートを出力します。
	fmt.Printf("server is running on %s \n", strIPPort)
	// ルートパスへのリクエストを処理する関数を登録します。
	http.HandleFunc("/", handlerRequest)
	// 署名取得リクエストを処理する関数を登録します。
	http.HandleFunc("/get_post_signature_for_oss_upload", handleGetPostSignature)
	// HTTP サーバーを起動します。
	err := http.ListenAndServe(strIPPort, nil)
	if err != nil {
		strError := fmt.Sprintf("http.ListenAndServe failed : %s \n", err.Error())
		panic(strError)
	}
}
// handlerRequest 関数はルートパスへのリクエストを処理します。
func handlerRequest(w http.ResponseWriter, r *http.Request) {
	if r.Method == "GET" {
		http.ServeFile(w, r, "templates/index.html")
		return
	}
	http.NotFound(w, r)
}
// handleGetPostSignature 関数は署名取得リクエストを処理します。
func handleGetPostSignature(w http.ResponseWriter, r *http.Request) {
	if r.Method == "GET" {
		response := getPolicyToken()
		w.Header().Set("Content-Type", "application/json")
		w.Header().Set("Access-Control-Allow-Origin", "*") // クロスオリジンリクエストを許可します。
		w.Write([]byte(response))
		return
	}
	http.NotFound(w, r)
}
// getPolicyToken 関数は、OSS アップロードに必要な署名と認証情報を生成します。
func getPolicyToken() string {
	// バケットのリージョンを設定します。
	region = "cn-hangzhou"
	// バケット名を設定します。
	bucketName = "examplebucket"
	// OSS アップロードエンドポイントを設定します。
	host := fmt.Sprintf("https://%s.oss-%s.aliyuncs.com", bucketName, region)
	// アップロードディレクトリを設定します。
	dir := "user-dir"
    // callbackUrl は、アップロードコールバックを受信するサーバーの URL です。実際の情報に合わせて IP アドレスとポートを置き換えてください。
    callbackUrl := "http://oss-demo.aliyuncs.com:23450/callback";
	config := new(credentials.Config).
		SetType("ram_role_arn").
		SetAccessKeyId(os.Getenv("OSS_ACCESS_KEY_ID")).
		SetAccessKeySecret(os.Getenv("OSS_ACCESS_KEY_SECRET")).
		SetRoleArn(os.Getenv("OSS_STS_ROLE_ARN")).
		SetRoleSessionName("Role_Session_Name").
		SetPolicy("").
		SetRoleSessionExpiration(3600)
	// 設定に基づいて認証情報プロバイダーを作成します。
	provider, err := credentials.NewCredential(config)
	if err != nil {
		log.Fatalf("NewCredential fail, err:%v", err)
	}
	// 認証情報プロバイダーから認証情報を取得します。
	cred, err := provider.GetCredential()
	if err != nil {
		log.Fatalf("GetCredential fail, err:%v", err)
	}
	// ポリシーを構築します。
	utcTime := time.Now().UTC()
	date := utcTime.Format("20060102")
	expiration := utcTime.Add(1 * time.Hour)
	policyMap := map[string]any{
		"expiration": expiration.Format("2006-01-02T15:04:05.000Z"),
		"conditions": []any{
			map[string]string{"bucket": bucketName},
			[]any{"starts-with", "$key", dir},
			[]any{"content-length-range", 1, 10240000},
			[]any{"eq", "$success_action_status", "200"},
			map[string]string{"x-oss-signature-version": "OSS4-HMAC-SHA256"},
			map[string]string{"x-oss-credential": fmt.Sprintf("%v/%v/%v/%v/aliyun_v4_request", *cred.AccessKeyId, date, region, product)},
			map[string]string{"x-oss-date": utcTime.Format("20060102T150405Z")},
			map[string]string{"x-oss-security-token": *cred.SecurityToken},
		},
	}
	// ポリシーを JSON 形式に変換します。
	policy, err := json.Marshal(policyMap)
	if err != nil {
		log.Fatalf("json.Marshal fail, err:%v", err)
	}
    // 署名対象文字列を構築します。
    stringToSign := base64.StdEncoding.EncodeToString([]byte(policy))
    hmacHash := func() hash.Hash { return sha256.New() }
    // 署名キーを構築します。
    signingKey := "aliyun_v4" + *cred.AccessKeySecret
    h1 := hmac.New(hmacHash, []byte(signingKey))
    io.WriteString(h1, date)
    h1Key := h1.Sum(nil)
    h2 := hmac.New(hmacHash, h1Key)
    io.WriteString(h2, region)
    h2Key := h2.Sum(nil)
    h3 := hmac.New(hmacHash, h2Key)
    io.WriteString(h3, product)
    h3Key := h3.Sum(nil)
    h4 := hmac.New(hmacHash, h3Key)
    io.WriteString(h4, "aliyun_v4_request")
    h4Key := h4.Sum(nil)
    // 署名を生成します。
    h := hmac.New(hmacHash, h4Key)
    io.WriteString(h, stringToSign)
    signature := hex.EncodeToString(h.Sum(nil))
    var callbackParam CallbackParam
    callbackParam.CallbackUrl = callbackUrl
    callbackParam.CallbackBody = "filename=${object}&size=${size}&mimeType=${mimeType}&height=${imageInfo.height}&width=${imageInfo.width}"
    callbackParam.CallbackBodyType = "application/x-www-form-urlencoded"
    callback_str,err:=json.Marshal(callbackParam)
    if err != nil {
        fmt.Println("callback json err:", err)
    }
    callbackBase64 := base64.StdEncoding.EncodeToString(callback_str)
	// クライアントに返すフォームを構築します。
	policyToken := PolicyToken{
		Policy:           stringToSign,
		SecurityToken:    *cred.SecurityToken,
		SignatureVersion: "OSS4-HMAC-SHA256",
		Credential:       fmt.Sprintf("%v/%v/%v/%v/aliyun_v4_request", *cred.AccessKeyId, date, region, product),
		Date:             utcTime.UTC().Format("20060102T150405Z"),
		Signature:        signature,
		Host:             host, // OSS アップロードエンドポイント。
		Dir:              dir,  // アップロードディレクトリ。
        Callback:         callbackBase64, // アップロードコールバックパラメーター。
	}
	response, err := json.Marshal(policyToken)
	if err != nil {
		fmt.Println("json err:", err)
	}
	return string(response)
}

PHP

次のコマンドを実行して依存関係をインストールします。

composer install

次のサンプルコードを使用して、STS から一時的な認証情報を取得し、アップロードポリシーを構築し、POST 署名を計算し、コールバックを設定します。

<?php
// Alibaba Cloud SDK をインポートします。
require_once __DIR__ . '/vendor/autoload.php';
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
use AlibabaCloud\Sts\Sts;
// エラー表示を無効にします。
ini_set('display_errors', '0');
$bucket = 'examplebucket'; // バケット名に置き換えてください。
$region_id = 'cn-hangzhou'; // バケットのリージョンに置き換えてください。
$host = 'http://examplebucket.oss-cn-hangzhou.aliyuncs.com'; // バケットのドメイン名に置き換えてください。
$expire_time = 3600; // 有効期限 (秒単位)。
$upload_dir = 'user-dir'; // アップロードファイルのプレフィックス。
// $callbackUrl は、アップロードコールバックを受信するサーバーの URL です。実際の URL に合わせて IP アドレスとポートを置き換えてください。
$callbackUrl = 'http://oss-demo.aliyuncs.com:23450/callback';
// HMAC-SHA256 を計算します。
function hmacsha256($key, $data) {
    return hash_hmac('sha256', $data, $key, true);
}
// POST 署名取得リクエストを処理します。
if ($_SERVER['REQUEST_METHOD'] === 'GET' && $_SERVER['REQUEST_URI'] === '/get_post_signature_for_oss_upload') {
    AlibabaCloud::accessKeyClient(getenv('OSS_ACCESS_KEY_ID'), getenv('OSS_ACCESS_KEY_SECRET'))
        ->regionId('cn-hangzhou')
        ->asDefaultClient();
    // STS リクエストを作成します。
    $request = Sts::v20150401()->assumeRole();
    // STS リクエストを開始し、結果を取得します。
    //  をカスタムセッション名 (例: oss-role-session) に設定してください。
    //  を、指定された OSS バケットにファイルをアップロードする権限を持つ RAM ロールの ARN に置き換えてください。
    $result = $request
        ->withRoleSessionName('oss-role-session')
        ->withDurationSeconds(3600)
        ->withRoleArn(getenv('OSS_STS_ROLE_ARN')) // RAM ロール ARN に置き換えてください。
        ->request();
    // STS リクエストの結果から認証情報を取得します。
    $tokenData = $result->get('Credentials');
    // 返すJSONデータを構築します。
    $tempAccessKeyId = $tokenData['AccessKeyId'];
    $tempAccessKeySecret = $tokenData['AccessKeySecret'];
    $securityToken = $tokenData['SecurityToken'];
    $now = time();
    $dtObj = gmdate('Ymd\THis\Z', $now);
    $dtObj1 = gmdate('Ymd', $now);
    $dtObjPlus3h = gmdate('Y-m-d\TH:i:s.u\Z', strtotime('+3 hours', $now));
    // ポリシーを構築します。
    $policy = [
        "expiration" => $dtObjPlus3h,
        "conditions" => [
            ["bucket" => $bucket],
            ["starts-with", '$key', $upload_dir],
            ["content-length-range", 1, 10240000],
            ["eq", '$success_action_status', '200'],
            ["x-oss-signature-version" => "OSS4-HMAC-SHA256"],
            ["x-oss-credential" => "{$tempAccessKeyId}/{$dtObj1}/cn-hangzhou/oss/aliyun_v4_request"],
            ["x-oss-security-token" => $securityToken],
            ["x-oss-date" => $dtObj],
        ]
    ];
    $policyStr = json_encode($policy);
    // 署名対象文字列を構築します。
    $stringToSign = base64_encode($policyStr);
    // 署名キーを計算します。
    $dateKey = hmacsha256(('aliyun_v4' . $tempAccessKeySecret), $dtObj1);
    $dateRegionKey = hmacsha256($dateKey, 'cn-hangzhou');
    $dateRegionServiceKey = hmacsha256($dateRegionKey, 'oss');
    $signingKey = hmacsha256($dateRegionServiceKey, 'aliyun_v4_request');
    // 署名を計算します。
    $result = hmacsha256($signingKey, $stringToSign);
    $signature = bin2hex($result);
    $callback_param = array(
    'callbackUrl' => $callbackUrl,
    'callbackBody' => 'filename=${object}&size=${size}&mimeType=${mimeType}&height=${imageInfo.height}&width=${imageInfo.width}',
    'callbackBodyType' => "application/x-www-form-urlencoded"
    );
    $callback_string = json_encode($callback_param);
    $base64_callback_body = base64_encode($callback_string);
    // 署名データを返します。
    $responseData = [
        'policy' => $stringToSign,
        'x_oss_signature_version' => "OSS4-HMAC-SHA256",
        'x_oss_credential' => "{$tempAccessKeyId}/{$dtObj1}/cn-hangzhou/oss/aliyun_v4_request",
        'x_oss_date' => $dtObj,
        'signature' => $signature,
        'host' => $host,
        'dir' => $upload_dir,
        'security_token' => $securityToken,
        'callback' => $base64_callback_body,
    ];
    header('Content-Type: application/json');
    echo json_encode($responseData);
    exit;
}
// ホームページのルート。
if ($_SERVER['REQUEST_METHOD'] === 'GET' && $_SERVER['REQUEST_URI'] === '/') {
    echo file_get_contents(__DIR__ . '/public/index.html');
    exit;
}
// その他のルート。
http_response_code(404);
echo json_encode(['message' => 'Not Found']);
exit;
?>