FastX consists of two components: the FastX REST API and the Xrdp web client
The FastX REST API
These are the API calls that are used to set up the XRDP connection and manage the sessions (listing, starting,terminating etc)
Now start your client for the xrdp connection (remember to change 'zeta' to 'localhost' in your client settings). All sessions have a Idle time out, which is 36 h for now. You need to connect to your sessions at least once per day. Otherwise the sessions is killed. This is to prevent overloading of the server with stale remote. Mar 26, 2021 xRDP is a free and open-source implementation of Windows Remote Desktop Protocol (RDP), that started in 2004. With RDP you can connect to a another computer over a network and control it through its graphical user interface, and use it almost as if you were sitting right in front of it. Oct 31, 2012 First, is there any way to have XRDP server the gnome-classic desktop instead of Unity? I can easily access the Precise manchine now from my Windows 7 machine using Windows Remote Desktop Connection and logging into the LANIP 192.168.0.197 using my username & password.
The Xrdp web client
This is the component that does the actual connection to the FastX server to display graphics and interact with the session. The xrdp web client is built using AngularJS and a custom set of RDP libraries. The FastX API gets all the needed information to make an XRDP connection using the Xrdp web client.
The basic xrdp web client is located at
https://your.fastx.server.com:3443/xrdp
The Xrdp client takes a single get parameter which is a JSON object encoded in base64
https://your.fastx.server.com:3443/xrdp#base_64_encoded_json
The JSON object contains all the parameters needed to connect to the FastX session.
These parameters usually come from the result of the /api/connect call.
The JSON object contains
- port — (int) the rdp port the session is listening on
- RdpPort — (int) optional alias for port
- username — (string) username to display
- password — (string) password generated from the /api/connect or /api/share call
- id — (string) session id
- geometry — (string) widthxheight of the session
When building a custom client, use the FastX api to get all the needed information to create the URL
https://your.fastx.server.com:3443/xrdp#base_64_encoded_json
and then launch the URL in an iframe to connect.
Using FastX API in conjunction with /xrdp
The /xrdp client connects through a websocket and communicates via xrdp channels directly to the xrdp session. xrdp and the fastx api operate independently of each other. However there are instances when the it will benefit clients to use the FastX API in an Xrdp session. Set the token from /api/login as a cookie (named “token”) to allow XRDP to access the token.
Built In FastX Clients
/connect
This is the basic client for FastX.
https://your.fastx.server.com:3443/connect?session-id
it checks to see if you have logged in and redirects to the login page if not. It makes a /api/connect using the session-id GET parameter and generates a JSON object to send to /xrdp
/share
This is the sharing client for fastx
https://your.fastx.server.com:3443/connect?base_64_encoded_sharing_info
This is the URL generated when turning on sharing. It will call /api/share to get the connection information and then generate a JSON object to send to /xrdp
-->Applies to: Windows 10, Windows 8.1, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2
You can control a remote PC by using a Microsoft Remote Desktop client. The client can run on almost any device, including on your mobile smartphone. The client gives you the same powers you would have if you could reach the PC's keyboard. Through the client, you can:
- Operate the apps that are installed on the PC.
- Access the files and network resources of the PC.
- Leave the apps open when you end the client.
Before you start, see the supported configuration article. The article discusses the PC configurations that the Remote Desktop clients can connect to. Also see the client FAQ article.
The following client apps are available:
Client | Get the app | Documentation | Latest version |
---|---|---|---|
Windows Desktop | Windows Desktop client | Get started, What's new | 1.2.1844 |
Microsoft Store | Windows 10 client in the Microsoft Store | Get started, What's new | 1.2.1810 |
Android | Android client in Google Play | Get started, What's new | 10.0.10 |
iOS | iOS client in the App Store | Get started, What's new | 10.2.5 |
macOS | macOS client in the App Store | Get started, What's new | 10.6.1 |
Configuring the remote PC
To configure your remote PC before accessing it remotely, see Allow access to your PC.
Remote Desktop client URI scheme
Xrdp Windows Client Windows 10
You can integrate features of Remote Desktop clients across platforms by enabling a Uniform Resource Identifier (URI) scheme. Learn about the supported URI attributes that you can use with the iOS, Mac, and Android clients.