One-time-URL

Top  Previous  Next

 

ThinRDP Workstation offers a mechanism to generate One-Time-URL's connections that expire after a given period of time.

 

note

 

The One-Time-URL feature was designed to work only with the NTLM Security Level.

note

 

You have to configure an apiKey on your ThinRDP Workstation 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 method to the ThinRDP 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 Workstation following this URL format:

 

http(s)://ThinRDPServer:Port/ws/oturl/get?<queryString>

 

 

2. The queryString should be build with all parameters listed below:

 

apikey= <apikey> &plen= <passlen> &expires= <expires> &username= <username> &password= <password>

 

 

Find on the table below a description for each required parameter.

 

Parameter

Description

apiKey

The ApiKey is a secret value, known only by ThinRDP Workstation and the corporate application. Find out more about it on the apiKey topic.

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 have passed from the URL generation.

 

On the next topics you can find out what other parameter you can use to Configure the connection and Enable features.

 

 

3. If ThinRDP gets to authenticate with the sent parameters, it will return a One-Time-URL that will allow you to establish a connection with the ThinRDP desktop.

 

/oturl.html?key=w7NJNschBdJD9e6G6luWhOCalM$oFW7guqC6jE1IQah3AJm3&pass=BOWZB8FG

 

Add up the generated URL to the ThinRDP address:

 

http(s)://ThinRDPServer:Port/oturl.html?key=w7NJNschBdJD9e6G6luWhOCalM$oFW7guqC6jE1IQah3AJm3&pass=BOWZB8FG

 

 

The URL is 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 folder webrdps. The file is named One-Time-Url-Test.html and implements the features covered on this topic.