# Memo: SSM Session and Port Forwarding

### Docs

* [Link1](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html#start-ec2-console)
    
* [Link2](https://aws.amazon.com/blogs/aws/new-port-forwarding-using-aws-system-manager-sessions-manager)
    

### Install

[Session Manger Plugin](https://docs.aws.amazon.com/systems-manager/latest/userguide/install-plugin-macos-overview.html)

[AWS SSM Proxy. Optional](https://github.com/qoomon/aws-ssm-ec2-proxy-command)

### Start basic ssh connection

```shell
    aws ssm start-session \
    --target i-askfsa8asld
```

### Port Forwarding

```shell
aws ssm start-session \
    --target i-00e68c055d1c0b087 \
    --document-name AWS-StartPortForwardingSession \
    --parameters '{"portNumber":["remote-host-port"], "localPortNumber":["local-port"]}'
```

### Port Forwarding to Remote host

```shell
aws ssm start-session \
    --target i-00e68c055d1c0b087 \
    --document-name AWS-StartPortForwardingSessionToRemoteHost \
    --parameters '{"host":["remote-host-ip"],"portNumber":["remote-host-port"], "localPortNumber":["local-port"]}'
```