13.1.1 Use and Discard Connections: OTURL

Thinfinity® Workspace provides a secure mechanism for generating One-Time URLs (OTURLs) that expire after a specified period. This feature is ideal for scenarios where temporary or limited access to remote desktops is required.

When to Use OTURL

The One-Time URL feature is useful in scenarios such as:

• Granting external users access to a remote desktop without exposing internal authentication methods.

• Creating temporary RDP connections with a defined expiration time.

• Integrating Thinfinity Workspace with external applications in Single Sign-On (SSO) workflows via the Configuration Manager.

Configuring One-Time URLs

To enable OTURL functionality, you must configure an API key on the Primary Broker Server.

How it works:

1

To request a One-Time URL, send a request to the Thinfinity Workspace server using the following format:

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

2

The queryString should include the following required parameters:

apikey=<yourApiKey>&apiuser=<apiUser>&model=<model>&plen=<passwordLength>&expires=<expirationTime>

Parameter	Description
apikey	The API key configured on the Primary Broker.
apiuser	The user initiating the request.
model	Specifies the Access Profile model to use.
plen	Length of the password to be generated.
expires	Time (in minutes) before the OTURL expires.

3

If the request is valid, Thinfinity Workspace returns a One-Time URL with the following format:

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

To construct the complete URL, concatenate it with your Thinfinity Workspace address:

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

This URL can be used by an application to redirect the user to the remote desktop, or it can be sent via email to an external user for temporary access.

Testing OTURL

A sample HTML/AJAX page named oturltest.html is included with the Thinfinity Workspace installation. It demonstrates how to generate and consume One-Time URLs using the parameters discussed above.

For detailed guidance on customizing and deploying OTURL functionality in your environment, see How to use Thinfinity Remote Workspace One-Time URL Test application.