QB Installation And Node Registration

QloudBridge is a desktop application by Qyrus designed for conducting desktop testing on standalone computers. It bridges the gap between the user's machine and the Qyrus domain by registering the machine as a node, provided there is a Qyrus connection in place.

Prerequisites

Before using the QloudBridge app, please ensure the following:

• You have admin access for performing activities in the QloudBridge app.

• Your machine meets the minimum requirement of at least 16GB of RAM.

• Make sure Netskope or any firewall agents do not block QYRUS connect [Reverse Proxy].

• Ensure that 'https://github.com/QQyrus/QloudBridge/' is whitelisted from your organization's network security perspective.

• OS should be Windows 10 and above, supporting 64-bit architecture.

Characteristics of Desktop Testing Service and QloudBridge Application

• Desktop Testing service allows users to perform testing operations on desktop applications installed on their machines.

• Users can create scripts within the Desktop Testing Service in Qyrus, register their machine with Qyrus, and execute the scripts.

• QloudBridge is developed for performing desktop testing on Windows operating systems.

• QloudBridge application should be installed by end-users, and updates will be delivered Over The Air (OTA).

Download and Install the QloudBridge App

1. Launch the Qyrus Application and log in with your admin profile.

   
2. Click on the Download icon from the Dashboard Page.

   
3. After clicking on the download icon, you will see a list of Desktop Applications, including QloudBridge for Windows and MacOS.

   
4. Click on the dropdown icon to select QloudBridge for your respective OS.

   
5. Click on "Windows" to download the .exe file for Windows machines.

   
6. Click on the "MacOS" button to download the .dmg file for MacOS machines.

   

Installation of the QloudBridge App for Windows Machines

1. Double-click on the downloaded file.

2. A popup will appear.

3. Click on "More Info."

   
4. Click on "Run anyway" button.

   
5. The QloudBridge application will be installed and open on your machine.

   

Installation of the QloudBridge App for MacOS Machines

1. Double-click on the downloaded file.

2. A popup will appear.

3. Drag and drop the QloudBridge into the Applications folder.

   
4. Go to the Applications folder and double-click on the QloudBridge app.

   
5. If it doesn't open, go to System Preferences >> Security & Privacy >> Click on "Open Anyway" >> Click on "Open."

   

Sign In to the QloudBridge App on MacOS

To sign in to the QloudBridge on MacOS, you need to enter the following information:

1. Email: Use the same email as your Qyrus login.

2. Password: Enter your Qyrus password.

3. URL: Enter the URL where your Qyrus account exists (e.g., If your accounts exist in the staging environment, use the staging URL).

4. Click on "Sign In" button.

   

Note: For MacOS, the Desktop Testing option is not available. After logging in to the QloudBridge on MacOS, you will only see the Qyrus Connect Option.

Sign In to the QloudBridge App on Windows

Desktop Testing Service is only available for Windows machines.

To sign in on Windows, you need to enter the following information:

1. Email: Use the same email as your Qyrus login.

2. Password: Enter your Qyrus password.

3. URL: Enter the URL where your Qyrus account exists (e.g., If your accounts exist in the staging environment, use the staging URL).

4. Click on "Sign In" button.

   

After clicking on "Sign In," you will be directed to the Qyrus Connect Page.

Qyrus Connect Page

After signing in, you will be redirected to the Qyrus Connect Page. Here, you need to provide the Private IP address with a suffix /32 to establish a Reverse Proxy Connection (VPN Connection).

Note: The Private IP details will be added by default as soon as you log in to the QloudBridge app.

Process to Get Private IP Address on Windows

1. Open the command prompt.

2. Enter "ipconfig."

3. Copy the IPv4 Address (e.g., 192.168.1.0).

4. Enter that IP address in the Reverse Proxy Connection Page.

   

Process to Get Private IP Address on MacOS

• Go to System Preferences.

• Go to Network.

• Click on "Advanced."

• Click on "TCP/IP."

• Copy the IPv4 address.

  

Process to Enter Private IP at Qyrus Connect Page

Enter the Private IP address and click on "Connect" button. It will establish the connection and show a message like "Connection with Qyrus Cloud was Successful."

Process to Disconnect the QloudBridge Application

To disconnect from the QloudBridge, click on the "Disconnect" button.

If you enter the wrong IP address, it will show an error message.

What is a Node? Why Do We Need to Register Them?

Node registration is the process of allowing a client's machine to be visible and accessible from the Qyrus Domain. Once registered, it permits the execution of test payloads on the client's machine.

Register the Node

To register a node:

• Click on "Register Client" from Desktop Testing and provide the Connection Name, Team, and the status of the Node.

• Click on the "Register" button, and the Node will be registered successfully.

• A user can register up to 5 Nodes from 5 different machines with their own credentials.

• If a user tries to create a 6th Node with the same credentials, an error message will be displayed.

  
• To change the status of a Node, use the "Set Status" option and click "Update" to save the changes.

  

Note: Keep the QloudBridge app connected and navigate to the Qyrus Application, where you can see all the node’s statuses.