Skip to content

knutkirkhorn/cisco-vpn-rdp-connecter

Repository files navigation

cisco-vpn-rdp-connecter

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

See FAQ for more details and background.

CLI

Install

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

npm install cisco-vpn-rdp-connecter

Usage

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.