Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2026-08-28 GMT+08:00

Autenticação de assinatura no cabeçalho

Para todas as operações de API do sistema de arquivos de uso geral, a autenticação de identidade pode ser feita transportando assinaturas em cabeçalhos.

No cabeçalho, a assinatura é realizada no campo de autorização do cabeçalho da mensagem HTTP. O formato do cabeçalho da mensagem é o seguinte:

Authorization: OBS AccessKeyID:signature

O processo do algoritmo de assinatura é o seguinte:

1. Construa a string de solicitação (StringToSign).

2. Execute a codificação UTF-8 no resultado obtido na etapa anterior.

3. Use o SK para executar o cálculo da assinatura HMAC-SHA1 no resultado obtido na etapa 2.

4. Execute a codificação Base64 no resultado da etapa 3 para obter a assinatura.

A StringToSign é construída de acordo com as seguintes regras. Tabela 1 descreve os parâmetros.
StringToSign = 
    HTTP-Verb + "\n" + 
    Content-MD5 + "\n" + 
    Content-Type + "\n" + 
    Date + "\n" + 
    CanonicalizedHeaders + CanonicalizedResource
Tabela 1 Parâmetros necessários para a construção de um StringToSign

Parâmetro

Descrição

HTTP-Verb

Um método de solicitação HTTP suportado pela API REST. O valor pode ser um verbo HTTP, como PUT, GET ou DELETE.

Content-MD5

O resumo MD5 de 128 bits codificado em base64 da mensagem de acordo com a RFC 1864. Este parâmetro pode estar vazio.

Content-Type

O tipo de mensagem, por exemplo, text/plain.

Se uma solicitação não contiver esse campo de cabeçalho, esse parâmetro será processado como uma string vazia.

Date

O horário em que uma solicitação é iniciada. Este parâmetro usa o formato de hora RFC 1123. Se o desvio entre a hora especificada por esse parâmetro e a hora do servidor for superior a 15 minutos, o servidor retornará o erro 403.

Este parâmetro é uma string vazia quando o x-obs-date é especificado.

CanonicalizedHeaders

O campo de cabeçalho de solicitação SFS em um cabeçalho de solicitação HTTP, referindo-se a campos de cabeçalho iniciados com x-obs-, por exemplo, x-obs-date, x-obs-acl e x-obs-meta-*.

  1. Todos os caracteres das palavras-chave em um campo de cabeçalho de solicitação devem ser convertidos para letras minúsculas (os valores de conteúdo devem ser sensíveis a maiúsculas e minúsculas, por exemplo, x-obs-storage-class:STANDARD). Se uma solicitação contiver vários campos de cabeçalho, esses campos devem ser organizados por palavra-chave em ordem alfabética de a a z.
  2. Se vários campos de cabeçalho em uma solicitação tiverem o mesmo prefixo, combine os campos de cabeçalho em um. Por exemplo, x-obs-meta-name:name1 e x-obs-meta-name:name2 devem ser reorganizados em x-obs-meta-name:name1,name2. Use uma vírgula para separar dois valores.
  3. Palavras-chave no campo do cabeçalho da solicitação não podem conter caracteres não-ASCII ou irreconhecíveis, que também não são aconselháveis para valores no campo do cabeçalho da solicitação. Se os dois tipos de caracteres forem necessários, eles devem ser codificados e decodificados no lado do cliente. A codificação URL ou a codificação Base64 são aceitáveis, mas o servidor não realiza decodificação.
  4. Exclua espaços e tabulações sem sentido em um campo de cabeçalho. Por exemplo, x-obs-meta-name: name (com um espaço sem sentido na frente de name) deve ser alterado para x-obs-meta-name:name.
  5. Cada campo de cabeçalho ocupa uma linha separada.

CanonicalizedResource

O recurso SFS especificado em uma solicitação HTTP. Este parâmetro é construído da seguinte forma:

CanonicalizedResource = "/" + file system name + "?" + sub-resource
  1. Nome do sistema de arquivos de uso geral, por exemplo, /filesystem/. Se não houver um nome de sistema de arquivos de uso geral, use uma barra (/).
  2. Se houver um sub-recurso, adicione o sub-recurso.

    Identificador de recurso: sfsacl

  3. Se houver vários sub-recursos, classifique-os em ordem alfabética de a a z e use & para combinar os sub-recursos.
NOTA:

Um sub-recurso geralmente é único. Não especifique vários valores para o mesmo sub-recurso (como key=value1&key=value2). Caso contrário, apenas o primeiro valor é usado.

A tabela seguir fornece alguns exemplos de geração de StringToSign.

Tabela 2 Obtenção da ACL de um sistema de arquivos de uso geral

Cabeçalho da solicitação

StringToSign

GET /?sfsacl HTTP/1.1

Host: filesystem.sfs3.region.myhuaweicloud.com

Date: Sat, 12 Oct 2015 08:12:38 GMT

GET \n

\n

\n

Sat, 12 Oct 2015 08:12:38 GMT\n

/filesystem/?sfsacl

Algoritmo Content-MD5 em Java

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
import java.security.MessageDigest;
import sun.misc.BASE64Encoder;
import java.io.UnsupportedEncodingException;
import java.security.NoSuchAlgorithmException;

public class Md5{
     public static void main(String[] args) {
          try {
                 String exampleString = "blog";
                 MessageDigest messageDigest = MessageDigest.getInstance("MD5"); 
                 BASE64Encoder encoder = new BASE64Encoder(); 
                 String contentMd5 = encoder.encode(messageDigest.digest(exampleString.getBytes("utf-8")));
                 System.out.println("Content-MD5:" + contentMd5);    
          } catch (NoSuchAlgorithmException | UnsupportedEncodingException e) 
          {
                 e.printStackTrace();
          }
     }
}
A assinatura é gerada da seguinte forma com base no StringToSign e SK. O algoritmo de código de autenticação de mensagem baseado em hash (algoritmo HMAC) é usado para gerar a assinatura.
Signature = Base64( HMAC-SHA1( YourSecretAccessKeyID, UTF-8-Encoding-Of( StringToSign ) ) )

Por exemplo, para criar um sistema de arquivos de uso geral chamado newfilesystem2 em uma região, o formato da solicitação do cliente é o seguinte:
PUT / HTTP/1.1 
Host: newfilesystem2.sfs3.region.myhuaweicloud.comContent-Length: length
Date: Fri, 06 Jul 2018 03:45:51 GMT
x-obs-acl:private
x-obs-storage-class:STANDARD
Authorization: OBS UDSIAMSTUBTEST000254:ydH8ffpcbS6YpeOMcEZfn0wE90c=

<CreateBucketConfiguration xmlns="http://obs.myhwclouds.com/doc/2015-06-30/">    <Location>region</Location> </CreateBucketConfiguration>

Algoritmo de assinatura em Java

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Base64;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.TreeMap;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

import org.omg.CosNaming.IstringHelper;


public class SignDemo {
	private static final String SIGN_SEP = "\n";
	private static final String SFS_PREFIX = "x-obs-";
	private static final String DEFAULT_ENCODING = "UTF-8";
	private static final List<String> SUB_RESOURCES = Collections.unmodifiableList(Arrays.asList(
			"CDNNotifyConfiguration", "acl", "append", "attname", "backtosource", "cors", "customdomain", "delete",
			"deletebucket", "directcoldaccess", "encryption", "inventory", "length", "lifecycle", "location", "logging",
			"metadata", "modify", "name", "notification", "orchestration", "partNumber", "policy", "position", "quota",
			"rename", "replication", "requestPayment", "response-cache-control", "response-content-disposition",
			"response-content-encoding", "response-content-language", "response-content-type", "response-expires",
			"restore", "select", " storageClass", "storagePolicy", "storageinfo", "tagging", "torrent", "truncate",
			"uploadId", "uploads", "versionId", "versioning", "versions", "website", "x-image-process",
			"x-image-save-bucket", "x-image-save-object", "x-obs-security-token"));
	private String ak;
	private String sk;
	 public String urlEncode(String input) throws UnsupportedEncodingException
    {
		return URLEncoder.encode(input, DEFAULT_ENCODING)
        .replaceAll("%7E", "~") //for browser
        .replaceAll("%2F", "/")
        .replaceAll("%20", "+");
    }
	private String join(List<?> items, String delimiter)
    {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < items.size(); i++)
        {
	String item = items.get(i).toString();
            sb.append(item);
            if (i < items.size() - 1)
            {
                sb.append(delimiter);
            }
        }
        return sb.toString();
    }
	private boolean isValid(String input) {
		return input != null && !input.equals("");
	}
	public String hamcSha1(String input) throws NoSuchAlgorithmException, InvalidKeyException, UnsupportedEncodingException {
		SecretKeySpec signingKey = new SecretKeySpec(this.sk.getBytes(DEFAULT_ENCODING), "HmacSHA1");
		Mac mac = Mac.getInstance("HmacSHA1");
		mac.init(signingKey);
		return Base64.getEncoder().encodeToString(mac.doFinal(input.getBytes(DEFAULT_ENCODING)));
	}
	private String stringToSign(String httpMethod, Map<String, String[]> headers, Map<String, String> queries,
			String bucketName, String objectName) throws Exception{
		String contentMd5 = "";
		String contentType = "";
		String date = "";
		TreeMap<String, String> canonicalizedHeaders = new TreeMap<String, String>();
		String key;
		List<String> temp = new ArrayList<String>();
		for(Map.Entry<String, String[]> entry : headers.entrySet()) {
			key = entry.getKey();
			if(key == null || entry.getValue() == null || entry.getValue().length == 0) {
				continue;
			}
			key = key.trim().toLowerCase(Locale.ENGLISH);
			if(key.equals("content-md5")) {
				contentMd5 = entry.getValue()[0];
				continue;
			}
			if(key.equals("content-type")) {
				contentType = entry.getValue()[0];
				continue;
			}
			if(key.equals("date")) {
				date = entry.getValue()[0];
				continue;
			}
			if(key.startsWith(OBS_PREFIX)) {
				for(String value : entry.getValue()) {
					if(value != null) {
						temp.add(value.trim());
					}
				}
				canonicalizedHeaders.put(key, this.join(temp, ","));
				temp.clear();
			}
		}
		if(canonicalizedHeaders.containsKey("x-obs-date")) {
			date = "";
		}
		// handle method/content-md5/content-type/date
		StringBuilder stringToSign = new StringBuilder();
		stringToSign.append(httpMethod).append(SIGN_SEP)
			.append(contentMd5).append(SIGN_SEP)
			.append(contentType).append(SIGN_SEP)
			.append(date).append(SIGN_SEP);
		// handle canonicalizedHeaders
		for(Map.Entry<String, String> entry : canonicalizedHeaders.entrySet()) {
			stringToSign.append(entry.getKey()).append(":").append(entry.getValue()).append(SIGN_SEP);
		}
		// handle CanonicalizedResource
		stringToSign.append("/");
		if(this.isValid(bucketName)) {
			stringToSign.append(bucketName).append("/");
			if(this.isValid(objectName)) {
				stringToSign.append(this.urlEncode(objectName));
			}
		}
		TreeMap<String, String> canonicalizedResource = new TreeMap<String, String>();
		for(Map.Entry<String, String> entry : queries.entrySet()) {
			key = entry.getKey();
			if(key == null) {
				continue;
			}
			if(SUB_RESOURCES.contains(key)) {
				canonicalizedResource.put(key, entry.getValue());
			}
		}
		if(canonicalizedResource.size() > 0) {
			stringToSign.append("?");
			for(Map.Entry<String, String> entry : canonicalizedResource.entrySet()) {
				stringToSign.append(entry.getKey());
				if(this.isValid(entry.getValue())) {
					stringToSign.append("=").append(entry.getValue());
				}
			}
		}
//		System.out.println(String.format("StringToSign:%s%s", SIGN_SEP, stringToSign.toString()));
		return stringToSign.toString();
	}
	public String headerSignature(String httpMethod, Map<String, String[]> headers, Map<String, String> queries,
			String bucketName, String objectName) throws Exception {

		//1. stringToSign
		String stringToSign = this.stringToSign(httpMethod, headers, queries, bucketName, objectName);
		//2. signature
		return String.format("OBS %s:%s", this.ak, this.hamcSha1(stringToSign));
	}
	public String querySignature(String httpMethod, Map<String, String[]> headers, Map<String, String> queries,
			String bucketName, String objectName, long expires) throws Exception {
		if(headers.containsKey("x-obs-date")) {
			headers.put("x-obs-date", new String[] {String.valueOf(expires)});
		}else {
			headers.put("date", new String[] {String.valueOf(expires)});
		}
		//1. stringToSign
		String stringToSign = this.stringToSign(httpMethod, headers, queries, bucketName, objectName);
		//2. signature
		return this.urlEncode(this.hamcSha1(stringToSign));
	}
	public static void main(String[] args) throws Exception {
		SignDemo demo = new SignDemo();
		demo.ak = "<your-access-key-id>";
		demo.sk = "<your-secret-key-id>";
		String bucketName = "bucket-test";
		String objectName = "hello.jpg";
		Map<String, String[]> headers = new HashMap<String, String[]>();
		headers.put("date", new String[] {"Sat, 12 Oct 2015 08:12:38 GMT"});
		headers.put("x-obs-acl", new String[] {"private"});
		Map<String, String> queries = new HashMap<String, String>();
		queries.put("acl", null);
		System.out.println(demo.headerSignature("PUT", headers, queries, bucketName, objectName));
	}
}

O resultado do cálculo da assinatura é o seguinte (varia com o tempo de execução): YdH8ffpcbS6YpeOMcEZfn0wE90c=

Algoritmo de assinatura em Python

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import sys
import os 
import hashlib
import hmac
import binascii
from datetime import datetime
IS_PYTHON2 = sys.version_info.major == 2 or sys.version < '3'
"""Hard-coded or plaintext SecretAccessKeyID is risky. For security purposes, encrypt your access key, store it in the configuration file or environment variables, and decrypt it before using it. In this example, SecretAccessKeyID is stored in the environment variables for identity authentication. Before running the code in this example, configure environment variable SECRET_ACCESS_KEY_ID."""
yourSecretAccessKeyID = os.environ.get('SECRET_ACCESS_KEY_ID')
httpMethod = "PUT"
contentType = "application/xml"
httpMethod = "PUT"
contentType = "application/xml"
# "date" is the time when the request was actually generated
date = datetime.utcnow().strftime('%a, %d %b %Y %H:%M:%S GMT')
canonicalizedHeaders = "x-obs-acl:private\n"
CanonicalizedResource = "/newfilesystem2"
canonical_string = httpMethod + "\n" + "\n" + contentType + "\n" + date + "\n" + canonicalizedHeaders + CanonicalizedResource
if IS_PYTHON2:    
     hashed = hmac.new(yourSecretAccessKeyID, canonical_string, hashlib.sha1)    
     encode_canonical = binascii.b2a_base64(hashed.digest())[:-1]
else:    
     hashed = hmac.new(yourSecretAccessKeyID.encode('UTF-8'), canonical_string.encode('UTF-8'),hashlib.sha1)    
     encode_canonical = binascii.b2a_base64(hashed.digest())[:-1].decode('UTF-8')
print encode_canonical

O resultado do cálculo da assinatura é o seguinte (varia com o tempo de execução): YdH8ffpcbS6YpeOMcEZfn0wE90c=

Algoritmo de assinatura na linguagem de programação C

Baixe o código de exemplo para calcular a assinatura na linguagem de programação C.

  1. A API para calcular a assinatura está contida no arquivo de cabeçalho sign.h.
  2. O código de exemplo para calcular a assinatura está contido no arquivo de cabeçalho main.c.

Tratamento de erros de incompatibilidade de assinatura

Durante uma chamada de API do SFS, se o seguinte erro for relatado,

Código de status: 403 Forbidden

Código de erro: SignatureDoesNotMatch

Mensagem de erro: A assinatura da solicitação que calculamos não corresponde à assinatura que você forneceu. Verifique sua chave e método de assinatura.

Entre em contato com o suporte técnico.