Set up Remote Desktop Protocol for team agents
If you want to run unattended tests, set up Microsoft Autologon. If you're working in a highly restricted environment where Autologon isn't allowed, you can still run tests unattended by configuring your team agent with loopback Remote Desktop Protocol (RDP). This topic explains how to set it up.
Before you start
Verify that you have administrator rights for Tosca Cloud. Then, get your agent machine ready:
-
Check that your machine meets all system requirements.
-
Confirm that Launcher is installed.
-
Turn on Remote Desktop.
-
Verify that Network Level Authentication supports loopback connections.
-
Ensure your firewall allows RDP connections on the configured port. The default is 3389.
Configure your agent
To set up your agent for unattended test runs with Remote Desktop Protocol (RDP), follow these steps:
-
Go to
Run > Agents and select one of the following options: -
If this is your first agent, select Set up team agent.
-
If you already have agents, select Add new agent.
-
-
Go through the setup wizard:
-
Enter a name for your agent. If you skip this, the agent gets the default ID {MachineName}-{UserName}.
-
Set agent settings and characteristics as needed.
-
Copy the Command prompt and the Client secret.
-
-
Open Command Prompt, paste the command with the argument --useRdp, and run it.
-
In the pop-up, paste the Client secret and confirm.
-
Complete the Configure agent for unattended test runs dialog:
-
Enter the Username in domain/username format, for example computername/username, and provide the Password for the Windows account that will run the tests.
-
Optionally, configure Device display details and Advanced settings.
-
-
Close the setup wizard and the Command Prompt window.
You can now close the RDP window and continue working while the desktop stays active, and tests keep running.
RDP settings
During the setup, you can configure device display and advanced RDP settings.
Device display settings
You can configure the following Device display details for your team agent:
|
Settings |
Description |
Optional |
|---|---|---|
|
Username |
Windows user account for the RDP session. The account must have permission to sign in through Remote Desktop Protocol. |
|
|
Password |
Password for the Windows user account. Windows DPAPI encrypts the password locally. If the password changes, you need to Reconfigure RDP settings. |
|
|
Desktop width |
Remote desktop width in pixels. The default is 1920. |
X |
|
Desktop height |
Remote desktop height in pixels. The default is 1080. |
X |
|
Color depth |
Color depth for the remote session. The default is Highest quality (32-bit). |
X |
Advanced settings
You can configure the following Advanced settings for your team agent:
|
Settings |
Description |
Optional |
|---|---|---|
|
IP address for your RDP connection. You can use your local IP address. The default is 127.0.0.2. |
X |
|
|
RDP port |
RDP port. The default is 3389. |
X |
Reconfigure RDP settings
If you need to access the machine, shut down the agent first. If you reconnect to the same session while the agent is running, you'll interrupt the session, which will cause your tests to fail.
RDP connections are known to be unstable. If you experience frequent disconnects, switch to Microsoft Autologon for a more reliable setup.