Skip to content

Latest commit

 

History

History
125 lines (92 loc) · 9.22 KB

README.md

File metadata and controls

125 lines (92 loc) · 9.22 KB
Raw

Myrtille

Myrtille provides a simple and fast access to remote desktops, SSH and remote applications through a web browser, without any plugin, extension or configuration.

Technically, Myrtille is an HTTP(S) to RDP and SSH gateway.

How does it work?

It works by forwarding the user inputs (keyboard, mouse, touchscreen) from a web browser to an HTTP(S) gateway, then up to an RDP (or SSH) client which maintains a session with an RDP (or SSH) server.

The display resulting, or not, of such actions is streamed back to the browser, from the rdp (or ssh) client and through the gateway.

The implementation is quite straightforward in order to maintain the best speed and stability as possible. Some optimizations, such as inputs buffering and display quality tweaking, help to mitigate with latency and bandwidth issues.

More information in the DOCUMENTATION.md file.

Features

  • HTTP(S) to RDP and SSH gateway (new in version 2.0.0!)
  • Hyper-V VM direct connection
  • Multifactor Authentication
  • Active Directory integration (hosts management)
  • Session sharing (collaborative mode)
  • Start remote application from URL
  • File transfer (local and roaming accounts)
  • PDF Virtual Printer
  • HTML4 and HTML5 support
  • Responsive design
  • Remote clipboard support
  • PNG, JPEG and WEBP compression
  • Realtime connection information
  • On-screen/console/logfile debug information
  • fully parameterizable

Requirements

  • Browser: any HTML4 or HTML5 browser (starting from IE6!). No extension or administrative rights required.
  • Gateway (myrtille): IIS 7 or greater (preferably IIS 8+ with websocket protocol enabled) and .NET 4.5+
  • RDP server: any RDP enabled machine (preferably Windows Server but can also be Windows XP, 7, 8, 10 or Linux xRDP server)
  • SSH server: any SSH server (tests were made using the built-in Windows 10 OpenSSH server)

Resources

Myrtille does support multiple connections/tabs in cookieless session mode. From version 1.9.0, this mode is disabled by default (OWASP recommendation) but can still be enabled, if required (into web.config, carefully read comments there).

There is no limitation about the maximal number of concurrent users beside what the rdp (or ssh) server(s) can handle (number of CALs, CPU, RAM?).

Regarding the gateway, a simple dual core CPU with 4GB RAM can handle up to 50 simultaneous sessions (about 50MB RAM by rdp client process, even less for ssh).

Each session uses about 20KB/sec bandwidth with the browser.

Build

Microsoft Visual Studio 2015. See DOCUMENTATION.md.

Installation

All releases here: https://github.com/cedrozor/myrtille/releases

See DOCUMENTATION.md for more details.

Usage

Once Myrtille is installed on your server, you can use it at http://myserver/myrtille. Set the rdp (or ssh) server address, user domain (if any, for rdp), name and password then click "Connect!" to log in. "Disconnect" to log out.

Multifactor Authentication and Active Directory integration (Enterprise Mode) are disabled by default. Please read documentation for activation of these features.

You can connect a remote desktop and start a program automatically from an url (see DOCUMENTATION.md). From version 1.5.0, Myrtille does support encrypted credentials (aka "password 51" into .rdp files) so the urls can be distributed to third parties without compromising on security.

The installer provides the option to create or not a self-signed certificate for https://myserver/myrtille. Like for all self-signed certificates, you will have to add a security exception into your browser (just ignore the warning message and proceed to the website). Usage of https is recommended to secure your remote connection. Of course, you can avoid that by installing a certificate provided by a trusted Certification Authority (see DOCUMENTATION.md).

If you want connection information, you can enable stat (displayed on screen or browser console). If you want debug information, you can enable debug (most traces are disabled (commented) into the .js files but can be enabled (uncommented) as needed). Hidden from version 1.5.0 (can be enabled into default.css).

You can also choose the rendering mode, HTML4 or HTML5 (HTML4 may be useful, for example, if websockets are blocked by a proxy or firewall). Hidden (autodetected) from version 1.5.0 (can be enabled into default.css).

On touchscreen devices, you can pop the device keyboard with the "Keyboard" button. Then enter some text and click "Send". This can be used, for example, to paste the local clipboard content and send it to the server (then it be copied from there, within the remote session). Alternatively, you can run osk.exe (the Windows on screen keyboard, located into %SystemRoot%\System32) within the remote session. It can even be run automatically on session start (https://www.cybernetman.com/kb/index.cfm/fuseaction/home.viewArticles/articleId/197).

The remote clipboard content can also be retrieved locally with the "Clipboard" button (text format only).

You can upload/download file(s) to/from the user documents folder with the "Files" button. Note that it requires the rdp server to be localhost (same machine as the http server) or a domain to be specified. Not available for SSH.

You can print any document on a local or network printer by using the "Myrtille PDF" (redirected) virtual printer. Simply use the print feature of your application, then open/print the downloaded pdf.

From version 2.1.0, you can connect an Hyper-V VM directly (console session). It can be useful if remote desktop access is not enabled on the VM (i.e: Linux VMs), if the VM doesn't have a network connection (or is on a different network for security reasons, or use DHCP) or simply to be able to connect the VM during system startup or shutdown. See notes and limitations for information to connect an Hyper-V VM and the differences with a standard RDP connection.

Third-party

Myrtille uses the following licensed software:

See DISCLAIMERS.md file.

The Myrtille code in FreeRDP is surrounded by region tags "#pragma region Myrtille" and "#pragma endregion".

libWebP are official Google's WebP precompiled binaries, and are left unmodified.

License

Myrtille is licensed under Apache 2.0 license. See LICENSE file.

Author

Cedric Coste ([email protected]).

Contributors

  • Catalin Trifanescu (AppliKr developer: application server. Steemind cofounder)
  • Fabien Janvier (AppliKr developer: website css, clipping algorithm, websocket server)
  • UltraSam (AppliKr developer: rdp client, http gateway)
  • Paul Oliver (Olive Innovations Ltd: MFA, enterprise mode, SSH terminal)

Links