One-Time-URL

Top  Previous  Next

 

Thinfinity® Remote Desktop Server offers a mechanism to generate One-Time-URL connections that expire after a given period of time.

 

note

 

The One-Time-URL feature is designed to work with the Access Profiles and User/Password  Security Levels.

note

 

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.

 

note

 

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