arsd - AWS Role Speed Dial

A desktop app to manage sessions and roles for one or more AWS SSO domains.

Feature Wishlist

• Support default heirarchy of roles (prefer readonly, then working, then ...)
• Allow tagging for environments or other account groupings
• Dump available roles to AWS config
• Support credential-process for CLI and SDKs such as CDK/Go SDK V1 that lack native SSO integration
• Support multiple SSO domains

Usage

1. Download the .dmg from Releases
2. Drag arsd.app to /Applications
3. Control-click arsd.app and select "Open"
4. You will see an "Unidentified Developer" prompt. Select continue, or build the application locally
5. Follow the Configuration steps to add your SSO partition
6. Optionally, add aliases for accounts and roles to make them easier to remember

Configuration

Configs are in the os-appropriate application configuration dir. On MacOS this is /Users/your.name/Library/Application Support/io.rsb.arsd. Under left-side menu, the config path is copyable if you don't already have a config file set up.

Below, find an example with one partition set up with an Amazon Web Services Identity and Access Management Identity Center (formerly known as AWS SSO). You will need your start URL, account ID, and region of the IAM Identity Center install.

partitions:
- start_url: https://d-123abc.awsapps.com/start#
  region: us-west-2
  account_id: 999888777666
aliases:
  accounts:
    "[email protected]": payer
  roles:
    Annoyingly-Long-Role-Name: Abbrev

Development Environment

So far this has only ever been developed or tested on MacOS. Godspeed.

Recommended IDE Setup

• VS Code + Volar + Tauri + rust-analyzer

Type Support For .vue Imports in TS

Since TypeScript cannot handle type information for .vue imports, they are shimmed to be a generic Vue component type by default. In most cases this is fine if you don't really care about component prop types outside of templates. However, if you wish to get actual prop types in .vue imports (for example to get props validation when using manual h(...) calls), you can enable Volar's Take Over mode by following these steps:

1. Run Extensions: Show Built-in Extensions from VS Code's command palette, look for TypeScript and JavaScript Language Features, then right click and select Disable (Workspace). By default, Take Over mode will enable itself if the default TypeScript extension is disabled.
2. Reload the VS Code window by running Developer: Reload Window from the command palette.

You can learn more about Take Over mode here.

Credits

Awsume for inspiring the open-in-console functionality.

Amazon Web Services service icons from AWS