marktiedemann / cisco-vpn Goto Github PK

Wrapper around the Cisco AnyConnect VPN client.

JavaScript 100.00%

cisco-vpn's Introduction

cisco-vpn

Wrapper around the Cisco AnyConnect VPN client.

Installation

npm install cisco-vpn

Quickstart

const vpn = require('cisco-vpn')({
    server: 'vpn.example.org',
    username: 'uncreative-username',
    password: 'super-secret-password'
})

vpn.connect()
    .then(() => console.log('connected!'))

// some time later
vpn.disconnect()
    .then(() => console.log('disconnected!'))

API

`require('cisco-vpn')(options)`

options <Object>:
- exe <String>: default: C:/Program Files (x86)/Cisco/Cisco AnyConnect Secure Mobility Client/vpncli.exe
- server <String>: required
- username <String>: required
- password <String>: required
returns the vpn <Object>

`vpn.connect()`

returns a <Promise> which:
- resolves if the vpn was connected
- rejects if an error occured

`vpn.disconnect()`

returns a <Promise> which:
- resolves if the vpn was disconnected
- rejects if an error occured

License

WTFPL – Do What the F*ck You Want to Public License.

Made with ❤️ by @MarkTiedemann.

cisco-vpn's People

Contributors

Stargazers

Watchers

Forkers

ztmdsbt mikalv khangvan mfahnerpymnt markaphillips norsig hwf452 dengyaolong photonicdev cyb3r0

cisco-vpn's Issues

Cannot connect due to missing group

The Cisco AnyConnect CLI asks for group before asking for username. This prevents the client from connecting due to username being inserted at the group input. Example part of command-line output:

  >> Please enter your username and password.
    0) <Group0>
    1) <Group1>
Group: [<Group1>] <username-from-module>

Username: [<username>] <password-from-module>
Password:

I have tested with adding 1\n before username at writeFile and that solves the issue.

Know about this?

UnhandledPromiseRejectionWarning: Error: Command failed: "C:/Program Files (x86)/Cisco/Cisco AnyConnect Secure Mobility Client/vpncli.exe" connect someServer.com -s < /tmp/vpn-31cEIYST2AzHXR.txt
node-app | /bin/sh: 1: C:/Program Files (x86)/Cisco/Cisco AnyConnect Secure Mobility Client/vpncli.exe: not found

Know why this came up perhaps?

I looked at the path but I don't know why it didn't work.

Thanks if you can help. Cool repo here!

Can I use it on unix based systems?

Hi,

I'm sorry if that's a silly question but is there a way to run it on MacOS or Ubuntu? I'm using Cisco AnyConnect Client on MacOS because that's the only way company allows it and wan't to make sql query over vpn.
That's the result:
vpncli.exe: cannot execute binary file

MacOS / node / cisco-vpn package - up to date.

`disconnect` requires inputs

The disconnect method requires a vpn being set with inputs.

Examples

const ciscoVpn = require('cisco-vpn');

// This throws error
// => `Error: Missing server`
await ciscoVpn({}).disconnect();

// This works
await ciscoVpn({server: '', username: '', password: ''}).disconnect();

This seems to be caused by throw-if-missing being used on the parameters server, username and password.

Exporting both connect and disconnect functions separately could solve this.

Allow Groups

Please can this branch be pushed to master

https://github.com/mfahner-p/cisco-vpn/tree/patch-1

as it allows the option of groups - alternatively I can create a PR of this branch and update the Readme to allow for these options - thanks