文档中心

鉴权示例

最近更新时间：2023.03.16 17:01:30

首次发布时间：2022.08.24 18:12:16

本文档将为您介绍 veImageX 域名配置中鉴权方式A、鉴权方式B、鉴权方式C 、鉴权方式D的实现方法，以下为具体的 Demo 示例。

Golang

Java

Python

PHP

func getMD5(s string) string {
   h := md5.New()
   h.Write([]byte(s))
   return hex.EncodeToString(h.Sum(nil))
}

// 鉴权方式A
func authA(domain, path, secretKey, signParam string) string {
   ts := time.Now().Unix()
   rand := "rand"  // "rand" by default, any value you defined is ok
   uid := "imagex" // "imagex" by default, any value you defined is ok

   //path + timestamp + rand + uid + key
   signTxt := fmt.Sprintf("%s-%d-%s-%s-%s", path, ts, rand, uid, secretKey)
   sign := getMD5(signTxt)
   signValue := fmt.Sprintf("%d-%s-%s-%s", ts, rand, uid, sign)
   return fmt.Sprintf("http://%s%s?%s=%s", domain, path, signParam, signValue)
}

// 鉴权方式B
func authB(domain, path, secretKey string) string {
   tn := time.Now()
   tStr := tn.Format("200601021504")

   //key + tStr + path
   signTxt := fmt.Sprintf("%s%s%s", secretKey, tStr, path)
   sign := getMD5(signTxt)
   signPath := fmt.Sprintf("/%s/%s", tStr, sign)
   return fmt.Sprintf("http://%s%s%s", domain, signPath, path)
}

// 鉴权方式C
func authC(domain, path, secretKey string) string {
   ts := time.Now().Unix()

   //key + path + hex(ts)
   signTxt := fmt.Sprintf("%s%s%x", secretKey, path, ts)
   sign := getMD5(signTxt)
   signPath := fmt.Sprintf("/%s/%x", sign, ts)
   return fmt.Sprintf("http://%s%s%s", domain, signPath, path)
}

// 鉴权方式D
func authD(domain, path, secretKey, signParam, timestampFormat, timestampParam string) string {
   ts := time.Now().Unix()
   tsStr := fmt.Sprintf("%d", ts)
   if timestampFormat == "hex" {
      tsStr = fmt.Sprintf("%x", ts)
   }

   //key + path + ts
   signTxt := fmt.Sprintf("%s%s%s", secretKey, path, tsStr)
   sign := getMD5(signTxt)
   qs := url.Values{}
   qs.Add(signParam, sign)
   qs.Add(timestampParam, tsStr)

   return fmt.Sprintf("http://%s%s?%s", domain, path, qs.Encode())
}

func main() {
   domain := "example.volcimagex.cn"
   uri := "<input resource uri>"
   tpl := "input resource template"
   format := "input output image format"

   // 图片资源
   path := fmt.Sprintf("/%s~%s.%s", uri, tpl, format)
   // 素材托管
   //path = fmt.Sprintf("/%s", uri)

   signParam := "<input sign parameter key>"
   mainSecretKey := "<input secret key>"
   u := authA(domain, path, mainSecretKey, signParam)
   fmt.Println("URL: ", u)

   u = authB(domain, path, mainSecretKey)
   fmt.Println("URL: ", u)

   u = authC(domain, path, mainSecretKey)
   fmt.Println("URL: ", u)

   timeParam := "<input timestamp parameter key>"
   //十进制 or 十六进制
   timeFormat := "<input timestamp format>"
   u = authD(domain, path, mainSecretKey, signParam, timeFormat, timeParam)
   fmt.Println("URL: ", u)
}

import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.sql.Timestamp;
import java.text.SimpleDateFormat;
import java.time.Instant;
import java.util.Date;
import java.util.TimeZone;

public class URLSigner {

    private String getHex(byte[] raw) {
        if (raw == null) {
            return null;
        }
        final StringBuilder hex = new StringBuilder(2 * raw.length);
        for (final byte b : raw) {
            String HEXES = "0123456789abcdef";
            hex.append(HEXES.charAt((b & 0xF0) >> 4)).append(HEXES.charAt((b & 0x0F)));
        }
        return hex.toString();
    }

    private String getMd5(String data) {
        String ret;
        try {
            MessageDigest h = MessageDigest.getInstance("md5");
            byte[] digest = h.digest(data.getBytes(StandardCharsets.UTF_8));
            ret = getHex(digest);
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
        return ret;
    }

    SimpleDateFormat formatter = new SimpleDateFormat("yyyyMMddHHmmss");
    {
        formatter.setTimeZone(TimeZone.getTimeZone("UTC"));
    }

    /**
     * 鉴权方式 A
     */
    public String authA(String domain, String path, String secretKey, String nonce, String uid, String parameterName) {
        long ts = (Instant.now().getEpochSecond());
        String signText = String.format("%s-%d-%s-%s-%s", path, ts, nonce, uid, secretKey);
        String sign = getMd5(signText);
        String signValue = String.format("%d-%s-%s-%s", ts, nonce, uid, sign);
        return String.format("https://%s%s?%s=%s", domain, path, parameterName, signValue);
    }

    /**
     * 鉴权方式 B
     */
    public String authB(String domain, String path, String secretKey) {
        Instant ts = Instant.now();
        String tStr = formatter.format(new Date(Timestamp.from(ts).getTime()));
        String signText = String.format("%s%s%s", secretKey, tStr, path);
        String sign = getMd5(signText);
        String signPath = String.format("/%s/%s", tStr, sign);
        return String.format("https://%s%s%s", domain, signPath, path);
    }

    /**
     * 鉴权方式 C
     */
    public String authC(String domain, String path, String secretKey) {
        long ts = (Instant.now().getEpochSecond());
        String signText = String.format("%s%s%x", secretKey, path, ts);
        String sign = getMd5(signText);
        String signPath = String.format("/%s/%x", sign, ts);
        return String.format("https://%s%s%s", domain, signPath, path);
    }

    /**
     * 鉴权方式 D
     */
    public String authD(String domain, String path, String secretKey, String signParameterName, boolean timestampFormatInHex, String timestampParameterName) {
        long ts = (Instant.now().getEpochSecond());
        String tsStr = "" + ts;
        if (timestampFormatInHex) {
            tsStr = String.format("%x", ts);
        }
        String signText = String.format("%s%s%s", secretKey, path, tsStr);
        String sign = getMd5(signText);
        return String.format("https://%s%s?%s=%s&%s=%s", domain, path, signParameterName, sign, timestampParameterName, tsStr);
    }

    private void run() {
        String domain = "example.volcimagex.cn";
        String key = "<input secret key>";
        String path = "<input file path>";
        System.out.println(authA(domain, path, key, "anything_you_like", "anything_you_like", "sign"));
        System.out.println(authB(domain, path, key));
        System.out.println(authC(domain, path, key));
        System.out.println(authD(domain, path, key, "sign", false, "time"));
        System.out.println(authD(domain, path, key, "sign", true, "time"));
    }

    public static void main(String[] args) {
        URLSigner signer = new URLSigner();
        signer.run();
    }
}

import hashlib
import time
from datetime import datetime
from requests.models import PreparedRequest

def get_md5(s):
    m = hashlib.md5()
    m.update(s.encode('utf-8'))
    return m.hexdigest()
# 鉴权方式A
def auth_a(domain, path, secret_key, sign_param):
    ts = int(time.time())
    rand = "rand" # "rand" by default, any value you defined is ok
    uid = "imagex" # "imagex" by default, any value you defined is ok
    
    signTxt = f"{path}-{ts}-{rand}-{uid}-{secret_key}"
    sign = get_md5(signTxt)
    sign_value = f"{ts}-{rand}-{uid}-{sign}"
    return f"http://{domain}{path}?{sign_param}={sign_value}"
# 鉴权方式B
def auth_b(domain, path, secret_key):
    cur_time = datetime.today().strftime("%Y%m%d%H%M")
    sign = get_md5(f"{secret_key}{cur_time}{path}")
    sign_path = f"/{cur_time}/{sign}"
    return f"http://{domain}{sign_path}{path}"
# 鉴权方式C    
def auth_c(domain, path, secret_key):
    ts = int(time.time())
    signTxt = f"{secret_key}{path}{ts}"
    sign = get_md5(signTxt)
    sign_path = f"/{sign}/{ts}"
    return f"http://{domain}{sign_path}{path}"
# 鉴权方式D    
def auth_d(domain, path, secret_key, sign_param, timestamp_format, timestamp_param):
    ts = int(time.time())
    tsStr = "%x" %(ts) if timestamp_format == "hex" else "%d" % (ts)
    
    signTxt = f"{secret_key}{path}{tsStr}"
    sign = get_md5(signTxt)
    params = {sign_param: sign, timestamp_param: tsStr}
    url = f"http://{domain}{path}"
    req = PreparedRequest()
    req.prepare_url(url, params)
    return req.url

def main():
    domain = "example.volcimagex.cn"
    uri = "<input resource uri>"
    tpl = "input resource template"
    format = "input output image format"

    path = f"/{uri}~{tpl}.{format}"    # 图片资源
    #path = f"/{uri}"    #素材托管

    sign_param = "<input sign parameter key>"
    mainsecret_key = "<input secret key>"

    u = auth_a(domain, path, mainsecret_key, sign_param)
    print("URL: ", u)

    u = auth_b(domain, path, mainsecret_key)
    print("URL: ", u)

    u = auth_c(domain, path, mainsecret_key)
    print("URL: ", u)

    timeParam = "<input timestamp parameter key>"
    timeFormat = "<input timestamp format>"        #十进制 or 十六进制
    u = auth_d(domain, path, mainsecret_key, sign_param, timeFormat, timeParam)
    print("URL: ", u)

if __name__ == "__main__":
    main()

<?php

namespace Volc\Service\ImageX;

class Signer
{
    public $scheme = "https:";

    /**
     * 鉴权方式 A
     */
    public function authA(string $domain, string $path, string $secretKey, string $nonce, string $uid, string $parameterName)
    {
        $ts = time();
        $signText = sprintf("%s-%d-%s-%s-%s", $path, $ts, $nonce, $uid, $secretKey);
        $sign = strtolower(md5($signText));
        $signValue = sprintf("%d-%s-%s-%s", $ts, $nonce, $uid, $sign);
        return sprintf("%s//%s%s?%s=%s", $this->scheme, $domain, $path, $parameterName, $signValue);
    }

    /**
     * 鉴权方式 B
     */
    public function authB(string $domain, string $path, string $secretKey)
    {
        $ts = time();
        $tStr = date("YmdHis", $ts);
        $signText = sprintf("%s%s%s", $secretKey, $tStr, $path);
        $sign = strtolower(md5($signText));
        $signPath = sprintf("/%s/%s", $tStr, $sign);
        return sprintf("%s//%s%s%s", $this->scheme, $domain, $signPath, $path);
    }

    /**
     * 鉴权方式 C
     */
    public function authC(string $domain, string $path, string $secretKey)
    {
        $ts = time();
        $signText = sprintf("%s%s%x", $secretKey, $path, $ts);
        $sign = strtolower(md5($signText));
        $signPath = sprintf("/%s/%x", $sign, $ts);
        return sprintf("%s//%s%s%s", $this->scheme, $domain, $signPath, $path);
    }

    /**
     * 鉴权方式 D
     */
    public function authD(string $domain, string $path, string $secretKey, string $signParameterName, bool $timestampFormatInHex, string $timestampParameterName)
    {
        $ts = time();
        if ($timestampFormatInHex) {
            $tsStr = sprintf("%08x", $ts);
        } else {
            $tsStr = sprintf("%d", $ts);
        }
        $signText = sprintf("%s%s%s", $secretKey, $path, $tsStr);
        $sign = strtolower(md5($signText));
        return sprintf("%s//%s%s?%s=%s&%s=%s", $this->scheme, $domain, $path, $signParameterName, $sign, $timestampParameterName, $tsStr);
    }

    private function run()
    {
        $domain = "example.volcimagex.cn";
        $key = "<input secret key>";
        $path = "<input file path>";
        echo($this->authA($domain, $path, $key, "anything_you_like", "anything_you_like", "sign"));
        echo("\n");
        echo($this->authB($domain, $path, $key));
        echo("\n");
        echo($this->authC($domain, $path, $key));
        echo("\n");
        echo($this->authD($domain, $path, $key, "sign", false, "time"));
        echo("\n");
        echo($this->authD($domain, $path, $key, "sign", true, "time"));
    }

    public static function main() {
        $signer = new static;
        $signer->run();
    }

}

if ($argv && $argv[0] && realpath($argv[0]) === __FILE__) {
    Signer::main();
}