Merge branch 'master' into fix-path-issues

Author: b-b3rn4rd

README.md

@@ -14,18 +14,24 @@ The code is based on the following article https://docs.aws.amazon.com/IAM/lates
 
 The goal of this plugin is to simplify the authentication process to AWS Console, by providing a method to login to a given account without leaving the terminal.
 
-# Installation & Usage
+# Installation
 To install it as a plugin for `awscli` please follow these steps
 
 Install `awscli-console-plugin` using `pip`, use an appropriate artifact for your OS from the release page. 
 ```bash
-$ pip install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.0.0/awscli-console-plugin_1.0.0_Darwin_x86_64.zip # MacOS
-$ pip install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.0.0/awscli-console-plugin_1.0.0_Linux_x86_64.zip # Linux
-$ pip install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.0.0/awscli-console-plugin_1.0.0_Windows_x86_64.zip # Windows
+$ pip3 install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.2.0/awscli-console-plugin_1.2.0_Darwin_x86_64.zip # MacOS
+$ pip3 install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.2.0/awscli-console-plugin_1.2.0_Linux_x86_64.zip # Linux
+$ pip3 install https://github.com/b-b3rn4rd/awscli-console-plugin/releases/download/1.2.0/awscli-console-plugin_1.2.0_Windows_x86_64.zip # Windows
 ```
 
-Modify the `plugins` sections in the `~/.aws/config` file
-```bash
+
+# Configuration
+
+Edit your `~/.aws/config` to include the following plugin definition:
+
+If you are using the v1 AWS CLI, you can just add the plugin:
+
+```
 [plugins]
 console = console
 
@@ -39,6 +45,26 @@ region=ap-southeast-2
 source_profile=auth
 ```
 
+If you are using the v2 AWS CLI, you need to also specify the `cli_legacy_plugin_path`, which should
+specify where your `pip` packages are installed.
+
+```
+[plugins]
+cli_legacy_plugin_path = <path to your python3.7/site-packages>
+console = console
+
+[profile auth]
+region=ap-southeast-2
+aws_access_key_id=AKIAXXXXXXXXXXX
+aws_secret_access_key=XYXYXYYXYXYXYXYXY/ZZZZZZ
+[profile dev]
+role_arn=arn:aws:iam::1234567890123:role/OrganizationAccountAccessRole
+region=ap-southeast-2
+source_profile=auth
+```
+
+ # Usage
+
 Verify that the plugin is successfully installed
 ```bash
 $ aws console help
@@ -66,4 +92,4 @@ OPTIONS
 Usage Example
 ```bash
 aws console --profile dev
-```
+```