Comment on page

One-Time-URL

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 'Allow Anonymous Access'.
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:
· Configuring the Connection​
· Enabling Features​
​

The Demo Application

Configuring the Connection

Last modified 2yr ago

	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.

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.