cisco-vpn-rdp-connecter/README.md

Connect to Cisco AnyConnect VPN and open a Microsoft Remote Desktop (RDP) window

# cisco-vpn-rdp-connecter

> Connect to Cisco AnyConnect VPN and open a Microsoft Remote Desktop (RDP) window

<img src="media/demo.gif" width="500">

See [FAQ](#faq) for more details and background.

## CLI

### Install

```sh
npm install --global cisco-vpn-rdp-connecter
```

### Usage

```
$ cisco-vpn-rdp-connecter --help

  Usage
    $ cisco-vpn-rdp-connecter

  Commands
    <none>            Connect to both VPN and RDP
    disconnect, d     Disconnect from both VPN and RDP
    status, s         Show connection statuses for VPN and RDP
    print-config, p   Print the VPN and RDP config

  Options
    --setup, -s       Setup the credentials for Cisco VPN and Microsoft RDP
    --only-vpn, -o    Only connect to VPN
    --save            Used together with --only-vpn to change the default command behavior
    --show-password   Show password in plain text when printing the password
```

## API

### Install

```sh
npm install cisco-vpn-rdp-connecter
```

### Usage

```js
import {connectToVpnAndOpenRdp} from 'cisco-vpn-rdp-connecter';

const vpnCredentials = {
    server: 'server.name',
    group: '1',
    username: 'knut',
    password: 'super_secure_password'
};
const rdpServer = 'rdp.server.name';

await connectToVpnAndOpenRdp(vpnCredentials, rdpServer);
```

### Exports

#### connectToVpn(server, group, username, password)

#### openRdpWindow(server)

#### connectToVpnAndOpenRdp(vpnCredentials, rdpServer)

#### isCiscoAnyConnectInstalled()

#### isCiscoVpnConnected()

#### isRdpWindowOpened()

#### getAllCiscoVpnGroups(server)

#### getCiscoVpnDefaults()

#### getRdpDefaults()

#### disconnectFromVpn()

#### closeRdpWindow()

## FAQ

### Why this CLI?

Instead of:

1. open Cisco AnyConnect
2. type in credentials and connect
3. open Microsoft Remote Desktop
4. select server and connect

Just open a terminal and type `cisco-vpn-rdp-connecter` to do all that without the hassle.

I personally use this to efficiently connect to a remote work computer.