Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Table of Contents

Overview

If our customer is accessing oneDesktop through a RDP connection, this guide will cover creating the connection file. 

Scope of This How To Article

This guide will follow the basic settings for the .RDP file for RDSH sessions. Customers may have different settings, but those will not be reviewed in this guide. This will only cover users using Windows 10.

Prerequisite and Requirements

...

Overview

This guide covers connecting to our oneDesktop services through RDP. 

Table of Contents

Accessing RDP oneDesktop in Windows

Users will need to have the services provisioned through oCCP, as well as their credentials to access oneDesktop.

Accessing RDP oneDesktop in Windows

Sub-Step #

Instruction

Screenshot

1.1

In the search bar, type in RDP.

Image Removed
Image Added

1.2

This should bring up Remote Desktop Connection.

Click on Remote Desktop Connection to open it.

Image Removed
Image Added

1.3

Click Show Options so we can make the necessary setting changes. 

Image Removed
Image Added

1.4

In the Computer field, enter your server name. If you do not know your server name, reach out to your admin if they know it, or contact us to confirm it.

In the User Name field, enter your UPN (usually matches your email address). 

Image Modified
Image Removed
Image Added

1.5

Next, click the Display tab. If you have multiple monitors, and want to use them all, select Use all my monitors for the remote session.

Image Removed


Image Added

1.6

Next, click to Local Resources tab. This is where options for sound or connected devices are found. 

Printers and Clipboard are selected by default, but make sure they are selected.  You can click the More button to see other options. 

From in the More menu, you can select local drives, connected devices, etcetera, to pass through RDP. We will not be covering this in the guide, as it will be user specific.

Image Removed
Image Added
Image Removed
Image Added

1.7

Next, click on the Advanced tab. 

From the Advanced tab, click Settings.

Image Removed
Image Added

1.8

Select Use these RD Gateway server settings: and

then enter rdsh.nirix.com as the server name.

please contact CustomerCare for the Server name

Deselect Bypass RD Gateway server for local addresses

Select Use my RD Gateway credentials for the remote computer

Image Removed


Image Added

1.9

Click back to the General tab. 

Click Save As...

Image Removed


Image Added

1.10

Name the RDP shortcut as required. I have named it NIRIX Desktop in this guide. I have also placed it on the Desktop for convenient access.

Once you are done, click Save.

Image Removed
Image Added

1.11

You can now close Remote Desktop Connection.

Image Removed
Image Added

1.12

The shortcut that was created can now be double clicked. All the settings should be saved in it.

Image Removed
Image Added

1.13

The first time the connection is opened, there will be a notification as shown here. Click Don't ask me again for connections to this computer.

Then click Connect.

Image Removed
Image Added

1.14

Your password will then be requested. I would suggest NOT clicking the Remember me button.

Enter their password and then click OK.

Image Removed
Image Added

1.15

The first time the connection is made, the following will also be displayed. Click the Don't ask me again for connections to this computer and then click Yes.

Image Removed
Image Added

1.16

The connection will then start!

Image Modified


Accessing RDP oneDesktop in iPadOS

...

Prerequisites and Requirements

  • iPad running at least iPadOS version 13.0 or later

  • An Apple ID, to access the App Store to download the Remote Desktop Application from Microsoft

  • A oneDesktop account provisioned with RDSH access

  • An internet connection to download the Remote Desktop Application by Microsoft, from the App Store

  • (Optional) - A mouse and/or keyboard - without these, oneDesktop on iPad would be interfaced solely through the iPad's touchscreen

Additional Information

  • An iPad connected to oneDesktop cannot pass through a Mic or the Camera while in oneDesktop

Sub-Step #

Instruction

Screenshot

1.1

Open the App Store

...

Image Added

1.2

Tap the Search button, and search for “Microsoft Remote Desktop”, and install the app shown.

...

Image Added

1.3

Once the app has been downloaded, open up ‘RD Client’ (the app we just installed).

...

Image Added

1.4

Tap Ok for the prompts that appear (for local network devices, Bluetooth, Camera, & Mic).

...

Image Added

1.5

Tap on the Plus (+) icon in the top-left corner, and then tap, ‘Add PC’.


A new screen will then appear.

...

Image AddedImage Added

1.6

Under PC Name, enter the Server name the user connects to...


For example,

XX1001-TS-01

XX1000-WKS-01

...

Image Added

1.7

Under Gateway…


Tap on Gateway, then Add Gateway, then enter ‘rdsh.nirix.com’ under Gateway Name, then tap Save.

...

Image Added

1.8

[OPTIONAL]

If you wish to save the username for next login…


Tap on User Account, then Add User Account, and enter your email address under ‘User@domain’, then tap Save.


(Entering/saving your password is ill-advised, as another user could then login to your account).

...

Image Added

1.9

When finished entering the settings as per steps 1.6 through 1.9, tap Save.

...

Image Added

1.10

Then, to Login, tap on the icon for

...

XXXXX-TS-

...

01, entering your username/password if/when prompted.

...

Image Added

Accessing RDP oneDesktop in MacOS or ChromeOS

Pre-Requisite and Requirements

  • A MacOS device, such as an iMac or MacBook, or a ChromeBook

  • An
    • For installation on MacOS, an Apple ID, and access

  • the 
    • the Mac App Store, are required to download

  • and install
    • the Remote Desktop Application from Microsoft

  • , if using a MacOS device
    • For installation on a ChromeBook, a Google Play Store Account and it’s password are required to download the Remote Desktop Application from Microsoft

Additional Information

...

  • A Mac or Chromebook connected to oneDesktop cannot pass through a Mic or the Camera while in oneDesktop; it looks like it’s due to how MacOS and ChromeOS pass those through

Sub-Step #

Instruction

Screenshot

1.1

Open the MacOS App Store (or Google Play Store), and search for "Microsoft Remote Desktop" or “Windows App” and install it

as pictured

.

Installing it might prompt for the Apple ID password of the Mac device; enter it as necessary.


If installing it on a Chromebook, open the Google Play Store instead.

Image Removed

image-20240925-164903.pngImage Added

1.2

After installing it, open the application, and click "Add PC".

Image Removed

1.3

From here, enter settings as you would when setting up an .RDP file on Windows:

  • Enter the workstation name for the customer/user under "PC name",
  • Enter the username under "User account"
  • Enter rdsh.nirix.com under the Gateway name, and then specifying the "User Account" as their username once again

Once entered click on "Add".

Image Removed

Once the download has finished, click on Open.

image-20240925-165024.pngImage Added

1.3

If prompted with a “Help us make your experience better?” screen, you can click on Now now, to not send anonymized app data to Microsoft.

Image Added

1.4

With the Microsoft Remote Desktop window open, click on Add PC.

image-20240925-165426.pngImage Added

1.5

Under PC Name, enter the Server Name, such as ‘XX1000-TS-01’ or ‘XX1000-WKS-01’. If you are unsure of your Server Name, feel free to reach out to the Support Team to verify this.

Image Added

1.6

Under User Account, click on the drop down arrows, and then click Add User Account…
At the following screen, enter your email address and password, ensuring the password is correct, and then click Add

Image Added

1.7

Under the General tab, click on the drop down arrows next to Gateway, and then click on Add Gateway…

At the following screen, enter rdsh.nirix.cominto the Gateway Name. Under the User Account drop down menu, click on your email address that you previously added in the last step, and then click Add.

Image AddedImage Added

1.8

Under the Display tab, enable Use all monitors if you have any additional monitors hooked up, or plan to do so.

For MacOS devices, enable Optimize for Retina displays, especially if you find the sizing of certain windows looks off after logging into oneDesktop for the first time.

Image Added

1.9

You can leave the Devices & Audio and Folders tabs alone for default use cases.

Finally, click on Add in the bottom right corner of the Add PC window.

Image Added


1.10

Double click on the newly added option in Microsoft Remote Desktop to launch into oneDesktop!

image-20240925-165518.pngImage Added

1.11

Optional: To stop the certificate warning that appears each time you try logging in from a Mac, do the following.

  1. Click on Show Certificate

  2. Click on/enable the box for Always trust…

  3. Click on Continue

  4. Enter the password for your MacBook when prompted, and then click Update Settings.

image-20240925-165628.pngImage Added

image-20240925-165849.pngImage Added

image-20240925-165915.pngImage Added



Info

The changes documented above are specific to the NIRIX Shared Hosting Environment only.

...

Page Properties
hiddentrue


Related issues