Customize an OTURL Connection
Besides the basic parameters required to establish a connection, you can send additional parameters to customize the connection the way you want.
There are three ways to customize the OTURL connection:
1. Using an Access Profile that will act as a template to the connection
model
On this parameter you should send the Profile Key, to have this profile taken as the Connection template.
string
Profile Key
2. Using an Access Profile and override some parameters by sending them on the queryString
overrideDefaults
true: Overrides the Access Profile settings with the parameters sent in the query string. Then configure the individual settings you want to add to the Access Profile template.
false: Only the profile configuration will be applied.
boolean
true, false
false
3. Configuring each parameter on the queryString manually
If you do not send the model parameter (mode 1) or override its settings (mode 2), you will be able to configure each Thinfinity Workspace setting individually.
Here are the parameters that can be configured:
computer
The remote desktop IP and port to connect to.
If you are using "None" or "Username/Password" as authentication mode or the [any computer] as profile you will have to specify the computer parameter.
string
IP:Port
username (¹)
The username to authenticate against the remote machine. If this parameter is not sent, Thinfinity® Workspace will prompt the user for this information. See the Note below for details.
string
username
password (¹)
The password to authenticate against the remote machine. If this parameter is not sent, Thinfinity Workspace will prompt the user for this information. See the Note below for details.
string
password
startprg
If you intend to use OTURL to start a specific application, you should change this and the following three fields. Set it to 0 for the "Do nothing" option; 1 for the "Start a program" option; 2 for the "Launch RemoteApp" option.
integer
0,1 or 2
0
command
Full path to the remote application that should start upon connection establishment.
string
app path
directory
Initial context directory to be used by the application set on command parameter described above.
string
dir path
cmdargs
Arguments to start the application specified on the command property.
string
app args
bpp
Color Depth: sets the number of bits per pixel. Set 8 for 256 colors; 15 for True Color (15 bit); 16 for True Color (16 bit) ; 24 for True Color (24 bit)
integer
8,15,16 or 24
16
resolution
Available options: "fittobrowser", "fittoscreen", "fixed". When "fixed", the width and height parameters will be considered.
string
toolbar size
"fittobrowser"
width
Remote desktop screen width.
It will only be considered when the resolution parameter is set to "fixed".
integer
pixels
Desktop width
height
Remote desktop screen height.
It will only be considered when the resolution parameter is set to "fixed".
integer
pixels
Desktop height
imagequality
Specifies the image quality/compression. Set 0 for "Highest"; 1 for "Optimal"; 2 for "Good"; 3 for "Faster".
integer
0,1,2 or 3
1
desktopbackground
Set to true to show the original remote desktop background.
boolean
true,false
false
visualstyles
Set to true to change the Start menu and other windows features style.
boolean
true,false
false
menuwindowanimation
Set to true to show an animation on the Start menu.
boolean
true,false
false
fontsmoothing
Set to true to make text easier to read, especially magnified text.
boolean
true,false
false
showwindowcontent
Set to true to show windows contents while dragging them.
boolean
true,false
false
desktopcomposition
Set to true to configure the DWM to redirect the desktop drawing to off-screen surfaces in video memory. The desktop will also present many visual effects.
boolean
true,false
false
unicodekeyboard
Allows for using full Unicode keyboard charsets. Set to false to connect to xRDP servers.
boolean
true,false
true
keyboardlayout
Allows to specify the keyboard layout when Unicode keyboard is disabled.
string
Keyboard identifier (hexadecimal)
"00000409 (US)
console
Forces the connection to connect to the remote console session.
boolean
true,false
false
wscompression
Set to true to enable the compression for the exchanged WebSocket data and improve the application performance.
boolean
true,false
true
disablenla
Set the option disableNLA if you use a CredSSP other than Microsoft.
boolean
true,false
false
desttype
Set the desttype to "VMID" in case you want to establish a connection to a Hyper-V Virtual Machine or set "RDS" if you want to create a connection to an RDS Collection VM.
The connection will act as a regular connection if you don't inform this property or inform any other value different from "VMID" and "RDS".
string
VMID or RDS
destinfo
Inform the Virtual Machine ID, for Hyper-V Virtual Machine connections or inform the TSV URL for RDS Collection Virtual Machines.
string
Virtual Machine ID
or
TSV URL
diskenabled
Set to true to have an intermediate disk available on the connection.
boolean
true,false
true
diskname
Identify the intermediate disk among the other remote desktop disks.
string
name
"ThinDisk"
diskautodownload
Set to true to automatically download any file saved/copied in the Intermediate disk.
boolean
true,false
true
(¹) Note
By specifying the username and password in the URL, you enable the "Use these credentials" option. If the username or password is not provided, the behavior will follow the "Ask for new credentials" option.
The "Use the authenticated credentials" option does not work with the One-Time URL, since there is no prior authentication with a valid user on the remote machine in this case.
Important
To add each of the parameters to the queryString, you have to concatenate an "&" symbol, the name of the parameter, the "=" symbol, and the value assigned to the parameter, as shown in the example below:
...&password=myPassword&model=0mwZVL@aTkRMwc$mj3kUCrzM6@08yse0C7MED3it...
Last updated
Was this helpful?