One-time-URL

Top  Previous  Next

 

ThinRDP 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 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.

 

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.