AWS Request Signing

Third Party
Related Documentation
Incompatible with
konnect
Compatible Protocols
http https
Minimum Version
Kong Gateway - 3.4
Third Party: This plugin is developed, tested, and maintained by The LEGO Group.

The AWS Request Signing plugin allows for secure communication with AWS Lambdas. It signs requests with AWS SIGV4 and temporary credentials obtained from sts.amazonaws.com using an OAuth token. This eliminates the need for an AWS API Gateway and simplifies the use of Lambdas as upstreams in Kong Gateway.

Install the AWS Request Signing plugin

Set up your AWS account and install the Kong AWS Request Signing plugin via Luarocks.

Prerequisites

To use this plugin, you have to prepare your AWS account. Add your token issuer to the Identity Providers in your AWS account so that the plugin can request temporary credentials.

For more information on the required AWS setup, visit the plugin repo.

Once your AWS account is set up, you can use the plugin to communicate with your Lambda HTTPS endpoint.

Install

You can install the AWS Request Signing plugin via LuaRocks. A Lua plugin is distributed in .rock format, which is a self-contained package that can be installed locally or from a remote server.

  1. Install the AWS Request Signing plugin:

    luarocks install https://github.com/LEGO/kong-aws-request-signing/raw/main/rocks/kong-aws-request-signing-$PLUGIN_VERSION.all.rock
    

    Substitute $PLUGIN_VERSION with one of available plugin versions.

  2. Update your loaded plugins list in Kong Gateway.

    In your kong.conf, append aws-request-signing to the plugins field. Make sure the field isn’t commented out.

    plugins = bundled,aws-request-signing
    
  3. Restart Kong Gateway:

    kong restart
    
Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!