Creare una AWS API richiesta firmata

• HTTPMethod — Il HTTP metodo, ad esempioGET, PUTHEAD, eDELETE.

• CanonicalUri — La versione con URI codifica del componente del percorso assolutoURI, a partire da / quella che segue il nome di dominio e fino alla fine della stringa o fino al punto interrogativo (?) se sono presenti parametri della stringa di query. Se il percorso assoluto è vuoto, utilizzate una barra (). / L'URIesempio seguente/amzn-s3-demo-bucket/myphoto.jpg, è il percorso assoluto e non lo codificate / nel percorso assoluto:

  http://s3.amazonaws.com/amzn-s3-demo-bucket/myphoto.jpg

• CanonicalQueryString — I parametri della URI stringa di interrogazione con codifica. Si URI codifica singolarmente ogni nome e valore. È inoltre necessario ordinare i parametri nella stringa di query canonica in ordine alfabetico in base al nome della chiave. L'ordinamento avviene dopo la codifica. La stringa di query nell'URIesempio seguente è:

  http://s3.amazonaws.com/amzn-s3-demo-bucket?prefix=somePrefix&marker=someMarker&max-keys=2

  La stringa di query canonica è la seguente (le interruzioni di riga vengono aggiunte a questo esempio a fini di leggibilità):

  UriEncode("marker")+"="+UriEncode("someMarker")+"&"+
  UriEncode("max-keys")+"="+UriEncode("20") + "&" +
  UriEncode("prefix")+"="+UriEncode("somePrefix")

  Quando una richiesta è indirizzata a una sottorisorsa, il valore del parametro di query corrispondente sarà una stringa vuota (""). Ad esempio, quanto segue URI identifica la ACL sottorisorsa nel bucket: amzn-s3-demo-bucket

  http://s3.amazonaws.com/amzn-s3-demo-bucket?acl

  In questo caso, sarebbe: CanonicalQueryString

  UriEncode("acl") + "=" + ""

  Se URI non include a?, non è presente alcuna stringa di query nella richiesta e si imposta la stringa di query canonica su una stringa vuota ()"". Dovrai comunque includere il carattere di nuova riga (). "\n"

• CanonicalHeaders — Un elenco di intestazioni di richiesta con i relativi valori. Le singole coppie di nome e valore dell'intestazione sono separate dal carattere di nuova riga (). "\n" Di seguito è riportato un esempio di: CanonicalHeader

  Lowercase(<HeaderName1>)+":"+Trim(<value>)+"\n"
  Lowercase(<HeaderName2>)+":"+Trim(<value>)+"\n"
  ...
  Lowercase(<HeaderNameN>)+":"+Trim(<value>)+"\n"

  CanonicalHeaders l'elenco deve includere quanto segue:

  • HTTPhostintestazione.

  • Se l'Content-Typeintestazione è presente nella richiesta, è necessario aggiungerla al CanonicalHeaders elenco.

  • Devi aggiungere anche qualsiasi intestazione x-amz-* che desideri includere nella richiesta. Ad esempio, se utilizzi credenziali di sicurezza temporanee, nella tua richiesta devi includere x-amz-security-token. È necessario aggiungere questa intestazione nell'elenco di CanonicalHeaders.

  Nota

  L'x-amz-content-sha256intestazione è necessaria per le richieste Amazon AWS S3. Fornisce un hash del payload di richiesta. Se non è presente alcun payload, devi indicare l'hash di una stringa vuota.

  Il nome di ogni intestazione deve:

  • usare caratteri minuscoli.

  • in ordine alfabetico.

  • essere seguito da due punti ():.

  Per i valori, devi:

  • eliminare eventuali spazi all’inizio o alla fine.

  • convertire gli spazi sequenziali in uno spazio singolo.

  • separare i valori per un'intestazione multivalore con virgole.

  • È necessario includere l'intestazione host (HTTP/1.1) o l'intestazione:authority (HTTP/2) e tutte le intestazioni nella firma. x-amz-* Facoltativamente puoi includere altre intestazioni standard nella firma, ad esempio content-type.

  Le funzioni Lowercase() e Trim() utilizzate in questo esempio sono descritte nella sezione precedente.

  Di seguito è riportata una stringa CanonicalHeaders di esempio. I nomi di intestazione sono in caratteri minuscoli e in ordine alfabetico.

  host:s3.amazonaws.com
  x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  x-amz-date:20130708T220855Z

  Nota

  Ai fini del calcolo di una firma di autorizzazione, sono richiesti solo l'host e qualsiasi altra intestazione x-amz-*; tuttavia, per evitare la manomissione dei dati, nel calcolo della firma è consigliabile includere tutte le intestazioni.

• SignedHeaders — Un elenco in ordine alfabetico e separati da punto e virgola di nomi di intestazioni di richiesta in lettere minuscole. Le intestazioni della richiesta nell'elenco sono le stesse che hai incluso nella stringa CanonicalHeaders. Nell'esempio precedente, il valore di SignedHeaders sarebbe il seguente:

  host;x-amz-content-sha256;x-amz-date

• HashedPayload — Una stringa creata utilizzando il payload nel corpo della HTTP richiesta come input per una funzione hash. Questa stringa utilizza caratteri esadecimali minuscoli.

  Hex(SHA256Hash(<payload>>))

  Se non è presente alcun payload nella richiesta, si calcola un hash della stringa vuota, ad esempio quando si recupera un oggetto utilizzando una GET richiesta, non c'è nulla nel payload.

  Hex(SHA256Hash(""))

  Nota

  Per Amazon S3, includi la stringa letterale UNSIGNED-PAYLOAD durante la creazione di una richiesta canonica e imposta lo stesso valore dell'x-amz-content-sha256intestazione quando invii la richiesta.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm — L'algoritmo utilizzato per creare l'hash della richiesta canonica. Per SHA -256, l'algoritmo è. AWS4-HMAC-SHA256

• RequestDateTime — La data e l'ora utilizzate nell'ambito delle credenziali. Questo valore è l'UTCora corrente nel formato ISO 8601 (ad esempio,20130524T000000Z).

• CredentialScope — L'ambito delle credenziali, che limita la firma risultante alla regione e al servizio specificati. La stringa ha il seguente formato: YYYYMMDD/region/service/aws4_request.

• HashedCanonicalRequest — L'hash della richiesta canonica, calcolato nel passaggio precedente.

Input richiesto

• Key, una stringa che contiene la chiave di accesso segreta.

• Date, una stringa che contiene la data utilizzata nell'ambito delle credenziali, nel formato YYYYMMDD.

• Region, una stringa che contiene il codice regionale (ad esempio,us-east-1).

  Per un elenco delle stringhe Regional, consulta Regional Endpoints in. Riferimenti generali di AWS

• Service, una stringa che contiene il codice di servizio (ad esempio,ec2).

• La stringa da firmare creata nel passaggio precedente.