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 AWS credentials the same way you would for AWS CLI. See SDK Configuration and AWS CLI Configuration for more information.
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!)
tvm -u foobar -x 3600
Creating a URL that Enables Federated Users to Access the AWS Management Console