Skip to main content

Access via Remote Desktop Connection on Windows

To access your remote system using the “Remote Desktop Connection” app, you may need to complete a one-time setup, depending on how your Windows device has been prepared.

The exact procedure depends on whether your device has already been prepared by your administrator or whether you can perform the required installation yourself.
As an administrator, you can perform the initial setup centrally for all users using the provided PowerShell script. This script is not intended to be run by end users.

  • Has your administrator already set up your device? In this case, start directly at step 2: Connect using RDP file.
  • Are you configuring the settings on your system yourself? Start here at step 1:

1. Download and run setup file (optional)​

  1. Click Download setup file. oneclick™ access window with Initial setup, Quick access, and the Download setup file button
  2. Open the “Downloads” folder and double-click the file “oneclickGateway.exe” to start the installation.
    Windows File Explorer showing the Downloads folder with the oneclickGateway.exe file
  3. Confirm the execution policy prompt with Yes and all further prompts with OK.
    This configures the system to allow NTLM connections.

Your device is now prepared for access.

2. Connect using RDP file​

  1. In the access window, click Download RDP File.
    oneclick™ access window with the Download RDP File button highlighted
  2. Open the downloaded RDP file by double-clicking it.
    Windows File Explorer showing the downloaded Windows Desktop.rdp file in the Downloads folder
  3. If Windows displays the Remote Desktop Connection security warning, check that Publisher shows "oneclick AG".
  4. If needed, select the local resources you want to make available for this connection, such as Clipboard, Drives, Cameras, or Microphones. The selection applies only to this connection launch and does not change the saved RDP file.
  5. Click Connect.

3. Enter login credentials​

  1. When the first Windows security prompt asks for credentials, click More choices, and then click Use a different account.
    Windows Security dialog for RD Gateway Server Credentials with Use a different account highlighted
  2. Copy Username and Password from the access window and paste them into the corresponding fields.
  3. Click OK.
    Access window with credentials displayed next to the Windows Security dialog with entered login credentials
  4. Enter your credentials for the remote system in the second Windows security prompt. You can optionally save them.
    Windows Security dialog with fields for the remote system username and password

Note for domain environments: If the remote system is part of a domain, enter the username in the format DOMAIN\username (e.g. company\john.doe).

Saved credentials and RDP file

You can save the credentials for the gateway and remote system. Windows stores them in Credential Manager. Saving these credentials does not change the RDP file or its digital signature.

4. Were you successfully connected?​

After a successful connection, select Yes, I was connected. The next time you start the app, oneclick™ automatically opens Quick access instead of Initial setup.
oneclick™ access window with the option “Yes, I was connected.” and the CLOSE THE WINDOW button
Then click Close the windows.

Connection fails?​

If the RDP file opens normally but the connection cannot be established, start the app again in oneclick™.

  1. If the access window indicates that the connection time has expired, click Renew connection time. oneclick™ renews the connection time. The credentials are valid again.
    oneclick™ access window showing that the connection time has expired and the Renew connection time button
  2. Open the existing RDP file again.

You do not need to download the RDP file again.

For additional error patterns and solutions, see RDP access error.

5. Reuse the RDP file​

You can reuse the downloaded RDP file for later connections.

  1. Start the app in oneclick™. This renews the connection time and makes the credentials valid again.
  2. Open the existing RDP file by double-clicking it within the connection time shown.

If you want to access the RDP file more easily, create a shortcut on your desktop.

Do not edit the RDP file

Do not edit the RDP file manually. If you change signed settings and save the modified file, the digital signature becomes invalid. If Windows reports that the RDP file is corrupted, or if Connect is grayed out and cannot be clicked, download the RDP file again via oneclick™.