Menu
Amazon AppStream
Developer Guide

This documentation is for an older version of Amazon AppStream. For information about the latest version, see the Amazon AppStream 2.0 Developer Guide.

Signing Requests

Amazon AppStream requires that you authenticate every request you send by signing the request. To sign a request, you calculate a digital signature using a cryptographic hash function, which returns a hash value based on the input. The input includes the text of your request and your secret access key. The hash function returns a hash value that you include in the request as your signature. The signature is part of the Authorization header of your request.

After receiving your request, Amazon AppStream recalculates the signature using the same hash function and input that you used to sign the request. If the resulting signature matches the signature in the request, Amazon AppStream processes the request. Otherwise, the request is rejected.

Amazon AppStream supports authentication using AWS Signature Version 4. The process for calculating a signature can be broken into three tasks:

  • Task 1: Create a Canonical Request

    Create your HTTP request in canonical format as described in Task 1: Create a Canonical Request For Signature Version 4 in the Amazon Web Services General Reference.

  • Task 2: Create a String to Sign

    Create a string that you will use as one of the input values to your cryptographic hash function. The string, called the string to sign, is a concatenation of the name of the hash algorithm, the request date, a credential scope string, and the canonical request from the previous task. The credential scope string itself is a concatenation of date, region, and service information.

    For the X-Amz-Credential parameter, specify:

    • The code for the endpoint to which you're sending the request, for example, us-east-1. For a list of regions and endpoints for Amazon AppStream, see the Regions and Endpoints chapter of the Amazon Web Services General Reference. When specifying the code for the endpoint, include only the part between appstream. and .amazonaws.com

    • appstream for the service abbreviation

    For example:

    X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20130501/us-east-1/appstream/aws4_request

  • Task 3: Create a Signature

    Create a signature for your request by using a cryptographic hash function that accepts two input strings: your string to sign and a derived key. The derived key is calculated by starting with your secret access key and using the credential scope string to create a series of hash-based message authentication codes (HMACs).