Thinfinity® Remote Desktop 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 Thinfinity® Remote Desktop 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 Thinfinity® Remote Desktop Server on a Single-Sign-On Scheme along with external applications.
How it works:
1. First you need to ask Thinfinity® Remote Desktop Server to generate the URL for you. Call Thinfinity® Remote Desktop Server server following this URL format:
http(s)://ThinfinityRDP: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 Thinfinity® Remote Desktop Server and the corporate application. Find out more about it on the ApiKey topic. |
apiuser |
Use this parameter to identify the user within Thinfinity® Remote Desktop Server. The value should be the user or email registered in your website. The users are seen in the Analytics Web Service. |
model |
Send the profile key of the profile you want to to connect to. The profile's settings will work as a template for the One-Time-URL connection that will be established. You can modify these settings by adding more parameters to the One-time-URL. |
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 Thinfinity® Remote Desktop Server 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 Thinfinity® Remote Desktop Server address to the generated URL, following this format below:
http(s)://ThinfinityRDP: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. |
Read more: