Skip to main content

Introduction

Granted is a command line interface (CLI) application which simplifies access to cloud roles and allows multiple cloud accounts to be opened in your web browser simultaneously. The goals of Granted are:

  • Provide a fast experience around finding and assuming roles
  • Leverage native browser functionality to allow multiple accounts to be accessed at once
  • Encrypt cached credentials to avoid plaintext SSO tokens being saved on disk

A screenshot of the AWS Console on Firefox with two tabs: the first tab is blue and is the 'role-a' profile, and the second tab is orange and is the 'role-b' profile

Supported cloud providers

Granted currently supports AWS. If you'd like to see support for another cloud provider please let us know by opening an issue on GitHub!

On AWS, Granted works with both IAM roles and with AWS SSO. We highly recommend using Granted with AWS SSO as it avoids having long-lived IAM credentials on your device.

Supported browsers

Granted currently supports Firefox and Chromium-based browsers (such as Chrome, Brave, and Edge).

tip

We recommend using Firefox with Granted as it has the best user experience when accessing multiple cloud consoles, even if it's not your daily driver browser.

On Firefox Granted uses Multi-Account Containers to view multiple cloud accounts. Multiple cloud accounts can be opened in the same window and they are color-coded for easy reference. In order to use Granted with Firefox you'll need to download our Firefox addon. The extension requires minimal permissions and does not have access to web page content. You can read more about security considerations for the extension here.

On Chromium-based browsers Granted uses Profiles. Each cloud account is opened in a separate window.

Why create Granted?

As cloud practitioners we follow best practices and use multi-account environments. This frequently led to situations where we were cross-referencing resources or viewing logs across multiple accounts. When using the AWS console this becomes quite painful as only one account and region is accessible at a time per browser.

Yes, one way to solve this is to simply stop using the console and develop your own abstractions and visualisation layer on top of AWS's APIs. However, we believe the native console can be a useful tool for viewing your cloud resources; namely because you don't need to build anything yourself in order to use it.

An additional motivation on developing Granted is the way that the AWS CLI handles session credentials when using AWS SSO. We're big fans of AWS SSO as it removes the need for long-lived IAM credentials; however the AWS CLI stores the SSO access token in plaintext. If this token is compromised it can be painful to revoke. Granted offers an improvement over the AWS CLI in this regard, as the SSO access token is stored in the system's keychain rather than on disk.

We've been using Granted internally for all our cloud access at Common Fate for the past few months and we've found it's greatly increased our productivity when working in the cloud.

Get started

Follow the Getting Started guide to start using Granted for your cloud access.