Screenshot AWS API Gateway

The AWS API Gateway (http://aws.amazon.com) provides a means to forward event data to AWS services in the cloud for additional processing. Lambda is an amazon service that allows a user to run code on an amazon cluster without needing to set one up.

Platform Setup

Log into your amazon account and click the services navigation item in the navigation bar. Then click the lambda option under the compute section.

Screenshot

Once you have entered the lambda section of AWS click the Create a Lambda function button.

Screenshot

Then select the blueprint you wish to use. A blueprint is basically a pre-made lambda function that you can use.

Click on the "Blank Function" tile.

Screenshot

Configure the lambda trigger, this is the method that activates the lambda function. In our case, we support the AWS API gateway. Screenshot Screenshot

Now you can configure your function, this part will be based on your implementation. Screenshot

Once your function is configured, you can review all your changes. Review the configuration and confirm it is correct, hit the create function button at the bottom of the review page. Next you need to configure the API Gateway to use API keys instead AWS IAM. Click on the ANY link (you will need the URL under 'API Gateway' later). Screenshot

From here click the Method Request link. Screenshot

Configure the gateway with the following settings (Authorization NONE and API Key Required). Screenshot

Return to the previous page and then click Integration request. Screenshot

There, simply disable Lambda proxy integration.

Screenshot

Next you need to make the Usage Plan for the API Gateway. Screenshot

Now click the Add API Stage Button. After you create it, hit the Next button.

Screenshot

Now hit the 'Create API Key and add to Usage Plan' button. This will launch a dialog that allows you to create an API Key for this usage plan.

Screenshot

Deploy your changes to the API Gateway. Navigate back to the API Gateway. Screenshot

Using the actions menu, hit deploy API.

Screenshot

Select the correct deployment stage from the dropdown in the resulting dialog and then hit deploy. Screenshot

Notifier Setup

Specify the Server Name, Function Name, and API Key into the provided [Notification Target][notify] fields. The URL you grabbed earlier will look like this:

      https://example.execute-api.region.amazonaws.com/prod/ExampleName

Copy the following segment of the URL into the Server Name field:

      example.execute-api.region.amazonaws.com

then copy the remaing segment of the URL (including the staging area name), shown here, into the Function Name field.

      /prod/ExampleName

The token is an optional field that is passed through to the AWS API Gateway as a token field. This field is to help give the AWS Lambda function some user defined information.