Custom Integration Quickstart Guide

WebServer

Either use your own webserver to host the custom Integration or use the build in webserver of RD WebServices.

Build in WebServer

The build in WebServer is reachable under the url https://<Hostname>/webclientci and the files are located at "c:\ProgramData\Thincast\RDWebServices\webclientci" per default under Windows and at "\var\lib\rdwebservices\webclientci" per default under linux.

Preparations

Custom IntegrationSample Files

The custom integration example files are installed at "c:\ProgramData\Thincast\RDWebServices\webclientci-examples" under windows and at "\usr\share\doc\rdwebservices\webclientci-examples" under Linux. To use the Embedded Client Example or the File Client Example you need to copy the desired files to the webserver directory.

Generate Custom Integration Token

Open the RD WebService Admin and navigate to WebClient / Custom Integration. Add a new Custom Integration Token and copy the value.

Add Custom Integration User to Client and Server Policies

To allow custom integration connections, the custom integration user "BUILTIN\RDWebClient-CustomIntegrationUser" has to be added as user to a client policy and a server policy. Open the desired Client Policy, click the "Requirements" tab and add the user "BUILTIN\RDWebClient-CustomIntegrationUser". Then open the desired Server Policy, click the tab "Users/Groups" and also add the user "BUILTIN\RDWebClient-CustomIntegrationUser".

Embedded Client Example

Copy the file embedded_template.html from the example directory to the webserver directory, for example use example1.html and open it with a text editor. Set the correct Values for Using the embedded webserver, open https://<Hostname>/webclientci/example1.html to start the RD WebClient.

File Client Example

Copy the file file.html from the example directory to the webserver directory. Create or copy an RDP file also to the webserver directory (for example rdpfile.rdp). Open the RDP file with an editor and add the following options: Using the embedded webserver, to start the RD WebClient, open https://<Hostname>/webclientci/file.html?file=rdpfile.rdp .