LogoLogo
HomeContact UsRegister for a live demo!Get a Quote
  • Thinfinity Remote Desktop 5
  • About This Document
  • Introduction
  • What's new in 5.0
  • Architecture
  • Security
  • Upgrade from 4.0
  • Getting Started Section
    • Getting Started
    • Installing Thinfinity® Remote Desktop
    • Using Thinfinity® Remote Desktop for the First Time
      • Verifying the Communication Settings
      • Connecting to a desktop
    • Customizing Thinfinity® Remote Desktop
      • Setting the Access Security Level
        • Access Profiles
          • RDP Profiles
            • Creating an RDP Profile
            • Editing an RDP Profile
            • Disabling an RDP Profile
            • Removing an RDP Profile
            • The "[+]" Profile
          • Weblink Profiles
            • Creating a Weblink Profile
            • Editing a Weblink Profile
            • Disabling a Weblink Profile
            • Removing a Weblink Profile
          • RD Web Access Profiles
            • Creating a RD Web Access Profile
            • Editing a RD Web Access Profile
            • Disabling a RD Web Access Profile
            • Removing a RD Web Access Profile
          • VNC / RFB Profile
            • Creating a VNC Profile
            • Editing a VNC Profile
            • Disabling a VNC Profile
            • Removing a VNC Profile
          • Telnet/SSH profile
            • Creating a Telnet Profile
            • Editing a Telnet Profile
            • Disabling a Telnet Profile
            • Removing a Telnet Profile
      • Testing Internal Access
      • Configuring Internet Access
      • Enabling Remote Sound
      • Mapping Remote Drives
        • Intermediate Disks
        • Shared Folders
    • After Customization
      • Connecting to a Desktop
      • Connecting to an Application
      • Performing a File Transfer
        • Navigating
        • File Options
        • Remote Folder Area Options
        • Downloading and Uploading files
    • Supported RDP Shortcut Keys
  • Advanced Settings Section
    • Advanced Settings
    • Thinfinity® Remote Desktop Manager
      • General
      • Broker
      • Authentication
        • OAuth/2
          • Methods
          • Settings
          • Mappings
          • Configure OAuth with Okta
          • Configure OAuth with Auth0
        • RADIUS
          • Settings
          • Mappings for SSO
        • TOTP (Time-based One-time Password)
          • TOTP Settings
      • Access Profiles
        • RDP Profile Editor
          • General
            • Setting up a Hyper-V Profile
            • Setting up an RDS Collection Profile
          • Display
          • Resources
          • Program
          • Experience
          • Advanced
          • Printer
          • Permissions
          • Restrictions
          • Access Hours
          • Authentication methods
        • Web Link Profile Editor
          • Web Link
          • Permissions
        • RD Web Access Editor
          • General
          • Permissions
        • VNC / RFB Profile Editor
          • Display
          • Permissions
          • Restrictions
          • Access Hours
          • Authentication methods
        • Telnet / SSH Profile Editor
          • Display
          • SSL
          • SSH
          • Options
          • Permissions
          • Authentication methods
          • Access Hours
          • Restrictions
      • Folders
      • Permissions
      • External DLL Authentication Method Settings
      • Duo Authentication Method Settings
        • How to configure DUO
      • SAML Authentication Method Settings
        • Configure SAML with Okta
        • Configure SAML with Centrify
  • Gateway Manager
    • Managing the SSL Certificate
      • The Default Embedded Certificate
      • A Self-Signed Certificate
      • A CA Certificate
  • License Manager
    • License Activation
    • Proxy Activation
    • Get a new Trial Serial Number
    • Activate a Serial Number Online
    • Activate a Serial Number Offline
    • Registering Your License With The License Server Manager
  • Custom Settings
    • Extend the Remote Desktop’s Toolbar
  • Customizing the Toolbar
    • Using customsettings.js
    • Using the 'connect' Method
  • Remote FX
  • Save Session
    • Record a Session
    • Play Recorded Sessions
  • Multi-touch Redirection
  • Enhanced Browser and DPI Support
    • Model Inheritance
    • Property Reference
    • The Calculation Process
    • Examples
  • Silent Install Options
  • Credentials Management
    • User-based Access Profiles
    • Credentials Management
  • Customize Translation
  • Mobile Devices Section
    • Mobile Devices
    • Getting into Thinfinity® Remote Desktop
    • Mouse Control
    • Keyboards and Toolbars
    • Gestures
    • Disconnecting from Thinfinity® Remote Desktop
    • iPad Application
      • Configuration
      • Side Bar
  • Scaling and Load Balancing Section
    • Scaling & Load Balancing
    • Scaling and Load Balancing Configurations
    • Installing Components
    • Configuring a Load Balancing Scenario
    • How to configure your license
  • Integrating Thinfinity® Remote Desktop Section
    • Integrating Thinfinity® Remote Desktop
    • SDK
      • Deploying
      • Using the SDK
      • SDK Login
      • Connect method
        • Placement
        • Destination and Authentication
        • Settings
          • kbdLayout Values
        • Features
        • Events
        • Toolbar Customization
      • Browser Resizing
      • Keystroke Methods
      • SSL Certificate
      • Demo
    • External Authentication
      • Apikey
    • Single Sign On
      • Facebook OAuth Authentication Example
      • Google OAuth/2
        • Google Client ID for Web Applications
      • RADIUS
    • Customizing the Web Interface
      • Changing the Logo
      • Customizing the Web Files
      • Files Location
    • Web Services API
      • Architecture
      • Installing the Web Service
      • Setting up the Communication Settings
      • Profiles Web Service
        • Methods
        • Types
          • The WS Profile type
        • The Demo Applications
      • Analytics Web Service
        • Methods
        • Types
          • WSQueryInfo
          • WSQueryRange
          • WSDBLoginRecord
          • WSSessionRecord
          • WSDBConnectionRecord
          • WSDBBrowserRecord
        • The Demo Application
    • One-Time-URL
      • Configuring the Connection
      • Enabling Features
  • User guide Section
    • User Guide
    • Logging In
    • Advanced Web Features
      • Tree View
      • Listing Options
      • Search bar
    • Accessing from Mobile Devices
      • Connecting with Open Parameters
        • General
        • Display
        • Resources
        • Program
        • Experience
        • Advanced
      • Connecting with Profiles
    • Toolbar
      • Actions
      • File Transfer
      • Options
      • Disconnect
    • Features
      • File Transfer
        • Navigating
        • File Options
        • Remote Folder Area Options
        • Downloading and Uploading files
      • Remote Printer
      • Remote Sound
      • Share Session
      • Mapped Drives
      • Analytics
        • Sessions
        • Connections
        • Logins
        • Browsers
        • Filter
        • Configuring MS SQL Server
          • Analytics Tables Reference
    • Disconnecting
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Integrating Thinfinity® Remote Desktop Section
  2. One-Time-URL

Configuring the Connection

Besides the basic parameters required to establish a connection, you can send additional settings parameters to customize the connection the way you want.

There are three ways to customize the one-time-url connection:

1. Using an Access Profile that will act as a template to the connection.

2. Using an Access Profile and overriding some parameters by sending them on the queryString.

3. Configuring each setting parameter on the queryString manually.

Find below what parameters you should send in order to configure the connection with each one of these modes:

Mode 1. Using Access Profiles as template for the Connection:

Parameter

What it means

Type/format

Default

model

On this parameter you should send the Profile Key, to have this profile taken as the Connection template.

string

Profile Key

Mode 2. Overriding the profile settings:

Parameter

What it means

Type/format

Default

overrideDefaults

Set this property to true, to have the Profile settings overridden by the parameters sent on the queryString. Then configure the individual settings you want to add to the Profile connection template

If you send this parameter as false, only the profile configuration will be taken.

boolean

true,false

false

Mode 3. Configuring each setting individually:

If you do not send the model parameter or even override its settings (mode 2), you will be able to configure each Thinfinity® Remote Desktop Server setting individually.

Find below the list of the parameters you can configure manually:

Parameter

What it means

Type/format

Default

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

The username to authenticate against the remote machine. If this parameter is not sent, Thinfinity® Remote Desktop Server will prompt the user for this information.

string

username

The password to authenticate against the remote machine. If this parameter is not sent, Thinfinity® Remote Desktop Server will prompt the user for this information.

string

password

startprg

If you will use the OneTimeURL 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 remote application path 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

"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 redirected 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 have the application performance improved.

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 in case you don't inform this property of inform any value different from "VMID" and "RDS".

string

VMID or RDS

destinfo

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

1 . By informing the username and password on the URL you will be setting the "Use these credentials" option. If you don't inform username or password, the behavior will follow the "Ask for new credentials" options'.

The "Use the authenticated credentials" option is not suppose to work with the One Time URL, because in this case there is no prior authentication with a valid user for the remote machine.

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 on the example below :

...&password=myPassword&model=0mwZVL@aTkRMwc$mj3kUCrzM6@08yse0C7MED3it...

PreviousOne-Time-URLNextEnabling Features

Last updated 3 years ago

Was this helpful?

username

password

Inform the Virtual Machine ID, for Virtual Machine connections or inform the TSV URL for Virtual Machines.

11 1
11 1
Hyper-V
RDS Collection