classicvalues / holochrome

Use your IAM role (from instance metadata) to open the AWS console

This is an AdRoll Group-specific fork. Check upstream for a public version.

Holochrome is a chrome extension that allows you to easily spawn an AWS GUI session with a keypress or mouseclick. It is built on top of the aws instance metadata service and therefore encourages security best practices by completely removing the need for static, long-lived credentials. The AWS console session is granted the exact same permissions as the IAM role available via the metadata service.

How do I get it?

Chrome: Chrome Web Store

Firefox: Mozilla Add-on Store

How do I use it?

Either click the icon or use the keyboard shortcut:

Mac: Cmd+Shift+1

Win: Ctrl+Shift+1

The keyboard shortcut is a 'global' listener which will bring Chrome into focus once pressed.

Chrome allows you to modify the keyboard shortcut on the chrome://extensions page. Check out this guide for more details.

How do I get the instance metadata service?

If you run a machine in AWS with an IAM role, it will exist by default and things should run smoothly.

If you want to leverage Holochrome on your local development machine, check out AdRoll's Hologram.

Developing

Follow the Chrome Development Guidelines for loading an unpacked extension. Target the inner holochrome/ folder.

To run tests:

cd test && npm install && npm test

TODO

1. Potentially support the default credential provider chain to allow the AWS console to more closely mimic other AWS services.