Skip to content

Latest commit

 

History

History
39 lines (23 loc) · 2.05 KB

README.md

File metadata and controls

39 lines (23 loc) · 2.05 KB

Token Vending Machine

The vending machine generates temporary credentials to your AWS account - access and secret keys for APIs and a URL for the AWS console. The generated temporary credentials has access permissions that is the intersection of

1. The policy that is passed into the `GetFederationToken` call, and
2. Policies that are attached to the IAM user whose credentials were used to all `GetFederationToken`.

See docs for more details.

The temporary credentials are defaulted to expire after 15 minutes (900 seconds), which is the minimum session duration. A longer expiration can be specified, in seconds, using the -x flag, up to 36 hours (129600 seconds).

Setup

Setup AWS credentials the same way you would for AWS CLI. See SDK Configuration and AWS CLI Configuration for more information.

Usage

tvm [-p profile] [-u tempUsername] [-x sessionDuration]

profile AWS credential profile, defaults to the default profile if none is specified.

tempUsername username associated with the temporary credentials, defaults to temp-user if none is specified.

sessionDuration is in seconds, defaults to 900 seconds if none are specified.

tvm tries to read a policy file policy.json in the same directory. If the policy file is not present, it will default to allow all on all resources. The generated credentials will still end up having permissions that are the intersection of this and the permissions of the IAM user used to call this tool (you can't have more permissions than the IAM user used!)

Example

tvm -u foobar -x 3600

References

Creating a URL that Enables Federated Users to Access the AWS Management Console