Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SmartFinn/eve-ng-integration
integrates EVE-NG (aka UNetLab) with Linux desktop
https://github.com/SmartFinn/eve-ng-integration
eve-ng linux telnet unetlab url-handler
Last synced: 3 months ago
JSON representation
integrates EVE-NG (aka UNetLab) with Linux desktop
- Host: GitHub
- URL: https://github.com/SmartFinn/eve-ng-integration
- Owner: SmartFinn
- License: mit
- Created: 2016-03-24T16:50:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-29T09:07:26.000Z (12 months ago)
- Last Synced: 2024-06-03T09:38:46.429Z (5 months ago)
- Topics: eve-ng, linux, telnet, unetlab, url-handler
- Language: Shell
- Homepage: http://git.io/eve-ng-integration
- Size: 1.13 MB
- Stars: 304
- Watchers: 24
- Forks: 115
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EVE-NG Integration [](https://github.com/SmartFinn/eve-ng-integration/releases)
This repo contains the equivalent of EVE-NG (aka UNetLab) [Windows Client Side Pack](http://www.eve-ng.net/index.php/downloads/windows-client-side-pack) for Ubuntu/Debian and other Linux distros.
Currently supports the following URL schemes:
* `telnet://`
* `capture://`
* `docker://`
* `vnc://` _(via Vinagre)_
Includes a script to work with .rdp files that are generated by EVE-NG.
## Demo
## Installation
### Ubuntu and derivatives
You can install eve-ng-integration from the official [PPA](https://launchpad.net/~smartfinn/+archive/ubuntu/eve-ng-integration):
```
sudo add-apt-repository ppa:smartfinn/eve-ng-integration
sudo apt-get update
sudo apt-get install eve-ng-integration
```
or download .deb packages from [here](https://launchpad.net/~smartfinn/+archive/ubuntu/eve-ng-integration/+packages).
### Install script
Alternatively, you can install eve-ng-integration from terminal using the following command:
```
wget -qO- https://raw.githubusercontent.com/SmartFinn/eve-ng-integration/master/install.sh | sh
```
This method works on most Linux distros. Tested on **Arch Linux**, **Manjaro**, **Fedora**, **openSUSE**, **CentOS**, and potentially works with other systems.
If your Linux distribution is not supported yet, don't give up, try [Manual install](#manual-install) or [open a new issue](https://github.com/SmartFinn/eve-ng-integration/issues/new).
### Unofficial packages
Packages in this section are not part of the official repositories. If you have a problem or a question, please contact the package maintainer.
| **Distro** | **Maintainer** | **Package** |
| :--------- | :-------------- | :--------------------------------------- |
| Arch Linux | Konstantin Shalygin | [eve-ng-integration](https://aur.archlinux.org/packages/eve-ng-integration) AUR |
**NOTE:** If you are a maintainer and want to be in the list, please create an issue or make a pull request.
#### Manual install
1. Clone this repo
```
git clone https://github.com/SmartFinn/eve-ng-integration.git
```
or download and extract the tarball
```
wget -O eve-ng-integration.tar.gz https://github.com/SmartFinn/eve-ng-integration/archive/master.tar.gz
tar -xzvf eve-ng-integration.tar.gz
```
2. Run `make install` as root
```
cd eve-ng-integration/
sudo make install
```
3. Install dependencies
* `python3` _(required)_
* `telnet` _(required)_
* `wireshark` _(recommended)_
* `ssh-askpass` _(recommended)_
* `vinagre` _(recommended)_
* `docker` _(optional)_
4. Enjoy!
## Known issues
1. #### Error `Couldn't run /usr/bin/dumpcap in child process: Permission denied` when starting Wireshark
Add your user to `wireshark` group:
```
sudo usermod -a -G wireshark $USER
```
If you use a Debian-like distro, you can run the next command and choose answer as `Yes`:
```
sudo dpkg-reconfigure wireshark-common
```
You will need to log out and then log back in again for this change to take effect.
2. #### Error `End of file on pipe magic during open` when starting Wireshark
Install `ssh-askpass` package for your distro, or setup SSH key-based authentication with EVE-NG (UNetLab) machine.
3. #### Click on a node does not open an app (opens another app) in all browsers
Execute the following commands to set the `eve-ng-integration.desktop` as default handler for telnet, capture, and docker URL schemes:
```bash
mkdir -p ~/.local/share/applications/
xdg-mime default eve-ng-integration.desktop x-scheme-handler/capture
xdg-mime default eve-ng-integration.desktop x-scheme-handler/telnet
xdg-mime default eve-ng-integration.desktop x-scheme-handler/docker
xdg-mime default eni-rdp-wrapper.desktop application/x-rdp
```
4. #### Does not work in Google Chrome but works in another browser
Quit Chrome and reset protocol handler with the command:
```bash
sed -i.orig 's/"\(telnet\|capture\|docker\)":\(true\|false\),\?//g' "$HOME/.config/google-chrome/Default/Preferences"
```
**NOTE**: Path to the `Preferences` file will be different for Chromium and other Chromium-based browsers.
5. #### Does not work in Firefox but works in another browser
Go to `Preferences → Applications` (or paste `about:preferences#applications` in your address bar) and change Action to `Always ask` for telnet, capture and docker Content Types.
6. #### Firefox says `The address wasn't understood` when you clicked on a node
- Type `about:config` into the Location Bar (address bar) and press Enter.
- Right-click → New → Boolean → Name: `network.protocol-handler.expose.telnet` → Value → `false` (Repeat this for each supported protocol)
- Next time you click a link of protocol-type foo you will be asked which application to open it with.
See also [http://kb.mozillazine.org/Register_protocol](http://kb.mozillazine.org/Register_protocol#Firefox_3.5_and_above)
7. #### Chrome/Chromium downloads RDP files instead of opening
To make RDP file open on your browser, instead of downloading, you have to download the file type once, then right after that download, look at the status bar at the bottom of the browser. Click the arrow next to that file and choose "Always open files of this type". Done.
See also https://stackoverflow.com/a/24290187/1446494
If your problem hasn't been solved or reported, please [open a new issue](https://github.com/SmartFinn/eve-ng-integration/issues).
English, Russian, and Ukrainian are welcomed.