Workstation Setup
Cloud Protector (Local Proxy) should be installed on end-user workstations where the user input devices, keyboard and mouse, are present. Currently, Windows and macOS platforms are supported.
Please note that administrative privileges are required for the installation.
Post installation you can confirm that the proxy is running by visiting http://localhost:3040
The following parameters are required for the setup. The necessary values can be found on the Setup & Installers page in the admin panel:
- Organization domain - Directs to your organization.
- Install token - Authorizes the installation process.
Windows
Download KeystrikeCloudProtector.msi, a Microsoft Installer, from the admin panel.
Run the installer
- After downloading, you can run the installer directly by selecting it in your browser or double-clicking it in File Explorer.
- Enter the required parameters during installation.
Install using msiexec
To install the client with msiexec:
- Open a command prompt with administrator privileges.
- Run the following command :
msiexec /i <path_to_.msi> ORG="<organization_domain>" TOKEN="<install_token>" /qb
The exact command, pre-filled with the required parameters, can be copied from the admin panel.
Post install
The Cloud Protector is run automatically as soon as the install completes.
See Proxy configuration for instructions on how to route relevant HTTP/S traffic through the proxy.
The organization's installed cloud protectors will appear in the admin panel.
For troubleshooting, the Windows client’s log files can be found at:
The installation will create 3 files in the %PROGRAMFILES%\Keystrike folder:
- KeystrikeCloudProtectorService.exe - runs as a Windows Service, running in the context of the local system account (SYSTEM), providing private key management and ensuring that a worker is running for every user.
- KeystrikeCloudProtectorWorker.exe - is run for each user's session, started by the Keystrike service. The worker runs as SYSTEM and detects user input activity.
- cloud-protector-config.toml - a config file. This file requires no manual modification.
Mac
Installed using KeystrikeCloudProtector.pkg, a notarized .pkg installer.
Install with Terminal
To install the cloud protector with Terminal:
- Start a Terminal session, administrator privilages required.
- At the Terminal, run the install command echo "ORG=<organization_domain>" >> $HOME/.keystrike.conf && echo "TOKEN=<install_token>" >> $HOME/.keystrike.conf && sudo installer -pkg <path_to_.pkg> -target /
- Run the command to add the certificate to the System keychain sudo security add-trusted-cert -d -p ssl -p basic -k /Library/Keychains/System.keychain "/Library/Application Support/Keystrike/Cloud Protector/ca/certificate.cer"
The commands above can be copied from the setup page with needed parameters.
You will be prompted to allow a change to System Certificate Trust settings by authenticating.
You will also need to provide Keystrike with Accessibility permissions:
- Go to System Settings -> Privacy & Security -> Accessibility
- Add the Keystrike Cloud Protector app to the list and ensure that the toggle next to it is set to the ON position.
Post install
The application is run automatically as soon as the install completes.
See Proxy configuration for instructions on how to route relevant HTTP/S traffic through the proxy.
The organization's installed cloud protectors will appear in the admin panel.
For troubleshooting, the Mac cloud protector's log files can be found in a restricted folder at: