HTTP server used to retrieve credentials from Weep automatically

Weep supports emulating the EC2 Instance Metadata Service (IMDS) and the ECS credential provider to provide credentials to your AWS SDK. This is the recommended way to use Weep for the best experience.

This solution can be minimally configured by setting the AWS_CONTAINER_CREDENTIALS_FULL_URI environment variable for your shell or process. There's no need for iptables or routing rules with this approach, and each different shell or process can use weep to request credentials for different roles. Weep will cache the credentials you request in-memory, and will refresh them on-demand when they are within 10 minutes of expiring.

Read about AWS configuration settings and precedence for information about precedence of credential sources.

In one shell, run weep:

weep serve

In your favorite IDE or shell, set the AWS_CONTAINER_CREDENTIALS_FULL_URI environment variable and run AWS commands. The environment variable's value is structured like this:

                                          ▔▔▔▔▔▔▔▔▔ ▔▔▔▔     ▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔
                                                           └─ Role name/search string
                                                   └─ Weep port (probably 9091)
                                          └─ Weep hostname (probably localhost)
AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost:9091/ecs/consoleme_oss_1 aws sts get-caller-identity
   "UserId": "",
   "Account": "123456789012",
   "Arn": "arn:aws:sts::123456789012:assumed-role/consoleme_oss_1_test_user/"

AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost:9091/ecs/consoleme_oss_2 aws sts get-caller-identity
   "UserId": "",
   "Account": "223456789012",
   "Arn": "arn:aws:sts::223456789012:assumed-role/consoleme_oss_2_test_user/"

Configure this environment variable in your IDE for full effect.

IMDS Emulation

This is a more advanced feature. It's more involved to get set up, but it lets you avoid setting an environment variable to use Weep.

AWS SDKs expect IMDS to be served at You will need to set up routing for this functionality to work. Instructions can be found in Advanced Configuration.

To serve the IMDS endpoints, use the serve command along with a role identifier or search string:

weep serve arn:aws:iam::012345678901:role/coolApp
INFO[0000] Starting weep meta-data service...
INFO[0000] Server started on:

  "Code": "Success",
  "LastUpdated": "2018-08-01T15:26:14Z",
  "Type": "AWS-HMAC",
  "AccessKeyId": "ASIA

Last updated