Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/knutkirkhorn/cisco-vpn-rdp-connecter
Connect to Cisco AnyConnect VPN and open a Microsoft Remote Desktop (RDP) window
https://github.com/knutkirkhorn/cisco-vpn-rdp-connecter
anyconnect cisco cli command-line-tool nodejs rdp vpn
Last synced: 2 months ago
JSON representation
Connect to Cisco AnyConnect VPN and open a Microsoft Remote Desktop (RDP) window
- Host: GitHub
- URL: https://github.com/knutkirkhorn/cisco-vpn-rdp-connecter
- Owner: knutkirkhorn
- License: mit
- Created: 2022-01-15T18:31:40.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-09T15:18:12.000Z (over 1 year ago)
- Last Synced: 2024-11-19T01:28:00.770Z (3 months ago)
- Topics: anyconnect, cisco, cli, command-line-tool, nodejs, rdp, vpn
- Language: TypeScript
- Homepage:
- Size: 1.73 MB
- Stars: 11
- Watchers: 1
- Forks: 17
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cisco-vpn-rdp-connecter
> Connect to Cisco AnyConnect VPN and open a Microsoft Remote Desktop (RDP) window
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
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.