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.
Preparations2h>
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
- g_rdWebServicesHost (Your Hostname where RD WebServices is installed)
- g_accessToken (The token you created in the step before)
- g_ssoToken (optional only if you want to automatically login, create this token in the RD WebServices Admin)
- g_config (rdp config in the rdp file syntax, you can config the connection with an RDP client, save the config and copy the content here)
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:
- rdwchost:s:<Hostname> (Your Hostname where RD WebServices is installed)
- rdwcgatewaytoken:s:<AccessToken> (The token you created in the step before)
- rdwcssotoken:s:<SSOToken> (optional only if you want to automatically login, create this token in the RD WebServices Admin)
Using the embedded webserver, to start the RD WebClient, open https://<Hostname>/webclientci/file.html?file=rdpfile.rdp .