serverless-sts-caller-id

Serverless plugin to get the user ID belonging to the current AWS credentials using STS (Security Token Service)

Usage no npm install needed!

<script type="module">
  import serverlessStsCallerId from 'https://cdn.skypack.dev/serverless-sts-caller-id';
</script>

README

Serverless STS Caller ID

A Serverless Plugin for the Serverless Framework which helps allows to retrieve the user ID belonging to the AWS credentials currently being used with the help of STS (Security Token Service).

Introduction

This plugins does the following:

  • It provides a variable (stsCallerId) that contains the user ID of the AWS credentials being used

Installation and configuration

In your service root, run:

npm install --save-dev serverless-sts-caller-id

Add the plugin to serverless.yml:

plugins:
  - serverless-sts-caller-id

Usage

You can use the custom variable stsCallerId in serverless.yml. For example:

provider:
  stage: ${stsCallerId}

If you want to get a SHA1 hashed version of the ID, you can use stsCallerId:hashed:

provider:
  stage: ${stsCallerId:hashed}

You can also truncate the hash to a specific length:

provider:
  stage: ${stsCallerId:hashed:8}

TODO

  • Add tests

Release History

  • 2018/03/27 - v1.0.0 - Initial version

License

Copyright (c) 2018 Nordcloud, licensed for users and contributors under MIT license. https://github.com/SC5/serverless-sts-caller-id/blob/master/LICENSE