The remote desktop application is a powerful tool allowing the Luminate Secure Portal users to seamlessly connect to targets running windows OS.  The connection is divided into two parts. 

Initially, the user will authenticate with the Luminate RDP Gateway. Once this connection is verified the user will be forwarded to the target machine for an additional, local, authentication.

Launching the application is done in the same way for Mac and Windows users:

(The additional steps needed for client configuration are divided per OS type) 

1) Launch the application by clicking it. This should trigger the appearance of the side ribbon:

2) Download the RDP file. Keep this window open in the background as we will require the information from it when configuring the client. 

For Mac Users:

We recommend using the Microsoft Remote Desktop client. I will be using it in the following procedure. The steps can be performed on any client. 

As explained above, the authentication is divided into two sections. The Microsoft Remote Desktop Client is infamous for creating a user account for the GW session and trying to authenticate with it to the target machine. 

*** Do not import the file into your Desktop Manager ***

The correct way to launch is to "option" click the RDP file and select the appropriate application. 

 

An authentication window pops up.

Copy and paste the username and password from the side ribbon.

Please note you are authenticating to with Luminate RDP GW and not the target machine. 

Click Done and an additional authentication request is presented. 

Now you are authenticating with the target machine and should use your domain credentials. 

Click Done.

IT WORKS!

 

Troubleshooting:

In case you have imported the RDP file to the Desktop manager, the first step should be to delete it.

Then, click on the preferences and delete the entries (Relevant to Luminate) in the User Accounts tab and Gateways. 

 

 

Now that both tabs are empty, repeat the above scenario and launch the RDP file (without importing it)

IT WORKS!

 

For Windows Users:

Download the RDP file and launch.

Click Connect. 

You are now authenticating to the RDP GW. Copy the username and password from the Portal's side ribbon and paste them in the MSTSC window.

Do not save the password! This is a short-term password that will expire following the session timeout. 

Once you pasted the information click OK.

You are now trying to authenticate to the target machine. (Notice the change in the destination name) 

Input your local username and password and click ok

 

IT WORKS!

 

Troubleshooting:

If you saved the credentials for the GW and the password expired you will need to manually remove the entry from the OS. The password is stored in the OS regardless of the existence of an RDP file. 

This is done by:

Edit an RDP file for the target you are trying to connect to by right clicking it and selecting edit.

Select the Advanced Tab

Click Settings. 

The screenshot above depicts a stored password  ( Note the bottom part of the window mentioning stored credentials) 

Click Delete, and Yes.

Click Yes and save by clicking OK.

Launch the RDP file ( and make sure not to save the password again)

IT WORKS!