Installation of the cyberelements.io / cyberelements Cleanroom client

The cyberelements.io / cyberelements Cleanroom client is installed on the user's workstation and is required for the following actions:

• Compliance checks requiring access to the OS:
  • Anti-spyware
  • Anti-virus
  • MD5
  • Browser
  • OS
  • Firewall
  • System
• Launching applications that cannot be accessed directly from the browser (SSH, RDP, VNC, VPN, or generic tunnel, among others)

Where can I download the client?

The client is available for download either in the administrator console or on the user portal.

Administrator console

cyberelements.iocyberelements Cleanroom

1. Access the “Configurations” workspace using the button located at the top left:
2. Open the “Toolbox” tile
3. Retrieve the appropriate setup for the desired OS in the first tab “Integration tools”

1. Access the “Configurations” workspace using the button located at the top left:
2. Open the “Toolbox” tile
3. Retrieve the appropriate setup for the desired OS in the first tab, “Integration Tools”

User portal

cyberelements.iocyberelements Cleanroom

1. Log into the user portal
2. Click on the downloads icon located at the top right:
3. Download the cyberelements.io client appropriate for your OS:

1. Log into the user portal
2. Click on the downloads icon located at the top right:
3. Download the cyberelements Cleanroom client appropriate for your OS:

Installation of the Microsoft Windows client

Administrator rights required

Administrator rights are required to install the client.

Client compatibility

To find out whether the client is compatible with different versions of Microsoft Windows, refer to the compatibility matrix.

Graphical installation

cyberelements.iocyberelements Cleanroom

1. Run the setup_cyberelements_Client.exe setup as an administrator (a request to run as an administrator will appear if necessary).
2. Click Next on the first window:
3. Accept the terms of use:
4. On the third screen, specify the installation directory and install the OpenVPN components if standard VPN applications are available to the user:
5. Finally, start the client installation:

1. Run the setup_Cleanroom_Client.exe setup as an administrator (a request to run as an administrator will appear if necessary).
2. Click Next on the first window:
3. Accept the terms of use:
4. On the third screen, specify the installation directory, install Cleanroom Desktop if you want the applications to be displayed on the desktop, and install the OpenVPN components if standard VPN applications are available to the user:
5. (If Cleanroom Desktop must be installed) The next window will ask you to complete various settings:
   • Server Name: IP address or DNS name of the Mediation server
   • Organization: name of the organization to which the client will connect
   • Domain: name of the cyberelements Cleanroom connection domain
   • Domain choice: definition of the control that the user has over the choice of domain; there are three levels:
     1. force: the domain selection is forced on the user
     2. serial: the client will use cascading authentication for domain selection, so cascading authentication must be configured on the organization
     3. user: the user is free to select the connection domain of their choice
6. (If Cleanroom Desktop must be installed) Select whether Cleanroom Desktop should launch automatically when the session opens and whether it should run after installation:
7. Finally, start the client installation:

Silent command line installation

cyberelements.iocyberelements Cleanroom

To install the client silently via the command line, there are two options available:

1. Installation of the client only:

   setup_cyberelements_Client.exe /S /v/qn
   

2. Installation of the client + OpenVPN drivers:

   setup_cyberelements_Client.exe /S /v/qn"/L ADDLOCAL=OpenVPN"
   

To install the client silently via the command line, four options are available:

1. Installation of the client only:

   setup_Cleanroom_Client.exe /S /v/qn
   

2. Installation of the client + OpenVPN drivers:

   setup_Cleanroom_Client.exe /S /v/qn"/L ADDLOCAL=OpenVPN"
   

3. Installation of the client + Cleanroom Desktop components:

   setup_Cleanroom_Client.exe /S /v/qn"/L ADDLOCAL=Cleanroom_Desktop CL_DOMAIN=mydomain.com CL_ORGA=org_cleanroom CL_SRV_NAME=myserver CL_DOM_CHOICE=user"
   

4. Installation of the client + OpenVPN drivers + Cleanroom Desktop components:

   setup_Cleanroom_Client.exe /S /v/qn"/L ADDLOCAL=ALL CL_DOMAIN=mydomain.com CL_ORGA=org_cleanroom CL_SRV_NAME=myserver CL_DOM_CHOICE=user"
   

When Cleanroom Desktop components are installed, various variables need to be defined:

• CL_DOMAIN: name of the cyberelements Cleanroom connection domain
• CL_ORGA: name of the organization to which the client will connect
• CL_SRV_NAME: IP address or DNS name of the Mediation server
• CL_DOM_CHOICE: definition of the control that the user has over the choice of domain; there are three levels:
  1. force: the domain selection is forced on the user
  2. serial: the client will use cascading authentication for domain selection, so cascading authentication must be configured on the organization
  3. user: the user is free to select the connection domain of their choice

Extracting the MSI

cyberelements.iocyberelements Cleanroom

1. Open a command prompt or PowerShell console
2. Navigate to the folder where the cyberelements.io Windows client is located
3. Run a command similar to the following, customizing the C:\temp destination directory if necessary:

   .\setup_cyberelements_Client.exe /s /x /b"C:\temp" /v"/qn"
   

4. The cyberelements Client.msi client will be available in the directory defined in the previous step

1. Open a command prompt or PowerShell console
2. Navigate to the folder where the cyberelements Cleanroom Windows client is located.
3. Run a command similar to the following, customizing the C:\temp destination directory if necessary:

   .\setup_Cleanroom_Client.exe /s /x /b"C:\temp" /v"/qn"
   

4. The Cleanroom Client.msi client will be available in the directory defined in the previous step

Installation of the macOS client

Administrator rights required

Administrator rights are required to install the client.

Client compatibility

To check the client's compatibility with different versions of MacOS, refer to the compatibility matrix.

Client Installation

1. After downloading the IPdivaClient.dmg client, run it.
2. The following window will appear. Drag and drop the client icon into Applications:
3. The installation is now complete, but the first time you use it, you will need to confirm the opening and authorize access to the local network for the client:

For Macs running on an ARM processor

When using the client for the first time, the following message may appear, prompting you to install Rosetta. Rosetta must be installed for the client to function.

Installation of VPN components

If you are using VPN applications, another component is required for installation: IPdivaVPN.pkg.

1. After downloading the IPdivaVPN.pkg client, run it.
2. The setup begins with an introduction that can be skipped without further action:
3. Then you must accept the terms and conditions:
4. Configure the installation for all users:
5. If necessary, specify the installation disk for the application:
6. Confirm the end of the installation:

Installation of the Ubuntu client

Superuser rights required

Superuser rights are required to install the prerequisites.

Client compatibility

To find out about the client's compatibility with different versions of Ubuntu, refer to the compatibility matrix.

1. Download the client suitable for Ubuntu gateclient_linux_x64*.tar.xz.
2. Open a terminal and navigate to the directory where the client is located.
3. Install the prerequisites and the client with the following commands:

sudo apt update
sudo apt install libwxgtk3.0-gtk3-0v5 openvpn freerdp2-x11 tigervnc-viewer sshpass
tar xf gateclient_linux_x64*.tar.xz
./gateclient/xdg_install.sh