AWS SSM port forwarder README
Features
Create and terminate AWS SSM port forwarding sessions from a list of running EC2 and SSM Managed instances.
Select AWS profiles and regions
![Select profile and region](https://github.com/nikki603/aws-port-forwarder/raw/HEAD/docs/select-profile.gif)
Start SSM session
![Start SSM session](https://github.com/nikki603/aws-port-forwarder/raw/HEAD/docs/start-session.gif)
Connect to Port
is equivalent to AWS CLI command:
aws ssm start-session `
--target <instance-id> `
--document-name AWS-StartPortForwardingSession `
--parameters "portNumber=[22],localPortNumber=[22222]" `
--profile default `
--region "us-east-1"
Connect to Remote Host
is equivalent to AWS CLI command:
aws ssm start-session `
--target <instance-id> `
--document-name AWS-StartPortForwardingSessionToRemoteHost `
--parameters "host=[my-rds-db.us-east-1.rds.amazonaws.com],portNumber=[5432],localPortNumber=[25432]" `
--profile default `
--region "us-east-1"
Connect via RDP
is equivalent to the below AWS CLI command. It is available on Windows EC2 instances only. If the session connection is successful and RDP usage is enabled in Settings for this extension, Microsoft Remote Desktop (if installed) will open and automatically connect to remote host port 3389 using a randomly chosen and available local host port (also configurable in Settings). Option currently supported on Windows and MacOS only.
aws ssm start-session `
--target <instance-id> `
--document-name AWS-StartPortForwardingSession `
--parameters "portNumber=[3389],localPortNumber=[22222]" `
--profile default `
--region "us-east-1"
Terminate SSM session
![Terminate SSM session](https://github.com/nikki603/aws-port-forwarder/raw/HEAD/docs/terminate-session.gif)
Requirements
AWS SSM plugin installed
Valid, unexpired credentials in the ~/.aws/credentials or ~/.aws/config files
Microsoft Remote Desktop if the RDP usage option is enabled in Settings