ThinRDP Server offers a mechanism to generate One-Time-URL connections that expire after a given period of time.
|
The One-Time-URL feature is designed to work with the Access Profiles and User/Password Security Levels. |
|
You have to configure an ApiKey on ThinRDP Server in order to use this method. |
These are some situations in which the One-Time-URL might be useful:
a. Giving access to a desktop to external users without having to weaken the Security level to None.
b. Generating a temporary access to a desktop.
c. Integrating ThinRDP on a Single-Sign-On Scheme along with external applications.
How it works:
1. First you need to ask ThinRDP to generate the URL for you. Call ThinRDP Server following this URL format:
http(s)://ThinRDPServer:Port/ws/oturl/get?<queryString> |
2. The queryString should be built with all parameters listed below:
apikey= <apikey> &apiuser= <apiuser> &model= <model> &plen= <passlen> &expires= <expires> |
Find on the table below a description for each required parameter.
Parameter |
Description |
apiKey |
The ApiKey is a secret value, known only by ThinRDP Server and the corporate application. Find out more about it on the ApiKey topic. |
apiuser |
Use this parameter to identify the user within ThinRDP. The value should be the user or email registered in your website. The users are seen in the Analytics Web Service. |
model |
Send a profile key in order make this profile a template for the One-Time-URL connection that will be established. |
plen |
The plen parameter carries the password length. |
expires |
Through this parameter you can set an expiration(in minutes) for the URL. Expires = 30 means that the URL won't work anymore after 30 minutes from the URL generation. |
On the next topics you can find out other parameters you can use to Configure the connection and Enable features.
3. If ThinRDP gets to authenticate with the parameters sent on the queryString, it will return a One-Time-URL that will allow you to establish an RDP connection with the remote desktop.
/oturl.html?key=w7NJNschBdJD9e6G6luWhOCalM$oFW7guqC6jE1IQah3AJm3&pass=BOWZB8FG |
Concatenate the ThinRDP Server address to the generated URL, following this format below:
http(s)://ThinRDPServer:Port/oturl.html?key=w7NJNschBdJD9e6G6luWhOCalM$oFW7guqC6jE1IQah3AJm3&pass=BOWZB8FG |
This way, the URL will be ready to be used. You can redirect your application to the desktop connection through it, or even send it to an external user by e-mail.
|
Find an HTML/ajax example inside the application installation directory, under the 'webrdp' folder. The file is named oturltest.html and implements the features covered on this topic. |